Chủ đề 7 · Prompt Engineering cho BA — Prompt cho tài liệu: BRD/SRS, mô tả quy trình & sơ đồ

Vấn đề: tài liệu ngốn thời gian, dễ thiếu nhất quán

BRD, SRS, tài liệu mô tả quy trình (as-is/to-be) là đầu ra chính của BA nhưng viết rất tốn công và dễ mâu thuẫn giữa các phần. AI giúp bạn dựng nhanh khung, giữ giọng văn nhất quán và diễn giải quy trình thành sơ đồ — miễn là bạn kiểm soát nội dung nghiệp vụ.

Prompt mẫu: dựng khung BRD

[VAI TRÒ] Bạn là BA viết tài liệu cho dự án CNTT doanh nghiệp.
[BỐI CẢNH] Dán khối Context Dự Án.
[NHIỆM VỤ] Tạo DÀN Ý BRD gồm các mục chuẩn (Mục tiêu, Phạm vi, 
Stakeholder, Yêu cầu chức năng, Phi chức năng, Ràng buộc, Giả định, 
Rủi ro). Với mỗi mục, ghi 1 câu gợi ý nội dung cần điền. 
[RÀNG BUỘC] KHÔNG viết nội dung chi tiết; chỉ dựng khung và câu 
hỏi gợi mở, vì nội dung nghiệp vụ do tôi cấp sau.

Dùng AI dựng khung trước, điền nội dung sau — an toàn hơn để nó tự "sáng tác" cả tài liệu.

Prompt mẫu: chuyển quy trình thành sơ đồ (Mermaid)

Dưới đây là mô tả quy trình phê duyệt nghỉ phép. Hãy chuyển thành 
sơ đồ flowchart bằng cú pháp Mermaid (flowchart TD). Chỉ thể hiện 
ĐÚNG các bước và nhánh tôi mô tả, không thêm bước mới.
---
Nhân viên gửi đơn → Quản lý trực tiếp duyệt. Nếu > 3 ngày, cần 
thêm Trưởng phòng duyệt. Nếu bị từ chối ở bất kỳ cấp nào, đơn 
quay lại nhân viên.

Kết quả là block ```mermaid dán thẳng vào công cụ tài liệu để render sơ đồ — rất nhanh cho as-is/to-be.

Prompt mẫu: kiểm tra mâu thuẫn nội bộ

Đọc toàn bộ tài liệu dưới đây và chỉ ra các điểm MÂU THUẪN, 
trùng lặp, hoặc yêu cầu mơ hồ (thiếu tiêu chí đo lường). 
Trình bày dạng bảng: 
Vị trí
Vấn đề
Đề xuất sửa
---
[dán tài liệu]

Prompt mẫu: dịch tài liệu kỹ thuật cho stakeholder

Một phần việc BA hay bị bỏ quên là dịch xuôi: giải thích đặc tả kỹ thuật cho stakeholder nghiệp vụ không rành công nghệ. AI làm việc này rất tốt:

Hãy diễn giải đoạn đặc tả kỹ thuật dưới đây thành ngôn ngữ 
nghiệp vụ dễ hiểu cho một trưởng phòng kinh doanh (không rành 
CNTT). Giữ nguyên ý nghĩa, tránh thuật ngữ kỹ thuật, và nêu rõ 
điều này ẢNH HƯỞNG gì tới công việc hằng ngày của họ.
---
[dán đoạn đặc tả]

Điều này giúp bạn chuẩn bị nhanh cho buổi trình bày, nhưng vẫn phải tự đọc lại để chắc AI không làm sai lệch ý nghĩa nghiệp vụ khi "dịch".

Các bước quy trình

• Chạy prompt dựng khung tài liệu.
• Tự điền nội dung nghiệp vụ vào từng mục.
• Nhờ AI chuyển các đoạn quy trình thành sơ đồ Mermaid.
• Chạy prompt "kiểm tra mâu thuẫn" trên bản nháp.
• Rà từng cảnh báo của AI — chấp nhận hay bác bỏ là quyền của bạn.
• Chốt bản, ghi phiên bản.

Template mở đầu tài liệu

Mục tiêu: ...
Phạm vi (in-scope): ...
Ngoài phạm vi: ...
Stakeholder & vai trò: ...
Giả định [GIẢ ĐỊNH]: ...
Rủi ro & giảm thiểu: ...

Checklist tài liệu do AI hỗ trợ

• [ ] Mọi số liệu/tên hệ thống là thật, không do AI bịa?
• [ ] Sơ đồ khớp đúng mô tả, không phát sinh bước lạ?
• [ ] Đã chạy rà mâu thuẫn nội bộ?
• [ ] Giọng văn và thuật ngữ nhất quán toàn tài liệu?
• [ ] Có ghi giả định và phần ngoài phạm vi?

Sai lầm thường gặp

• Để AI viết trọn BRD từ vài dòng brief: nó sẽ ảo giác yêu cầu, tính năng, thậm chí quy định pháp luật không tồn tại — cực nguy hiểm trong tài liệu ký duyệt.
• Sơ đồ tự thêm bước: AI đôi khi "làm đẹp" quy trình bằng bước không có thật. Luôn đối chiếu sơ đồ với mô tả gốc.
• Rò rỉ: dán tài liệu chứa dữ liệu mật lên AI công cộng. Với tài liệu nhạy cảm, dùng công cụ AI được công ty phê duyệt.
• Phụ thuộc quá mức vào rà soát của AI: nó bắt được mâu thuẫn hình thức nhưng không hiểu ràng buộc nghiệp vụ ngầm. Rà soát của AI bổ sung, không thay, việc review của con người.