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

package/commands/qc-report.tmpl

@@ -6,12 +6,12 @@ ported_from: ai-automation-qc-base
 
 # /qc-report — QC Test Report & Evidence
 
-> Stage 6 (final) 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-runner report step.
+> Stage 6 (cuối) của QC automation pipeline native (qc-analyze → qc-plan → qc-design-test → qc-review → qc-run-test → qc-report). Port từ bước report của qa-runner team QC.
 
 ## Gate
 {{include:steps/gate.md}}
 
-*Note: For this command, the target in Step 1 is a UC-ID. Generate the report from the latest `/qc-run-test` run. Uses the **qc-playwright** module (pytest-html + Playwright Trace — no Allure, no hand-written dashboard).*
+*Lưu ý: Với lệnh này, target ở Bước 1 là một UC-ID. Sinh report từ lần chạy `/qc-run-test` gần nhất. Dùng module **qc-playwright** (pytest-html + Playwright Trace — không Allure, không dashboard viết tay).*
 
 ## Context
 {{include:steps/context-loader.md}}
@@ -20,41 +20,41 @@ ported_from: ai-automation-qc-base
 
 ## Role
 
-You are the **QC Report** stage — turn the latest run into a shareable report + evidence.
+Bạn là stage **QC Report** — biến lần chạy gần nhất thành report + evidence chia sẻ được.
 
 ## Skill (`{paths.qc_skills_dir}/qa-runner/report/`)
 
-- `report.md` — self-contained: pytest-html (`--html=reports/<feature>/report.html
-  --self-contained-html`) + Playwright Trace (`test-results/<nodeid>/trace.zip`, viewed via
-  `python3 -m playwright show-trace <file>`), with screenshots/evidence attached on FAIL/SKIP.
+- `report.md` — tự đủ: pytest-html (`--html=reports/<feature>/report.html
+  --self-contained-html`) + Playwright Trace (`test-results/<nodeid>/trace.zip`, xem qua
+  `python3 -m playwright show-trace <file>`), kèm screenshot/evidence đính trên FAIL/SKIP.
 
 ## Procedure
 
-1. Locate the latest run artifacts for `{UC-ID}` (pytest-html report + traces).
-2. Generate/refresh `reports/<feature>/report.html` (self-contained) and ensure each
-   FAIL/SKIP has a trace + screenshot attached.
-3. Summarize TOTAL / PASS / FAIL / SKIP; for each FAIL include the `show-trace` command and
-   whether it was classified script-bug or product-gap.
-4. **Hand off product-gaps to the specs (prompted).** For every FAIL classified **product-gap**
-   (a real defect, impl ≠ spec — not a script-bug), print a ready-to-run
-   `/report-bug {UC-ID} {one-line expected-vs-actual}` so QC files it to the shared spec repo.
-   `/report-bug`'s BUG_FLOW then routes the root cause (Code / BDD / PRD / Design / Env). Never
-   fake-pass a product-gap — it stays FAIL in `qc_status` until fixed + re-run. **script-bugs are
-   NOT filed** (QC fixes the script and re-runs). List the commands; do not auto-create the reports.
+1. Định vị artifact của lần chạy gần nhất cho `{UC-ID}` (report pytest-html + trace).
+2. Sinh/làm mới `reports/<feature>/report.html` (self-contained) và đảm bảo mỗi
+   FAIL/SKIP có trace + screenshot đính kèm.
+3. Tóm tắt TOTAL / PASS / FAIL / SKIP; với mỗi FAIL gồm lệnh `show-trace` và
+   phân loại là script-bug hay product-gap.
+4. **Bàn giao product-gap về spec (có nhắc).** Với mỗi FAIL phân loại **product-gap**
+   (defect thật, impl ≠ spec — không phải script-bug), in một
+   `/report-bug {UC-ID} {one-line expected-vs-actual}` sẵn-chạy để QC file nó vào spec repo dùng chung.
+   BUG_FLOW của `/report-bug` rồi định tuyến root cause (Code / BDD / PRD / Design / Env). Không bao giờ
+   fake-pass một product-gap — nó giữ FAIL trong `qc_status` cho tới khi fix + chạy lại. **script-bug
+   KHÔNG được file** (QC fix script và chạy lại). Liệt kê các lệnh; đừng tự tạo report.
 
 ## Report
 
 {{include:steps/report-footer.md}}
 
 ```
-/qc-report Complete — {UC-ID}
+/qc-report Hoàn tất — {UC-ID}
 Report: reports/<feature>/report.html   (TOTAL {N} · PASS {p} · FAIL {f} · SKIP {s})
 Trace : test-results/<nodeid>/trace.zip  (python3 -m playwright show-trace <file>)
 
-Product-gaps to file ({g}):   ← run these so PO/Dev see them on /sync (script-bugs excluded)
+Product-gap cần file ({g}):   ← chạy các lệnh này để PO/Dev thấy trên /sync (script-bug bị loại)
   /report-bug {UC-ID} {gap 1 — expected vs actual}
   /report-bug {UC-ID} {gap 2 …}
-  (none → skip)
+  (không có → skip)
 
-Next: /validate-traces {UC-ID}   ← refresh Living Docs (qc_status), then create PR
+Next: /validate-traces {UC-ID}   ← làm mới Living Docs (qc_status), rồi tạo PR
 ```