​
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

1

Cài đặt Claude Code CLI

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

Đăng nhập

claude login
3

Kiểm tra phiên bản

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

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:
  1. Đọc issue → parse tất cả Acceptance Criteria (GIVEN/WHEN/THEN)
  2. Tìm TC-IDs trong docs/qa/F*.md
  3. Gap analysis → bổ sung TC thiếu (dùng skill ck:scenario 12 chiều)
  4. Verify từng TC trên staging (unit test → API → source → E2E)
  5. Comment kết quả per-AC per-TC lên issue
  6. Gán label qa:passed hoặc qa:failed
  7. 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-genKhông tạo tests mới
--skip-e2eBỏ qua E2E testing
--skip-securityBỏ 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 F05Verify 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ừngGõ lệnh lại — nó sẽ tiếp tục
Coverage không tăngThêm --coverage 60 (giảm target) rồi nâng dần
Quá chậmDùng --skip-e2e --skip-security cho nhanh
Không tìm thấy docsKiể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