메뉴
Tạo test plan toàn diện từ spec/user stories: strategy, test cases happy/edge/negative, exit criteria. Trigger khi: user nói "tạo test plan", "viết test cases", "soạn kế hoạch test", "create test plan", "QA plan cho feature", "test strategy", hoặc gõ /qa-testplan.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | qa-testplan |
| description | Tạo test plan toàn diện từ spec/user stories: strategy, test cases happy/edge/negative, exit criteria. Trigger khi: user nói "tạo test plan", "viết test cases", "soạn kế hoạch test", "create test plan", "QA plan cho feature", "test strategy", hoặc gõ /qa-testplan. |
Role: QA Engineer
Mục đích: Tạo test plan toàn diện từ spec/user stories, bao gồm test cases và strategy.
Đọc docs/tasks/[TASK-ID]/requirements.md và màn hình/API docs liên quan.
## Tôi sẽ tạo test plan cho: [Feature name]
Tôi đọc spec và xác định:
- [N] Acceptance Criteria cần verify
- [M] Business Rules cần test
- Màn hình liên quan: [list]
- API liên quan: [list]
Trước khi soạn test plan, tôi cần hỏi:
| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Test level cần cover? | A: Unit / B: Integration / C: E2E / D: Performance / E: Security / F: Tất cả / G: Khác: ___ |
| 2 | Môi trường test? | A: Dev / B: Staging / C: Prod-like / D: Khác: ___ |
| 3 | Có dữ liệu test đặc biệt cần chuẩn bị không? | A: Không / B: Có — loại data: ___ / C: Khác: ___ |
| 4 | Regression scope — những gì cần retest? | _(liệt kê features/flows cần retest)_ |
Tạo docs/tasks/[TASK-ID]/test-plan.md sử dụng template templates/test-plan.md.
Sinh docs/tasks/[TASK-ID]/test-plan.html từ template templates/html-artifact.html:
<ul class="checklist" data-storage-key="testplan-[TASK-ID]"> cho từng TC<li> có <input type="checkbox" data-id="TC-XXX"> + label = TC name<details><summary> mở rộng<input type="search" data-filter="..."> để filter TC theo từ khoápill-ok|warn|err cho priority High/Med/LowQA tick checkbox khi chạy test, state lưu localStorage — không cần copy vào Markdown.
File HTML KHÔNG commit (đã có .gitignore). test-plan.md vẫn là source of truth commit vào repo.
✓ Đã sinh `docs/tasks/[TASK-ID]/test-plan.html`
Mở bằng browser khi chạy test để tick checklist (state lưu localStorage).
Test plan đã soạn xong với [N] test cases.
| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Test case nào có vẻ thiếu? | A: Không thiếu / B: Thiếu — mô tả: ___ / C: Khác: ___ |
| 2 | Có edge case domain đặc thù tôi chưa cover? | A: Không / B: Có — edge case: ___ / C: Khác: ___ |
| 3 | Exit criteria có đủ chặt không? | A: Đủ rồi / B: Cần thêm điều kiện: ___ / C: Khác: ___ |
| 4 | Muốn tôi generate code test tự động từ test plan không? | A: Có / B: Không — sẽ viết tay / C: Khác: ___ |
Nếu user chọn "Có" ở câu 4, spawn test-gen để generate test code từ test plan đã approve:
Agent(
description: "Generate test code from approved test plan",
prompt: "Write test code per agents/test-gen.md spec.\n\nNEW CODE:\n[Files đã implement — chỉ pass files mới/changed]\n\nAC LIST:\n[AC list từ test plan]\n\nTEST FRAMEWORK:\n[Jest/JUnit/pytest/...]\n\nEXISTING TEST EXAMPLES:\n[1-2 file test hiện có]",
model: "sonnet"
)
Tạo Architecture Decision Record (ADR) để document quyết định kiến trúc quan trọng. Trigger khi: user nói "tạo ADR", "document quyết định kiến trúc", "viết ADR", "record design decision", hoặc gõ /arch-adr.
Review design decision, phát hiện vấn đề kiến trúc, đề xuất cải thiện. Trigger khi: user nói "review design", "kiểm tra kiến trúc", "architecture review", "review technical decision", "xem design có ổn không", hoặc gõ /arch-review.
Reverse engineer codebase brownfield (legacy/take-over từ vendor cũ) thành tài liệu baseline: business overview, tech stack, package inventory, key APIs, technical debt. Trigger khi: user nói "reverse engineer codebase", "onboard codebase legacy", "phân tích codebase cũ", "take-over từ vendor", "tạo codemap", "brownfield analysis", hoặc gõ /ba-reverse.
Chuyển đổi yêu cầu thô thành tài liệu đặc tả nghiệp vụ có cấu trúc. Trigger khi: user nói "viết spec", "soạn đặc tả", "phân tích yêu cầu", "write spec", "tạo requirements doc", "business spec", hoặc gõ /ba-spec.
Chuyển spec thành User Stories với Acceptance Criteria chuẩn, sẵn sàng để PM tạo issue. Trigger khi: user nói "tạo user stories", "viết user story", "breakdown spec thành stories", "create user stories", "AC cho stories", hoặc gõ /ba-user-story.
Hỗ trợ Bridge Engineer dịch yêu cầu khách hàng Nhật, tạo tài liệu song ngữ JP-VN, chuẩn bị deliverables theo chuẩn Nhật (設計書, 単体テスト仕様書, 成果物). Trigger khi: user nói "dịch yêu cầu JP", "tạo 設計書", "soạn tài liệu cho khách Nhật", "bridge engineer", "JP requirement", "translate JP spec", hoặc gõ /be-bridge.