QA Toàn Diện — /qa-full

Bộ công cụ /qa-full cung cấp 12 use cases bao phủ toàn bộ quy trình kiểm thử, từ verify từng issue đến kiểm tra bảo mật trước release.

Tất cả lệnh chỉ chạy trên Claude Code CLI. Chạy claude trong thư mục project.

Cập nhật bộ mới: Thêm /qa-full:tdd:verify — verify tests thật sự PASS sau /cook, chống “cheat” (skill implement gọi test luôn PASS). Xem TDD flow.

Cây quyết định: Dùng lệnh nào?

Bạn muốn làm gì?
│
├─ Verify GitHub issue trên staging?
│   ├─ 1 issue → /qa-full:verify-issue #66
│   ├─ Nhiều issues → /qa-full:verify-issue #66,#67,#68
│   └─ Tất cả issues của 1 feature → /qa-full:verify-issue --feature F05
│
├─ Đánh giá tình trạng dự án?
│   └─ /qa-full:audit (chỉ scan + report, KHÔNG fix)
│
├─ Bổ sung tests thiếu?
│   ├─ Toàn bộ project → /qa-full:check
│   ├─ 1 module → /qa-full:check src/modules/auth
│   └─ Theo PRD → /qa-full:check --docs docs/prd/
│
├─ Nghiệm thu theo PRD?
│   └─ /qa-full:accept docs/prd/F05.md
│
├─ Viết tests TRƯỚC code (TDD)?
│   └─ /qa-full:tdd "feature description"
│
├─ Kiểm tra hồi quy sau sửa code?
│   └─ /qa-full:regression src/file-đã-sửa.ts
│
├─ QA toàn diện trước release?
│   └─ /qa-full:full
│
├─ E2E test trên browser?
│   └─ /qa-full e2e https://staging.site.com
│
├─ Quét bảo mật?
│   └─ /qa-full security
│
└─ Kiểm tra accessibility?
    └─ /qa-full a11y https://staging.site.com

Bảng tham chiếu nhanh

Lệnh	Mô tả	Thời gian	Trang
`/qa-full:verify-issue #N`	Verify GitHub issues trên staging	5-10 phút	Chi tiết
`/qa-full:audit`	Đánh giá sức khỏe dự án	3-5 phút	Chi tiết
`/qa-full:check`	Review + bổ sung tests thiếu	10-20 phút	Chi tiết
`/qa-full:accept docs/prd/F*.md`	Nghiệm thu theo PRD	10-15 phút	Chi tiết
`/qa-full:tdd "feature"`	Viết failing tests trước	5-10 phút	Chi tiết
`/qa-full:tdd:verify`	Verify tests PASS sau `/cook`, check không cheat	3-5 phút	Chi tiết
`/qa-full:regression src/file.ts`	Kiểm tra hồi quy	5-10 phút	Chi tiết
`/qa-full:full`	QA toàn diện trước release	15-30 phút	Chi tiết
`/qa-full e2e URL`	E2E testing trên browser	10-15 phút	-
`/qa-full security`	Quét bảo mật STRIDE + OWASP	5-10 phút	-
`/qa-full a11y URL`	Kiểm tra accessibility WCAG 2.1 AA	5-10 phút	-

12 Use Cases

1. Verify Issue

Verify GitHub issues theo AC + TC-IDs trên staging. Dùng NHIỀU NHẤT hàng ngày. 7 bước: đọc issue, tìm TC, gap analysis (ck-scenario 12 chiều), verify, comment, label, push.

2. Audit

Đánh giá health score: coverage, tech debt, security. Chỉ scan + report, không generate tests hay fix code. 3-5 phút.

3. Check

Review tests hiện có + bổ sung tests thiếu. 7 bước: đọc docs, scan, map 3 chiều, review, generate, verify.

4. Accept

Nghiệm thu code vs PRD + Test Cases + UI Design. 5 bước kiểm tra 3 chiều.

5. TDD

Viết failing tests TRƯỚC, code SAU. Brainstorm ck-scenario + ck-predict → tests FAIL → /cook → verify.

6. Regression

Kiểm tra hồi quy sau sửa code. 4 bước: impact zone → tests → generate thiếu → report.

7. Full

QA toàn diện 6 bước: strategy, plan, gen, execute, fix, report. Unit + E2E + security + a11y.

8. E2E

End-to-end test trên browser với Playwright. Visual regression, responsive, form automation.

9. Security

Quét bảo mật STRIDE + OWASP Top 10, dependency audit, secret scan.

10. A11y

Kiểm tra accessibility WCAG 2.1 AA: screen reader, keyboard nav, contrast.

11. Feature

QA 1 tính năng cụ thể trước merge PR.

12. File

QA 1 file/module vừa code xong.

QA Pro Max

/qa-pro-max — Engineering-level testing: test plan generation, comprehensive coverage, quality reporting.

Docs Project

/docs-project — Documentation pipeline: PRD → QA Test Plan → UI Specs. QC dùng /docs-project:qa.

Quy trình QA theo sprint

Đầu sprint — Đánh giá tình trạng

/qa-full:audit

Xem health score dự án: test coverage, code quality, security, tech debt.

Hàng ngày — Verify issues

/qa-full:verify-issue #66
/qa-full:verify-issue #66,#67,#68
/qa-full:verify-issue --feature F05

Verify từng issue dev assign cho QA. Comment + label tự động.

Giữa sprint — TDD cho feature quan trọng

/qa-full:tdd "payment processing"
# Dev implement...
/qa-full:tdd:verify

Cuối sprint — Bổ sung tests + Nghiệm thu

/qa-full:check
/qa-full:accept docs/prd/F05.md
/qa-full:full --skip-gen

Trước release — Full QA + Security + E2E

/qa-full:full
/qa-full e2e https://staging.site.com
/qa-full security

Flags hay dùng

Flag	Ý nghĩa	Dùng với
`--skip-gen`	Không tạo tests mới	`full`
`--skip-e2e`	Bỏ qua E2E testing	`full`
`--skip-security`	Bỏ qua quét bảo mật	`full`
`--coverage 90`	Đặt mục tiêu coverage 90%	`check`, `full`
`--docs docs/prd/`	Chỉ định thư mục PRD	`check`
`--feature F05`	Verify tất cả issues của feature	`verify-issue`
`--testcase path`	Chỉ định file test cases	`accept`
`--ui URL`	Check UI trên staging	`accept`
`--design image.png`	So sánh UI vs design	`accept`
`--brainstorm`	Thêm ck-predict debate	`tdd`

Skills mới trong QA (bộ claudekit)

/qa-full:tdd:verify — Verify tests PASS sau /cook

Prefix: /qa-full:tdd:verifySau khi /qa-full:tdd viết failing tests và /cook implement, dùng :tdd:verify để confirm tests thực sự PASS — chống việc skill implement gọi test luôn PASS mà không sửa logic.

/qa-full:tdd "payment processing"     # Bước 1: viết failing tests
/cook                                 # Bước 2: dev implement
/qa-full:tdd:verify                   # Bước 3: verify tests PASS thật

/qa-pro-max — Comprehensive QA engineering

Prefix: /qa-pro-maxComprehensive QA skill cho SaaS teams: test planning, test design, automation, execution, reporting, CI/CD integration.

/qa-pro-max                           # Test strategy end-to-end
/qa-pro-max "regression plan"
/qa-pro-max "API test"

Khi dùng: Cần test plan chi tiết cho feature phức tạp, hoặc kiểm tra ngoài scope của /qa-full.

/qa-only — Report-only (không auto-fix)

Prefix: /qa-onlyChỉ generate bug report, KHÔNG fix. Dùng khi anh muốn review bugs trước khi quyết định fix.

/qa-only                              # Test + report only

/qa-plan — Test plan cho sprint

Prefix: /qa-planGenerate test plan cho sprint hoặc feature. Classify stories theo test type (Logic/Integration/Visual/UI). Output: automated tests required, manual test cases, smoke test scope, playtest sign-off.

/qa-plan                              # Trước sprint
/qa-plan "feature checkout"

/test-flakiness — Detect flaky tests

Prefix: /test-flakinessAggregate pass rates per test từ CI logs, identify intermittent failures, recommend quarantine.

/test-flakiness                       # Sau vài CI runs

/regression-suite — Map coverage to critical paths

Prefix: /regression-suiteMap test coverage to GDD critical paths, flag coverage drift, maintain tests/regression-suite.md.

/regression-suite                     # Sau implement bug fix hoặc trước release

/smoke-check + /soak-test — Gate checks

/smoke-check                          # Critical path smoke test gate
/soak-test                            # Extended play session protocol

/bug-triage + /bug-report — Bug lifecycle

/bug-triage                           # Re-evaluate priority, assign sprint
/bug-report                           # Structured bug report với repro steps

Lưu ý & Best Practices

Sai lầm phổ biến:

Chạy test mà chưa hiểu cần test gì → coverage thấp, test vô nghĩa
Skip security scan trước deploy → vulnerabilities lên production
Không dùng /qa-full:verify-issue → verify thủ công, bỏ sót edge cases
Test happy path only → miss error scenarios, boundary cases

Tips từ team:

Test strategy TRƯỚC, viết test SAU — hiểu requirements rồi mới test
/qa-full security bắt buộc trước MỌI release
Mỗi issue dev fix xong → QC verify bằng /qa-full:verify-issue #N
Dùng ck-scenario để generate 12 dimensions edge cases cho feature quan trọng
Coverage matrix: requirement ↔ source file ↔ test — đảm bảo không sót

→ Xem thêm: Best Practices tổng hợp

Lưu ý quan trọng

Chỉ chạy trên CLI — không chạy trên web app hay desktop app
Cần internet — để gọi GitHub API và staging
Cần Docker — nếu chạy tests cần database (PostgreSQL + Redis)
Skill gọi skill — /qa-full:verify-issue tự gọi ck-scenario bên trong
TUẦN TỰ các bước — mỗi sub-command có steps bắt buộc, KHÔNG skip
MỖI bước có output — phải output kết quả trước khi sang bước tiếp

​QA Toàn Diện — /qa-full

​Cây quyết định: Dùng lệnh nào?

​Bảng tham chiếu nhanh

​12 Use Cases

1. Verify Issue

2. Audit

3. Check

4. Accept

5. TDD

6. Regression

7. Full

8. E2E

9. Security

10. A11y

11. Feature

12. File

QA Pro Max

Docs Project

​Quy trình QA theo sprint

​Flags hay dùng

​Skills mới trong QA (bộ claudekit)

​Lưu ý & Best Practices

​Lưu ý quan trọng

QA Toàn Diện — /qa-full

Cây quyết định: Dùng lệnh nào?

Bảng tham chiếu nhanh

12 Use Cases

Quy trình QA theo sprint

Flags hay dùng

Skills mới trong QA (bộ claudekit)

Lưu ý & Best Practices

Lưu ý quan trọng