Dùng Claude Code phân tích requirement: phát hiện điểm mơ hồ, mâu thuẫn & gợi ý test scenario
Đặt vấn đề
QA hay bỏ lọt requirement mâu thuẫn hoặc mơ hồ khi đọc đặc tả dài — đến lúc test mới phát hiện thì chi phí sửa đã cao hơn nhiều. Claude Code để cả thư mục tài liệu (file .md, .txt, .pdf, user story export...) vào một folder, rồi trò chuyện bằng tiếng Việt: nó đọc nhiều file cùng lúc và trích dẫn theo mục, theo file cụ thể để bạn kiểm chứng — không cần copy-paste từng đoạn như chatbot thường.
🚀 Thiết lập trong 4 bước
Mất khoảng 10-15 phút lần đầu, sau đó chỉ việc dùng.
- 1Cài Claude CodeCần Node.js (>=18). Mở terminal, chạy: npm install -g @anthropic-ai/claude-code. Sau đó gõ 'claude' để đăng nhập bằng tài khoản Anthropic (hoặc API key của công ty). Nếu ngại dòng lệnh, có thể dùng bản desktop app / tiện ích trong VS Code.
- 2Gom tài liệu requirement vào 1 thư mụcTạo 1 folder (vd: du-an-X-requirement). Bỏ vào: file đặc tả (.md, .txt tốt nhất), user story export, biên bản họp, mockup note. PDF/Word/Excel: nên 'Save as' hoặc copy nội dung sang .txt/.md trước — Claude Code đọc text gốc chính xác hơn nhiều so với PDF scan.
- 3Mở Claude Code ngay trong thư mục đóTrong terminal, di chuyển vào thư mục (cd du-an-X-requirement) rồi gõ 'claude'. Claude Code tự nhận diện các file trong thư mục. Bạn không cần upload — nó đọc trực tiếp file trên máy bạn (an toàn, không gửi file đi đâu ngoài API xử lý).
- 4Dùng 3 prompt phân tích (bên dưới)Gõ (hoặc dán) lần lượt 3 prompt ở phần dưới vào Claude Code → Enter. Mỗi prompt cho một loại kết quả: bản đồ chức năng → danh sách điểm mơ hồ → bộ test scenario. Có thể hỏi nối tiếp ('giải thích kỹ mục 2', 'viết test case chi tiết cho scenario 3').
🔍 3 prompt — kèm chỗ AI hay sai cần bắt
AI sinh kết quả chỉ trong vài giây — việc của bạn là kiểm lại. Mỗi prompt kèm ví dụ kết quả và 🔍 Góc soi lỗi của Tester (chỗ AI hay sai, nên xem trước khi dùng). Bấm Copy → dán vào Claude Code / ChatGPT.
Nắm nhanh toàn bộ tài liệu: có những chức năng gì, luồng nào, ai dùng — trước khi đi sâu.
Bạn là một QA Lead nhiều kinh nghiệm. Hãy đọc toàn bộ tài liệu requirement trong thư mục này và lập cho tôi một bản tóm tắt gồm: 1. Danh sách các CHỨC NĂNG chính (dạng bullet), mỗi chức năng kèm 1 câu mô tả. 2. Các ACTOR / vai trò người dùng và quyền của họ. 3. Các LUỒNG nghiệp vụ chính (happy path) theo thứ tự bước. Với mỗi mục, trích dẫn rõ file và phần nào trong tài liệu. Chỉ dựa vào nội dung tài liệu, không tự thêm chức năng không có.
Kiểm tra xem Claude Code có 'gộp' hoặc 'bỏ' chức năng phụ nào không — nó ưu tiên chức năng được mô tả rõ, dễ lướt qua các requirement nằm rải rác trong biên bản họp. Nếu thiếu, hỏi thẳng: 'còn chức năng nào liên quan đăng nhập trong các file khác không?'. Luôn đối chiếu lại số mục nó trích — đôi khi trích sai số thứ tự.
Phần giá trị nhất với QA: phát hiện chỗ requirement viết không rõ / mâu thuẫn / thiếu — TRƯỚC khi vào sprint test.
Với vai trò QA, hãy rà soát toàn bộ requirement trong thư mục và liệt kê các VẤN ĐỀ cần làm rõ với BA/PO, chia 3 nhóm: 1. MƠ HỒ: câu requirement có thể hiểu theo nhiều cách, thiếu định lượng (vd 'tải nhanh' mà không nói bao nhiêu giây). 2. MÂU THUẪN: hai chỗ nói khác nhau về cùng một điểm. 3. THIẾU SÓT: trường hợp/biên chưa được mô tả (vd: chưa nói nếu OTP hết hạn thì sao). Mỗi mục ghi rõ vị trí (file + phần) và đề xuất câu hỏi cụ thể để hỏi BA. Tuyệt đối không bịa — nếu không chắc, ghi 'cần xác nhận'.
Đây là phần AI dễ 'suy diễn thừa' nhất — nó có thể bịa ra 'thiếu sót' mà thực ra tài liệu đã ghi ở file khác. Với mỗi mục nó nêu, tự mở file gốc kiểm tra trước khi đưa vào biên bản gửi BA. Coi output như 'checklist nghi vấn để rà', KHÔNG phải kết luận cuối. Mẹo: thêm câu 'nếu tài liệu đã có thông tin này ở đâu đó, hãy chỉ ra thay vì coi là thiếu' để giảm báo nhầm.
Có ngay khung test scenario (kịch bản kiểm thử) bám theo requirement, để bạn lọc & viết test case chi tiết.
Dựa hoàn toàn vào requirement trong thư mục, hãy sinh bộ TEST SCENARIO cho chức năng Đăng nhập và Quên mật khẩu. Phân loại: - Happy path (luồng đúng) - Negative case (nhập sai, bỏ trống, sai định dạng) - Boundary / biên (đúng ngưỡng khóa, OTP vừa hết hạn...) - Bảo mật (brute force, SQL injection, lộ thông tin qua message lỗi) Mỗi scenario ghi: mã, mô tả ngắn, điều kiện tiên quyết, và requirement gốc tương ứng (trích dẫn). Đừng viết test case chi tiết vội — chỉ scenario để tôi review trước.
Claude Code sinh scenario rất nhanh nhưng hay 'rập khuôn' — nó liệt kê đủ loại nhưng có thể bỏ qua nghiệp vụ đặc thù của dự án bạn. Đừng dùng thẳng: review lại, bổ sung scenario theo hiểu biết miền nghiệp vụ. Đặc biệt cảnh giác scenario nó gắn vào requirement 'chưa rõ' (như TS-07) — đó là dấu hiệu requirement cần clarify chứ không phải test luôn.
📌 Tóm lại
Claude Code không thay được tư duy QA — quyết định test gì, độ ưu tiên, hiểu nghiệp vụ vẫn là bạn. Nhưng nó rút ngắn đáng kể bước đọc và rà soát requirement — bước phức tạp và dễ bỏ sót nhất. Quan trọng nhất với QA: dùng nó để PHÁT HIỆN requirement mơ hồ/mâu thuẫn sớm, trước khi vào sprint test. Luôn kiểm chứng lại mọi điểm AI nêu, và xác nhận chính sách bảo mật của công ty trước khi đưa tài liệu thật vào.