Bộ 12 atomic skills + 5 workflows hỗ trợ toàn bộ vòng đời kiểm thử theo pipeline SPEC → PLAN → TASKS → REVIEW → IMPLEMENT — từ review tài liệu, khởi tạo test plan, sinh & review test case (Workflow 1: QC Manual) đến convert Gherkin, gen Playwright BDD script và chạy E2E automation (Workflow 2: BDD Automation). Output: docs-QA/ và features/ · tests-e2e/.
SPEC → PLAN → TASKS → REVIEW → IMPLEMENT, tích hợp trong Claude Code. Mỗi skill kích hoạt bằng slash command. Output: docs-QA/ (QC Manual) và features/ + tests-e2e/ (BDD Automation)./qc-spec-review = qc-doc-static-testing + qc-spec-qna-update | /qc-tc-review-update = qc-testcase-review → checkpoint → qc-testcase-update | /qc-spec-kit = orchestrate toàn bộ WF1| Slash Command | Skill | Loại | Mục đích | Output |
|---|---|---|---|---|
/qc-doc-static-testing | Static Testing | Skill con | Review tài liệu (SRS, BRS, User Story, HLD, Figma) — phát hiện lỗi, mâu thuẫn, thiếu sót trước khi viết TC | static-review_*.md |
/qc-spec-qna-update | Q&A Update | Skill con | Cập nhật Q&A tracking sau khi BA/Dev trả lời. Chạy nhiều lần cho cùng tài liệu | qa-tracking_*.md |
/qc-testplan-init | Test Plan Init | Skill độc lập | Khởi tạo Test Plan: scope, TC estimate, risk & mitigation, schedule — chạy khi Q&A ổn định | testplan_*.md |
/qc-testcase-gen | TC Generator | Skill độc lập | Sinh TC 5 nhóm: UI / Function / Validation / Integration / Other (+ Mobile). Paging tự nhận diện +12 TC | TC_*.md |
/qc-testcase-review | TC Review | Skill con | Review TC theo 8 tiêu chí (A→H) — sinh issues ISS-xxx có severity + TC còn thiếu TCM-xxx | review_*.md |
/qc-testcase-update | TC Update | Skill con | Apply fix: sửa issues, thêm TC thiếu, tự tăng version, lưu changelog. Hỗ trợ "fix all" / "fix ISS-001" / "skip" | TC_*_v2_*.md |
/qc-bdd-automation-genscripts = convert → gherkin-review (opt.) → gen-script | /qc-bdd-execute-report = execute-testscript → report (tự động)| # | Slash Command | Skill | Loại | Mục đích | Output |
|---|---|---|---|---|---|
| 1 | /qc-testcase-convert-md-to-gherkin | MD→Gherkin | Skill con | Convert TC Markdown 7 cột sang Gherkin .feature (Given/When/Then, Background, tag @TC/@fixme) | features/tc_*/ |
| ⬡ | /qc-testcase-gherkin-review | Gherkin Review | QA Gate opt. | Review .feature theo 10 tiêu chí Gherkin chuẩn — Critical/Major/Minor. Chỉ báo cáo, không tự sửa | issues report |
| 2 | /qc-e2e-bdd-gen-script | Gen Script | Skill con | Gen Playwright BDD — Phase A: skeleton. Phase B: điền locator thật qua browser MCP | tests-e2e/ |
| 3 | /qc-e2e-bdd-execute-testscript | Execute | Skill con | Chạy Playwright BDD → phân loại lỗi (CODE/DATA/SYSTEM/BUG-APP/STEP-MISSING). Không tự fix | kết quả test |
| 4 | /qc-e2e-bdd-report | Report | Skill con | Báo cáo Markdown + biểu đồ Mermaid + delta lần trước + verdict PASSED/NEEDS ATTENTION/FAILED | TestReport_LATEST.md |
| ⬡ | /ai-test-scan | Test Scan | Pre-scan opt. | Quét source code lập bản đồ kỹ thuật module/feature — giúp gen-script chuẩn xác hơn | tests-e2e/discovery/ |
| Workflow | Phase | Skills điều phối | Mục đích |
|---|---|---|---|
/qc-spec-review | SPEC | qc-doc-static-testing + qc-spec-qna-update | Review tài liệu mới + quản lý Q&A |
/qc-tc-review-update | REVIEW | qc-testcase-review → [checkpoint] → qc-testcase-update | Review TC + checkpoint + apply fix |
/qc-bdd-automation-genscripts | IMPL-1 | convert-md-to-gherkin + gherkin-review (opt.) + gen-script | Chuyển TC sang automation — chạy 1 lần |
/qc-bdd-execute-report | IMPL-2 | execute-testscript → report (tự động) | Chạy test + báo cáo — lặp đến 0 FAIL |
/qc-spec-kit | ORCH | Toàn bộ SPEC → PLAN → TASKS → REVIEW | Entry point — điều phối WF1 với resume support |
docs-QA/. Mỗi skill chạy độc lập hoặc qua workflow điều phối.Review tài liệu (SRS, BRS, User Story, HLD, LDD, Figma) để phát hiện lỗi, mâu thuẫn, thiếu sót trước khi viết TC. Hỗ trợ đọc ảnh UI multimodal, quét cross-reference. Sinh static-review + qa-tracking. AI hỏi có muốn gửi email báo cáo defect cho BA.
Đánh dấu GAP Resolved / Pending, thêm ghi chú từ BA/Dev/Designer. Chạy sau khi nhận trả lời. Có thể chạy nhiều lần (/qc-spec-review update) mà không cần review lại từ đầu. Khi Pending = 0 → sẵn sàng /qc-testplan-init.
Khởi tạo Test Plan đầy đủ: scope (in/out), TC estimate theo viewpoint, risk & mitigation, schedule. AI hỏi: tên dự án, sprint, deadline, QA Lead, BA/Dev Lead. Kế thừa kết quả SPEC phase. Output là DRAFT — nên điều chỉnh theo thực tế team.
Sinh TC theo 5 nhóm (UI / Function / Validation / Integration / Other + Mobile). Tự nhận diện paging (+12 TC chuẩn), integration points. AI không tự bịa business rule — spec mơ hồ đánh dấu [Cần BA xác nhận]. Auto push Google Sheets.
Review TC theo 8 tiêu chí (A→H): Completeness · Correctness · Clarity · Test Data · BVA/EP · Priority · Integration · Duplicate. Sinh ISS-001... có severity 🔴/🟠/🟡 + TC còn thiếu TCM-001.... Input trực tiếp cho qc-testcase-update.
Apply fix sau checkpoint: sửa issues, thêm TC thiếu, tự động tăng version, lưu changelog. Hỗ trợ: fix all / fix ISS-001,ISS-003 / skip ISS-007 / SKIP (chỉ lấy review, không update file).
npm install và npx playwright install. App đang chạy trên Staging/Local.Convert TC Markdown (7 cột chuẩn) sang Gherkin .feature — parse Given/When/Then, tách precondition chung thành Background, thêm tag @TC-xxx/@high/@fixme. Sinh warning report: DB assertion, step mơ hồ, test data không cụ thể.
QA Gate — review .feature theo 10 tiêu chí Gherkin chuẩn (Cucumber official). Phát hiện vi phạm cú pháp, cấu trúc, chất lượng step — Critical/Major/Minor. Chỉ báo cáo, không tự sửa. Chạy giữa convert và gen-script để bắt lỗi sớm.
Sinh Playwright BDD script từ .feature — Phase A: skeleton (steps/pages/config/helpers/_NOTES) với TODO selectors. Phase B: Required Field Audit + mở browser thật, điền selector thực qua playwright-MCP. Discrepancy → _NOTES/, không sửa script theo app.
Thực thi Playwright BDD — phân loại lỗi: 🔴 CODE / 🟡 DATA / ⚪ SYSTEM / 🟠 BUG-APP / 🔵 STEP-MISSING. Không tự sửa bất kỳ file nào — chỉ run + report, chờ QA quyết định. Hỗ trợ chạy feature đơn lẻ hoặc filter theo @tag.
Tổng hợp biểu đồ Mermaid (PASS/FAIL/SKIPPED), bảng BUG-APP, bảng TC manual-only (@fixme), delta so lần trước, lưu history. Verdict: PASSED ✅ / NEEDS ATTENTION ⚠️ / FAILED 🔴. Chạy tự động sau execute trong workflow.
Quét source code lập bản đồ kỹ thuật theo module/feature — routes, API, selectors, flows, data models. Đọc trực tiếp qua Filesystem MCP. Output làm blueprint cho gen-script chuẩn xác hơn. Không bắt buộc — chỉ cần khi gen-script cần context sâu.
| Command | Hành động |
|---|---|
/qc-spec-kit spec <file> | → /qc-spec-review <file> |
/qc-spec-kit plan | → /qc-testplan-init |
/qc-spec-kit tasks <file> | → /qc-testcase-gen <file> |
/qc-spec-kit review [file] | → /qc-tc-review-update [file] |
/qc-spec-kit run <file> | Chạy tuần tự SPEC → PLAN → TASKS → REVIEW. Hỏi user tại mỗi checkpoint BLOCKED. Kết thúc với gợi ý Workflow 2 |
/qc-spec-kit status | Dashboard: DONE / PENDING / bước tiếp theo. Dùng khi pipeline bị gián đoạn |
SPEC/qc-spec-review |
PLAN → TASKS → REVIEWmỗi sprint |
|||||||||
| ↓ | ↓ | ↓ | ↓ | ↓ | ||||||
Tài liệuSRS/BRS |
→ | /qc-spec-reviewStatic+Q&A |
→ | qna-updateQ&A resolved |
→ | /qc-testplan-initTest Plan |
→ | /qc-testcase-genTC Generator |
→ | /qc-tc-review-updateReview+Fix v2 |
| defect+GAP | resolved | testplan_*.md | TC_*.md | v2+changelog | ||||||
/qc-spec-review <file>— [SPEC]Điều phối: qc-doc-static-testing (defect Critical/Major/Minor, status PASSED✅/NEEDS REVIEW⚠️/BLOCKED🔴) → qc-spec-qna-update (Q&A tracking). Dùng /qc-spec-review update khi BA reply — không cần review lại từ đầu.
/qc-testplan-init— [PLAN]Chạy khi Q&A ổn định (Pending = 0). AI hỏi: tên dự án, sprint, deadline, QA Lead, BA/Dev Lead. Kế thừa TC estimate từ SPEC. Output DRAFT — điều chỉnh lịch và estimate theo thực tế.
/qc-testcase-gen <file>— [TASKS]Sinh TC 5 nhóm. Spec mơ hồ → đánh [Cần BA xác nhận]. Paging → +12 TC tự động. Cảnh báo Automation Warning nếu TC có DB assertion. Hỏi output mode (1 file / tách file/section).
/qc-tc-review-update <tc-file>— [REVIEW]Điều phối: qc-testcase-review → issues ISS-xxx + TCM-xxx → checkpoint (user chọn: "fix all" / "fix ISS-001" / "SKIP") → qc-testcase-update (v2 + changelog). Luôn có checkpoint — AI không tự apply fix.
/qc-testcase-convert-md-to-gherkin— convert TC sang GherkinParse bảng 7 cột → Given/When/Then, tách Background, gắn tag. Sinh warning report: DB assertion, test data không cụ thể. Có 2 checkpoint trong workflow: sau convert (xác nhận warning) và cuối (tổng kết).
/qc-testcase-gherkin-review— [tuỳ chọn] QA GateChạy tự động trong workflow sau convert. Muốn kiểm soát thủ công: (1) /qc-testcase-convert-md-to-gherkin → (2) /qc-testcase-gherkin-review features/tc_*/ → (3) /qc-e2e-bdd-gen-script.
/qc-e2e-bdd-gen-script— gen Playwright BDDPhase A: skeleton (steps/pages/config/helpers/_NOTES). Phase B: Required Field Audit + điền selector thực qua browser MCP. Nếu app khác spec → ghi discrepancy vào _NOTES/, không sửa script theo app.
/qc-e2e-bdd-execute-testscript— chạy test + phân loại lỗiPhân loại từng FAIL: 🔴 CODE (script sai) / 🟡 DATA (test data sai) / ⚪ SYSTEM (môi trường) / 🟠 BUG-APP (app sai spec) / 🔵 STEP-MISSING (chưa impl). Không tự sửa — báo cáo xong chờ QA quyết định.
/qc-e2e-bdd-report— báo cáo (tự động)Tổng hợp: biểu đồ Mermaid, bảng BUG-APP, bảng TC manual (@fixme), delta so lần trước. Lưu TestReport_LATEST.md + history/TestReport_[date].md.
/qc-bdd-execute-report → 7 FAIL (3 BUG-APP, 4 CODE) — xem report| Loại | Nghĩa | Cần làm |
|---|---|---|
| 🔴 CODE | Lỗi trong test script — locator sai, step thiếu logic | QA fix script |
| 🟡 DATA | Test data không phù hợp với app hiện tại | Update config/ |
| ⚪ SYSTEM | Môi trường staging lỗi, timeout, network | DevOps check |
| 🟠 BUG-APP | App sai so với TC spec — bug thật, đã phát hiện từ gen-script | Tạo ticket, chờ Dev fix |
| 🔵 STEP-MISSING | Step trong .feature chưa có implementation | Viết thêm step definition |
Tài liệu đầu vào: SRS, BRD, User Story.
Static review + Q&A tracking từ qc-spec-review.
Test Plan mỗi sprint — qc-testplan-init.
TC theo version, Reviews, history changelog.
LATEST + history mỗi lần chạy.
Gherkin .feature — convert-md-to-gherkin.
Playwright BDD scripts — gen-script Phase A+B.
Discrepancy TC vs app — phát hiện khi Phase B.
/qc-spec-kit run <file> tự động chạy toàn Workflow 1, hỏi tại checkpoint BLOCKED. Nếu gián đoạn: /qc-spec-kit status để resume.
docs-QA/Inputs/@high priority trước để tiết kiệm thời gian/qc-spec-kit run docs-QA/Inputs/SRS_DangNhap.md/qc-spec-review docs-QA/Inputs/SRS_QuanLyNguoiDung.md/qc-spec-review update. Khi Q&A ổn định: /qc-testplan-init./qc-testcase-gen docs-QA/Inputs/SRS.md/qc-tc-review-update docs-QA/Test-Cases/TC_Login.md → checkpoint "fix all" → v2 + changelog./qc-bdd-automation-genscripts docs-QA/Test-Cases/TC_Login.md/qc-bdd-execute-report @high/qc-bdd-execute-report status./qc-bdd-execute-report features/tc_dangnhap/docs-QA/Test-Reports/history/./qc-spec-review trước khi gen TC để phát hiện lỗi sớm/qc-testcase-gherkin-review giữa convert và gen-script/qc-bdd-execute-report đến 0 FAIL — delta tự sinh@high priority trước để tiết kiệm thời gian/qc-bdd-automation-genscripts nhiều lần cho cùng TC file| Lệnh | Phase | Dùng khi | Chạy mấy lần |
|---|---|---|---|
/qc-spec-review <file> | SPEC | Nhận tài liệu mới | 1 lần / tài liệu |
/qc-spec-review update | SPEC | BA vừa reply câu hỏi | Nhiều lần |
/qc-testplan-init | PLAN | Q&A ổn định, cần kế hoạch | 1 lần / sprint |
/qc-testcase-gen <file> | TASKS | Sinh TC từ tài liệu | 1 lần / feature |
/qc-tc-review-update <file> | REVIEW | Review + fix TC | 1–2 lần / TC file |
/qc-spec-kit run <file> | ORCH | Chạy toàn bộ Workflow 1 | 1 lần |
/qc-bdd-automation-genscripts <file> | IMPL-1 | TC approved, cần automation | 1 lần duy nhất |
/qc-testcase-gherkin-review <path> | QA Gate | Review .feature trước gen-script | Tuỳ chọn |
/qc-bdd-execute-report | IMPL-2 | Chạy test + báo cáo | Lặp đến 0 FAIL |
/ai-test-scan <source> | Pre-scan | Blueprint trước gen-script | Tuỳ chọn |