@edupia-tutor/spec-driven-docs 0.14.0 → 0.14.1

package/commands/qc-design-test.tmpl

@@ -6,12 +6,12 @@ ported_from: ai-automation-qc-base
 
 # /qc-design-test — QC Test-Case Design
 
-> Stage 3 of the native QC automation pipeline (qc-analyze → qc-plan → qc-design-test → qc-review → qc-run-test → qc-report). Ported from the QC team's qa-designer. Produces Markdown test cases (`.Test.md`) — Python comes later in /qc-run-test.
+> Stage 3 của QC automation pipeline native (qc-analyze → qc-plan → qc-design-test → qc-review → qc-run-test → qc-report). Port từ qa-designer của team QC. Sinh test case Markdown (`.Test.md`) — Python đến sau ở /qc-run-test.
 
 ## Gate
 {{include:steps/gate.md}}
 
-*Note: For this command, the target in Step 1 is a UC-ID. Read the qc-analyze + qc-plan outputs (`REQUIREMENT_ANALYSIS.md`, `DOC_GAPS.md`, `TEST_PLAN.md`) from `{paths.qc_dir}/{UC-ID}/` and the official `.feature` (with `@trace.scenario` per scenario). For GUI layers, also read the FE tech-design §2b **Test Selectors** table at `{paths.tech_docs_dir}/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design-{platform}.md` (if present) — the stable test-ids QC will locate by.*
+*Lưu ý: Với lệnh này, target ở Bước 1 là một UC-ID. Đọc output của qc-analyze + qc-plan (`REQUIREMENT_ANALYSIS.md`, `DOC_GAPS.md`, `TEST_PLAN.md`) từ `{paths.qc_dir}/{UC-ID}/` và file `.feature` chính thức (với `@trace.scenario` mỗi scenario). Với layer GUI, cũng đọc bảng **Test Selectors** §2b của FE tech-design tại `{paths.tech_docs_dir}/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design-{platform}.md` (nếu có) — các test-id ổn định mà QC sẽ định vị theo.*
 
 ## Context
 {{include:steps/context-loader.md}}
@@ -20,16 +20,16 @@ ported_from: ai-automation-qc-base
 
 ## Role
 
-You are the **QC Designer** — stage 3. Produce/maintain test-case Markdown files
-(`.Test.md`) from the analyzed requirement + plan. Output feeds qc-run-test (Python) and
-qc-review. You do **not** write Python.
+Bạn là **QC Designer** — stage 3. Sinh/bảo trì các file test-case Markdown
+(`.Test.md`) từ requirement đã phân tích + plan. Output feed vào qc-run-test (Python) và
+qc-review. Bạn **không** viết Python.
 
-## Skills — pick the layer, load ONE file (`{paths.qc_skills_dir}/qa-designer/`)
+## Skills — chọn layer, nạp MỘT file (`{paths.qc_skills_dir}/qa-designer/`)
 
 | Layer | File |
 |---|---|
-| 1 screen | `functional/gui-screen.md` |
-| Multi-screen feature | `functional/gui-feature.md` |
+| 1 màn hình | `functional/gui-screen.md` |
+| Feature đa-màn | `functional/gui-feature.md` |
 | API endpoint | `functional/api.md` |
 | Integration | `integration/{api,db,gui,kafka}.md` |
 | End-to-end journey | `e2e/journey.md` |
@@ -38,31 +38,31 @@ qc-review. You do **not** write Python.
 
 ## Conventions
 
-- Markdown-first; don't design when the requirement is unclear — push back to qc-plan/qc-analyze.
-- TC ID `TC_<FEATURE>_<NNN>`; split happy/negative; one assertion concern per TC; concrete expected values.
+- Markdown-first; đừng design khi requirement chưa rõ — đẩy ngược về qc-plan/qc-analyze.
+- TC ID `TC_<FEATURE>_<NNN>`; tách happy/negative; mỗi TC một mối quan tâm assertion; giá trị expected cụ thể.
 - Priority `P0/P1/P2`; Tags (`smoke regression happy-path negative ui …`); Status `Draft → In Progress → Pass/Fail/Skip`.
-- A TC blocked by a gap is still written + marked `🚫 Block: GAP-xx`.
-- **Reference test-ids, not visual cues.** For each GUI step that acts on an element, cite the stable test-id from the FE tech-design §2b table (e.g. "click `ft001-login-submit-btn`") so qc-run-test builds the locator from the contract. If an actionable element has no test-id in §2b, note it (qc-run-test will fall back to a slower role/text locator).
-- End-of-file: Trace matrix + blocked-TC table.
+- Một TC bị block bởi gap vẫn được viết + đánh dấu `🚫 Block: GAP-xx`.
+- **Tham chiếu test-id, không phải gợi ý hình ảnh.** Với mỗi step GUI tác động lên một element, trích test-id ổn định từ bảng §2b của FE tech-design (vd "click `ft001-login-submit-btn`") để qc-run-test dựng locator từ contract. Nếu một element có action không có test-id trong §2b, ghi chú lại (qc-run-test sẽ fallback về locator role/text chậm hơn).
+- Cuối file: Trace matrix + bảng TC bị block.
 
-## Trace mapping (mandatory)
+## Trace mapping (bắt buộc)
 
-In addition to its `BR-xx` trace, every TC records the framework scenario it verifies:
-`@trace.verifies={UC-ID}-SC{N}` (from the `.feature` `@trace.scenario`). Add a **Trace SC**
-column to the Trace matrix. One SC may map to many TCs. This is the join key that lets
-qc-run-test write `qc_status` per scenario.
+Ngoài trace `BR-xx`, mỗi TC ghi scenario framework mà nó verify:
+`@trace.verifies={UC-ID}-SC{N}` (từ `@trace.scenario` của `.feature`). Thêm một cột **Trace SC**
+vào Trace matrix. Một SC có thể map nhiều TC. Đây là join key cho phép
+qc-run-test ghi `qc_status` theo từng scenario.
 
 ## Output
 
-Write `.Test.md` files under `{paths.qc_dir}/{UC-ID}/test-cases/`.
+Ghi các file `.Test.md` dưới `{paths.qc_dir}/{UC-ID}/test-cases/`.
 
 ## Report
 
 {{include:steps/report-footer.md}}
 
 ```
-/qc-design-test Complete — {UC-ID}
-Test cases: {N} TCs across {layers} · {blocked} blocked by gaps
-Trace: {N} TCs mapped to {K}/{total} scenarios
-Next: /qc-review {UC-ID}   ← review test cases before generating scripts
+/qc-design-test Hoàn tất — {UC-ID}
+Test cases: {N} TC qua {layers} · {blocked} bị block bởi gap
+Trace: {N} TC map tới {K}/{total} scenario
+Next: /qc-review {UC-ID}   ← review test case trước khi sinh script
 ```