Hướng dẫn Onboarding QA

Tài liệu hướng dẫn dành cho thành viên QA mới bắt đầu sử dụng /qa-full trong công việc hàng ngày.

Yêu cầu trước khi bắt đầu

Cài đặt Claude Code CLI

npm install -g @anthropic-ai/claude-code

Đăng nhập

claude login

Kiểm tra phiên bản

claude --version
# Cần v2.1+ trở lên

Xác nhận skill đã có

cd ~/Claude\ Code/projects/ten-project
claude
# Gõ /qa rồi xem danh sách hiện ra

Phải thấy:

/qa-full:audit
/qa-full:check
/qa-full:verify-issue
/qa-full:tdd
… (12 use cases)

Nếu không thấy → liên hệ Lead Dev để copy .claude/ vào project.

Quy trình QA hàng ngày

Buổi sáng: Nhận issues mới

/qa-full:verify-issue #66

Buổi chiều: Verify batch

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

Cuối sprint: Full QA

/qa-full:full

8 lệnh QA thường dùng

1. Verify 1 GitHub Issue (dùng NHIỀU NHẤT)

/qa-full:verify-issue #66

Khi nào: Dev assign issue cho QA, cần verify trên staging. Quy trình tự động 7 bước:

Đọc issue → parse tất cả Acceptance Criteria (GIVEN/WHEN/THEN)
Tìm TC-IDs trong docs/qa/F*.md
Gap analysis → bổ sung TC thiếu (dùng skill ck-scenario 12 chiều)
Verify từng TC trên staging (unit test → API → source → E2E)
Comment kết quả per-AC per-TC lên issue
Gán label qa:passed hoặc qa:failed
Push TC bổ sung vào repo

Verify nhiều issues cùng lúc:

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

2. Đánh giá sức khỏe dự án

/qa-full:audit

Khi nào: Nhận dự án mới, hoặc đầu sprint muốn xem tình trạng. Thời gian: 3-5 phút. Chỉ scan, không sửa gì.

3. Review tests + bổ sung thiếu

/qa-full:check
/qa-full:check --docs docs/prd/ --coverage 90

Khi nào: Coverage dưới target, cần nâng lên. Thời gian: 10-20 phút.

4. Nghiệm thu theo PRD

/qa-full:accept docs/prd/F05-editor.md
/qa-full:accept docs/prd/F05.md --testcase docs/testcases/F05.md --ui https://staging.site.com/editor

Khi nào: Feature code xong, cần verify đúng requirements trước sign-off.

5. Kiểm tra hồi quy

/qa-full:regression src/modules/auth/auth.service.ts

Khi nào: Dev sửa code cũ, cần đảm bảo không phá features khác.

6. QA toàn diện (trước release)

/qa-full:full
/qa-full:full --coverage 90 --skip-e2e

Khi nào: Trước deploy staging/production. Thời gian: 15-30 phút.

7. E2E / Security / Accessibility

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

8. TDD (cho feature quan trọng)

/qa-full:tdd "user authentication with Google OAuth"
# ... sau khi dev /cook xong:
/qa-full:tdd:verify

Khi nào: Feature auth, payment, core logic — cần test kỹ.

Flags hay dùng

Flag	Ý nghĩa
`--skip-gen`	Không tạo tests mới
`--skip-e2e`	Bỏ qua E2E testing
`--skip-security`	Bỏ qua quét bảo mật
`--coverage 90`	Đặt mục tiêu coverage 90%
`--docs docs/prd/`	Chỉ định thư mục PRD
`--feature F05`	Verify tất cả issues của feature F05

Quy trình QA theo sprint

Đầu sprint:
  /qa-full:audit                    # Xem tình trạng dự án

Trong sprint (mỗi ngày):
  /qa-full:verify-issue #N          # Verify issues được assign

Cuối sprint:
  /qa-full:check                    # Bổ sung tests thiếu
  /qa-full:full --skip-gen          # Chạy full QA
  /qa-full:accept docs/prd/F*.md    # Nghiệm thu theo PRD

Trước release:
  /qa-full:full                     # Full QA
  /qa-full e2e https://staging...   # E2E
  /qa-full security                 # Bảo mật

Troubleshooting

Vấn đề	Giải pháp
”Unknown skill”	Restart: thoát Claude (`Ctrl+C`) rồi `claude` lại
”OAuth expired”	Chạy `claude login`
Bị dừng giữa chừng	Gõ lệnh lại — nó sẽ tiếp tục
Coverage không tăng	Thêm `--coverage 60` (giảm target) rồi nâng dần
Quá chậm	Dùng `--skip-e2e --skip-security` cho nhanh
Không tìm thấy docs	Kiểm tra `docs/prd/` và `docs/qa/` có đúng path

Liên hệ hỗ trợ

Vấn đề skill: Liên hệ Lead Dev
Vấn đề Claude Code: claude doctor hoặc npm i -g @anthropic-ai/claude-code@latest

​Hướng dẫn Onboarding QA

​Yêu cầu trước khi bắt đầu

​Quy trình QA hàng ngày

​Buổi sáng: Nhận issues mới

​Buổi chiều: Verify batch

​Cuối sprint: Full QA

​8 lệnh QA thường dùng

​1. Verify 1 GitHub Issue (dùng NHIỀU NHẤT)

​2. Đánh giá sức khỏe dự án

​3. Review tests + bổ sung thiếu

​4. Nghiệm thu theo PRD

​5. Kiểm tra hồi quy

​6. QA toàn diện (trước release)

​7. E2E / Security / Accessibility

​8. TDD (cho feature quan trọng)

​Flags hay dùng

​Quy trình QA theo sprint

​Troubleshooting

​Liên hệ hỗ trợ