AI-First · Quality Control

AI QC Skills
Team Guideline

Bộ skill AI-First tích hợp trong Claude Code, hỗ trợ toàn bộ vòng đời kiểm thử phần mềm — từ giai đoạn Analysis & Test Design (phân tích tài liệu, sinh test case, review & update TC) đến giai đoạn Execute (scan codebase, gen automation script, implement logic và chạy E2E test) — giúp QC Engineer tăng tốc và chuẩn hóa quy trình theo từng sprint.

AI QC Kit · V1.0.0 · May 2026
📚 Analysis & Test Design ⚡ Execute 🔄 Full Life Cycle Quality Assurance
Tổng quan pipeline — Analysis & Test Design → Execute
📚 Analysis & Test Design
/qc-doc-static-testing
Static Test
→
/qc-spec-qna-update
Gap Update
→
/qc-testcase-gen
TC Gen
→
/qc-testcase-review
TC Review
→
/qc-testcase-update
TC Update
→
⚡ Execute
/qc-e2e-scan-source-code
Scan Source
→
/qc-e2e-coverage-testmd-to-yaml
MD→YAML
→
/qc-e2e-gen-base-script
gen-script
→
/qc-e2e-implement-script-logic
Implement Logic
→
/qc-e2e-execute-script
Execute
Giới thiệu

AI QC Skills là gì?

💡
AI QC Skills là bộ skill AI-First tích hợp trong Claude Code, hỗ trợ Full Life Cycle Quality Assurance — từ study tài liệu, sinh & review test case, đến gen script, implement logic và execute E2E automation. Mỗi skill kích hoạt bằng slash command, output lưu tại docs-QA/ (Analysis & Test Design) và tests/ (Execute).
Skill Map

Analysis & Test Design · 5 Skills

Slash CommandSkillMục đíchOutput
/qc-doc-static-testingStatic TestingReview tài liệu (SRS, BRS, User Story, HLD, LDD, Figma), phát hiện lỗi trước khi viết TCstatic-review_*.md
/qc-spec-qna-updateGap UpdateCập nhật trạng thái câu hỏi mở trong gap tracking sau khi BA/Dev trả lờigap-tracking_*.md
/qc-testcase-genTC GeneratorSinh test case theo Test Viewpoint matrix — Web/Mobile/APITC_*.md / .xlsx
/qc-testcase-reviewTC ReviewReview TC theo 8 tiêu chí, output Review Sheet (.xlsx) mark Pass/Fail/N/AReview Sheet (.xlsx)
/qc-testcase-updateTC UpdateÁp dụng fix từ Review Sheet, tăng version, lưu changelogTC_*_v2_*.md
Skill Map

Execute · 5 Skills

#Slash CommandSkillMục đíchOutput
1/qc-e2e-scan-source-codeTest ScannerPhân tích codebase, lập bản đồ module/feature (routes, API, selectors)tests/discovery/*.md
2/qc-e2e-coverage-testmd-to-yamlMD → YAMLChuyển TC Markdown sang YAML automation-ready cho Phase 1tests/scenarios/**/*.yml
3/qc-e2e-gen-base-scriptgen-scriptTạo skeleton 4 files/flow: data, page, fixture, spec*.spec.ts (khung)
4/qc-e2e-implement-script-logicImplement LogicĐiền Playwright logic vào từng test() block*.spec.ts (đầy đủ)
5/qc-e2e-execute-scriptExecuteChạy, debug tuần tự, sinh FIX-LOG.md và HTML reportFIX-LOG.md / report
Skill Map

Workflows · 3 Pipelines

#WorkflowGiai đoạnMục đích
2Analysis & Test Design Workflow📚 Analysis & Test DesignStudy tài liệu & review tài liệu → Sinh TC → Review TC → Update TC
3Execute Workflow — 6 Cases⚡ ExecuteScan codebase, convert YAML, gen script, implement logic, execute & debug — chọn case theo đầu vào
1Full Life Cycle Quality Assurance🔄 Full Life Cycle Quality AssuranceToàn bộ từ static-testing → gen TC → review → update → MD→YAML → gen-script → implement → execute
Analysis & Test Design

Bộ 5 Skills — Analysis & Test Design

✅
Hỗ trợ Web, Mobile App, API. Tự động push kết quả lên Google Sheets sau mỗi bước.
Tải Analysis & Test Design:Analysis & Test Design (.zip)
🔍
/qc-doc-static-testingStatic Testing · v1.4

Review tài liệu (SRS, BRS, User Story, HLD, LDD, Technical Spec, 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.

Input
SRS / BRSUser StoryHLD / LDDFigma
Output
static-review_*.mdgap-tracking_*.md
Tải
📋
/qc-spec-qna-updateGap Update · v1.0

Đánh dấu GAP Resolved / Pending, thêm ghi chú giải pháp. Chạy sau khi BA/Dev/Designer trả lời câu hỏi từ static testing.

Input
gap-tracking_*.mdTrả lời BA/Dev
Output
gap-tracking_*.md (updated)
Tải
⚡
/qc-testcase-genTC Generator · v1.2

Sinh TC theo Test Viewpoint matrix — Web/Mobile/API. Tự nhận diện paging và integration points. Hỗ trợ mobile-specific: Face Auth, Camera, GPS, Push Notification.

Input
SRS / BRSUser StoryUI Spec
Output
TC_*.mdTC_*.xlsxGoogle Sheet
Tải
🔎
/qc-testcase-reviewTC Review · v1.2

Review TC theo 8 tiêu chí từ góc nhìn Test Leader/QC Lead. Output là Review Sheet (.xlsx) cho phép mark Pass/Fail/N/A — làm input trực tiếp cho qc-testcase-update.

Input
TC_*.md / .xlsx
Output
review_*.mdReview Sheet (.xlsx)
Tải
✏️
/qc-testcase-updateTC Update · v1.3

Áp dụng fix từ Review Sheet — sửa issues, thêm TC thiếu, tự động tăng version, lưu changelog. Hỗ trợ: fix all / fix ISS-001 / skip ISS-007.

Input
TC_*.mdReview Sheet (.xlsx)
Output
TC_*_v2_*.mdchangelog_*.md
Tải
Execute

Bộ 5 Skills — Execute

✅
5 skills tương ứng 5 bước pipeline: Scan → MD→YAML → gen-script → Implement → Execute. Dùng kết hợp theo Case phù hợp (xem tab Workflow).
Tải toàn bộ bộ Execute:Execute (.zip)
🔭
/qc-e2e-scan-source-codeSkill 1 · Test Scanner

Phân tích codebase theo từng module/feature — đọc trực tiếp source code qua Filesystem MCP, lập bản đồ kỹ thuật chi tiết (routes, API endpoints, selectors, flows, data models). Output làm input cho Skill 3.

Input
app/ folderModule name (opt)
Output
tests/discovery/index.mdtests/discovery/{module}.md
Tải
🔄
/qc-e2e-coverage-testmd-to-yamlSkill 2 · MD → YAML

Chuyển TC Markdown sang YAML automation-ready — tách actions/assertions, normalize targets (snake_case, locator-independent), extract test data, giữ nguyên tiếng Việt trong display-text. Hỗ trợ đa framework.

Input
TC_*.mdManual TC (table/list)
Output
tests/scenarios/**/*.ymlphase1_compatible: true
Tải
🧩
/qc-e2e-gen-base-scriptSkill 3 · gen-script

Đọc discovery + YAML → tạo skeleton 4 files/flow: *.data.ts / *.page.ts / *.fixture.ts / *.spec.ts. 100% TC ID map 1:1. Nếu không có discovery → kích hoạt Live Discovery Mode qua playwright-mcp.

Input
tests/discovery/tests/scenarios/*.ymlTC_*.md (fallback)
Output
*.spec.ts (khung)*.page.ts*.data.ts*.fixture.ts
Tải
⚙️
/qc-e2e-implement-script-logicSkill 4 · Implement Logic

Lấy skeleton từ Phase 1 → điền đầy đủ Playwright logic vào từng test() block (actions, assertions, waits). Dùng playwright-mcp để confirm locator thực tế. Chạy TypeScript check trước khi bàn giao.

Input
*.spec.ts (từ Phase 1)TC YAML / MD
Output
*.spec.ts (đầy đủ)npx tsc --noEmit ✅
Tải
▶️
/qc-e2e-execute-scriptSkill 5 · Execute

Pre-flight check → chạy từng *.spec.ts → phân loại lỗi (🔴 DATA / 🟢 CODE / 🟡 SYSTEM / ⚪ FLAKY) → debug tuần tự 1 TC/lần → re-run đơn lẻ → pass → TC tiếp theo. Sinh FIX-LOG.md + HTML report cuối.

Input
tests/e2e/*.spec.tsTARGET (opt)
Output
N passed, M fixmeFIX-LOG.mdHTML report
Tải
Workflow

3 Workflows

ℹ️
1. Full Life Cycle Quality Assurance — Analysis & Test Design → Execute toàn bộ
2. Analysis & Test Design — pipeline study tài liệu và sinh test case
3. Execute — 6 cases E2E theo tình huống
🔗
1. Full Life Cycle Quality Assurance — Analysis & Test Design → Execute
Toàn bộ từ đầu đến cuối: Analysis & Test Design → Bridge → Execute
Full Life Cycle Assurance
Pipeline tổng thể
📚 Analysis & Test Design
⚡ Execute
/qc-doc-static-testing
Static Test
→
/qc-spec-qna-update
Gap Update
→
/qc-testcase-gen
TC Generator
→
/qc-testcase-review
TC Review
→
/qc-testcase-update
TC Update
→
/qc-e2e-scan-source-code
Scan Source
→
/qc-e2e-coverage-testmd-to-yaml
MD → YAML
→
/qc-e2e-gen-base-script
gen-script
→
/qc-e2e-implement-script-logic
Implement Logic
→
/qc-e2e-execute-script
Execute
Chi tiết từng bước
1

/qc-doc-static-testing— review tài liệu đầu vào

Phát hiện lỗi, mâu thuẫn, thiếu sót trong tài liệu trước khi viết TC.

2

/qc-spec-qna-update— sau khi BA/Dev trả lời

Cập nhật GAP Open → Resolved/Pending.

3

/qc-testcase-gen— sinh TC Markdown

Sinh TC theo Test Viewpoint matrix. Auto push lên Google Sheet.

4

/qc-testcase-review— review TC

Review 8 tiêu chí → Review Sheet (.xlsx) mark Pass/Fail/N/A.

5

/qc-testcase-update— fix theo review

Sửa issues, thêm TC thiếu, tăng version, lưu changelog.

6

/qc-e2e-coverage-testmd-to-yaml— Bridge: MD → YAML

Chuyển TC_*.md sang YAML automation-ready trong tests/scenarios/.

7

/qc-e2e-gen-base-script— gen-script

Đọc YAML + discovery → tạo 4 files/flow: data, page, fixture, spec (khung).

8

/qc-e2e-implement-script-logic— Implement Logic

Implement Playwright code vào từng test() block. Chạy TypeScript check.

9

/qc-e2e-execute-script— Execute

Chạy → debug tuần tự → FIX-LOG.md + HTML report.

✍
2. Analysis & Test Design Workflow
Study (1 lần · /qc-kickoff) + Gen TC (mỗi sprint · /qc-full-workflow)
Pipeline
Study1 lần · /qc-kickoff
Gen TCmỗi sprint · /qc-full-workflow
↓↓ ↓↓↓
Tài liệuSRS/BRS
 →
/qc-doc-static-testingStatic Testing
 →
/qc-spec-qna-updateGap Update
 →
/qc-testcase-genTC Generator
 →
/qc-testcase-reviewTC Review
 →
/qc-testcase-updateTC Update
Defect+GAPGAP resolved TC_*.mdReview Sheetv2+changelog
Study (/qc-kickoff) — static-testing + qna-update Gen TC (/qc-full-workflow) — tc-gen → review → update
Chi tiết từng bước
1

/qc-doc-static-testing— review tài liệu đầu vào

Phát hiện lỗi, mâu thuẫn, thiếu sót trong SRS/BRS/User Story/Figma trước khi viết TC.

2

/qc-spec-qna-update— sau khi BA/Dev trả lời

Cập nhật GAP Open → Resolved/Pending sau khi nhận phản hồi.

3

/qc-testcase-gen— sinh test case

Sinh TC theo Test Viewpoint matrix. Tự nhận diện paging, integration points. Auto push lên Google Sheet.

4

/qc-testcase-review— review bởi QC Lead

Review 8 tiêu chí. Output: Review Sheet (.xlsx) — reviewer mark Pass/Fail/N/A trực tiếp.

5

/qc-testcase-update— áp dụng fix

Sửa issues từ Review Sheet, thêm TC thiếu, tự động tăng version và lưu changelog.

🤖
3. Execute Workflow — 6 Cases
Chọn case phù hợp với tình trạng đầu vào hiện có — 5 skills: Scan → MD→YAML → gen-script → Implement Logic → Execute
Execute
Pipeline đầy đủ — Case 1 (Full)
Source Codeapp/ folder
đầu vào
→
Skill 1Scan Source
discovery/*.md
→
Skill 2MD → YAML
scenarios/*.yml
→
Skill 3gen-script
4 files/flow (khung)
→
Skill 4Implement Logic
*.spec.ts (full)
→
Skill 5Execute
Report + FIX-LOG
Chọn nhanh theo tình huống
CaseĐầu vào hiện cóS1 ScanS2 YAMLS3 GenS4 LogicS5 Run
Case 1Source code + TC Markdown✅✅✅✅✅
Case 2TC Markdown, không có source code⛔✅
✅Live
✅✅
Case 3YAML sẵn + source code✅⛔✅✅✅
Case 4YAML sẵn, không có source code⛔⛔
✅Live
✅✅
Case 5Script khung từ Phase 1 + YAML⛔⛔⛔✅✅
Case 6Script đầy đủ, CI fail sau deploy⛔⛔⛔⛔✅

✅ Live = Skill 3 chạy Live Discovery Mode qua playwright-mcp (hỏi BASE_URL + credentials, không cần source code)

Chi tiết từng case
📦 Full Pipeline — Có source code + TC Markdown. Chạy tuần tự từ Skill 1 → 2 → 3 → 4 → 5.
1

/qc-e2e-scan-source-code

Scan codebase → tests/discovery/*.md

2

/qc-e2e-coverage-testmd-to-yaml

Convert TC_*.md → tests/scenarios/**/*.yml (song song với Skill 1)

3

/qc-e2e-gen-base-script

Đọc discovery + YAML → tạo skeleton 4 files/flow

4

/qc-e2e-implement-script-logic

Điền Playwright logic vào từng test() block

5

/qc-e2e-execute-script

Execute → debug tuần tự → FIX-LOG.md + HTML report

📄 Không có source code — Có TC Markdown, app đang chạy trên staging/dev. Skill 3 kích hoạt Live Discovery Mode.
⛔

/qc-e2e-scan-source-code — Bỏ qua

Không có source code để scan.

2

/qc-e2e-coverage-testmd-to-yaml

Convert TC_*.md → tests/scenarios/**/*.yml

3

/qc-e2e-gen-base-script — Live Discovery Mode

Không có discovery files → hỏi BASE_URL + credentials → playwright-mcp duyệt live app → lấy selectors, routes, API → gen 4 files/flow

4

/qc-e2e-implement-script-logic

Dùng playwright-mcp confirm locator thực tế trên live app

5

/qc-e2e-execute-script

Execute → debug → report

✅ YAML sẵn + source code — Đã convert YAML rồi. Bỏ qua Skill 2.
1

/qc-e2e-scan-source-code

Scan codebase → tests/discovery/*.md

⛔

/qc-e2e-coverage-testmd-to-yaml — Bỏ qua

YAML đã có sẵn trong tests/scenarios/.

3

/qc-e2e-gen-base-script

Đọc discovery + YAML → tạo skeleton

4

/qc-e2e-implement-script-logic

Implement logic

5

/qc-e2e-execute-script

Execute → debug → report

🔲 YAML sẵn, không có source code — Case phổ biến nhất với app bên thứ ba. Bỏ qua Skill 1 và 2.
⛔

/qc-e2e-scan-source-code — Bỏ qua

Không có source code.

⛔

/qc-e2e-coverage-testmd-to-yaml — Bỏ qua

YAML đã có sẵn.

3

/qc-e2e-gen-base-script — Live Discovery Mode

Hỏi BASE_URL + credentials → playwright-mcp duyệt live app → build discovery context → gen 4 files/flow

4

/qc-e2e-implement-script-logic

Implement logic

5

/qc-e2e-execute-script

Execute → debug → report

🔧 Chỉ cần implement logic — Đã có script khung từ Phase 1 + YAML. Bắt đầu từ Skill 4.
⛔

Skill 1, 2, 3 — Bỏ qua

Script khung đã có sẵn. YAML đã có sẵn.

4

/qc-e2e-implement-script-logic

Đọc spec khung + YAML → điền logic từng TC. Chạy npx tsc --noEmit sau khi implement.

5

/qc-e2e-execute-script

Execute → debug → report

🚀 Chỉ cần execute & debug — Script đã đầy đủ, CI fail sau deploy mới. Chỉ Skill 5.
⛔

Skill 1, 2, 3, 4 — Bỏ qua

Script đã ổn định từ sprint trước.

5

/qc-e2e-execute-script

Pre-flight → chạy từng spec → phân loại lỗi (🔴 DATA / 🟢 CODE / 🟡 SYSTEM / ⚪ FLAKY) → debug tuần tự 1 TC/lần → 100% pass → FIX-LOG.md + HTML report

Tham khảo

Cấu trúc thư mục output

Output của tất cả skills lưu tại docs-QA/ (manual) và tests/ (auto).

📁Cấu trúc thư mụcManual → docs-QA/ · Auto → tests/
docs-QA/ # Manual output ├── Inputs/ │ └── SRS_*.md / *.xlsx ├── QC-static-testing/ │ ├── static-review_*.md │ └── gap-tracking_*.md ├── Test-Cases/ │ ├── TC_[feature].md │ ├── TC_[feature]_v2.md │ └── Review Sheet (.xlsx) └── Bug-Reports/ tests/ # Auto output ├── discovery/ # Skill 1 output │ ├── index.md │ └── {module}.md ├── scenarios/ # Skill 2 output │ └── {source}/ │ ├── functional/ │ ├── ui/ │ └── validation/ ├── e2e/ # Skill 3+4 output │ ├── *.spec.ts │ ├── *.page.ts │ ├── *.data.ts │ └── *.fixture.ts └── FIX-LOG.md # Skill 5 output
📥
docs-QA/Inputs/

Tài liệu đầu vào: SRS, BRD, User Story.

🔍
docs-QA/QC-static-testing/

Kết quả review và GAP cần xác nhận.

🧪
docs-QA/Test-Cases/

TC theo version, Review Sheet, changelog.

🗺️
tests/discovery/

Bản đồ kỹ thuật module — output của Skill 1.

📄
tests/scenarios/

YAML automation-ready — output của Skill 2.

⚙️
tests/e2e/

Playwright scripts (spec/page/data/fixture) — Skill 3+4.

📊
tests/FIX-LOG.md

Debug log + HTML report — output của Skill 5.

Mẹo sử dụng

Tips & Best Practices

🚀

Dùng Full Workflow

/qc-full-workflow [file] tự động chạy toàn bộ pipeline và hỏi lựa chọn tại checkpoint quan trọng.

📎

Cung cấp context

  • Đính kèm SRS dạng .md hoặc .xlsx
  • Nêu rõ platform (Web / Mobile / API)
  • Điền Google Sheet ID vào testplan_*.md
⚡

Chọn đúng Auto Case

  • Có source code → Case 1 hoặc 3
  • Không có source code → Case 2 hoặc 4 (Live Mode)
  • Chỉ cần debug → Case 6
⚡

TC Generator

  • Mode 1 (1 file) cho feature nhỏ, Mode 2 (tách file) cho automation
  • +12 TC cố định khi có phân trang
  • Output TC_*.md dùng được cho Bridge Workflow
🎯

E2E Bridge Workflow

  • Dùng /qc-e2e-coverage-testmd-to-yaml ngay sau khi gen TC
  • Giữ nguyên tiếng Việt trong YAML display-text fields
  • Approve browser inspection khi được hỏi ở Phase 3
📊

TC Review hiệu quả

  • Cung cấp spec gốc khi review để so sánh coverage
  • Dùng "fix all" cho sprint đầu
  • Review Sheet (.xlsx) tự động làm input cho Update
Prompt mẫu

Sample Prompts

1

Analysis & Test Design — Bắt đầu dự án

/qc-kickoff docs-QA/Inputs/SRS_QuanLyNguoiDung.md
Chạy /qc-doc-static-testing + /qc-spec-qna-update → /qc-testcase-gen → /qc-testcase-review → /qc-testcase-update.
2

Analysis & Test Design — Sinh TC cho 1 chức năng

/qc-testcase-gen docs-QA/Inputs/SRS.md
Chọn mode output (1 file / tách file). Auto push lên Google Sheet sau khi gen.
3

Execute — Chuyển TC sang YAML (Case 1)

/qc-e2e-coverage-testmd-to-yaml docs-QA/Test-Cases/TC_Login.md
Convert TC_*.md → tests/scenarios/*.yml → input cho /qc-e2e-gen-base-script.
4

Execute — Scan codebase (Case 1)

/qc-e2e-scan-source-code auth
Scan module auth → tests/discovery/*.md → input cho /qc-e2e-gen-base-script.
5

Execute — Chỉ execute & debug (Case 6)

/qc-e2e-execute-script tests/e2e/login.spec.ts
Pre-flight → chạy → phân loại lỗi (🔴DATA/🟢CODE/🟡SYSTEM/⚪FLAKY) → debug tuần tự → FIX-LOG.md.
Lưu ý

Nên và không nên

✓ Nên làm
  • Luôn chạy /qc-kickoff trước khi bắt đầu dự án mới
  • Chọn đúng Auto Case trước khi chạy skill
  • Chạy Skill 1 và Skill 2 song song để tiết kiệm thời gian
  • Giữ nguyên tiếng Việt trong YAML display-text fields
✗ Không nên
  • Bỏ qua static testing, gen TC từ tài liệu lỗi
  • Bỏ qua /qc-e2e-coverage-testmd-to-yaml khi có TC Markdown
  • Sửa nhiều TC cùng lúc trong Phase 3 — debug tuần tự từng TC
  • Paste nội dung dài không format → AI đọc sai

© 2026 QC Team · AI QC Skills V1.0.0 · Built with Claude Code

qc-skill-guideline · May 2026