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

package/skills/spec/SKILL.tmpl

@@ -1,10 +1,10 @@
 ---
-description: Generates BDD .feature files from an approved PRD, or generates technical design documents. Trigger when: "/generate-bdd", "/generate-tech-docs", "tạo BDD", "tạo spec", "generate feature file", "write BDD scenarios", "tạo technical design", "tech design", "sinh tech docs", "API design", "sinh .feature".
+description: Sinh file BDD .feature từ một PRD đã duyệt, hoặc sinh tài liệu technical design. Trigger when: "/generate-bdd", "/generate-tech-docs", "tạo BDD", "tạo spec", "generate feature file", "write BDD scenarios", "tạo technical design", "tech design", "sinh tech docs", "API design", "sinh .feature".
 ---
 
 # Spec Skills — BDD & Technical Design
 
-This skill handles two commands: `/generate-bdd` to create BDD feature files, and `/generate-tech-docs` to create technical design documents.
+Skill này xử lý hai lệnh: `/generate-bdd` để tạo file BDD feature, và `/generate-tech-docs` để tạo tài liệu technical design.
 
 ---
 
@@ -12,15 +12,15 @@ This skill handles two commands: `/generate-bdd` to create BDD feature files, an
 
 ### Gate
 
-<!-- Directory: specs/*/*/prd.md -->
+<!-- Directory: specs/*/*/*.md (file PRD ở gốc feature folder) -->
 {{include:steps/gate.md}}
 
-Also verify: Check that the PRD `Status` is `approved` (not `draft`).
-- If `draft`: warn "PRD is still draft. Proceed anyway? Findings from /refine-prd may not be addressed yet."
+Cũng verify: Kiểm tra PRD `Status` là `approved` (không phải `draft`).
+- Nếu `draft`: cảnh báo "PRD vẫn đang draft. Vẫn tiếp tục? Findings từ /refine-prd có thể chưa được xử lý."
 
 ### UC Decomposition
 
-For each Use Case in the PRD, derive scenarios. Present outline:
+Với mỗi Use Case trong PRD, suy ra scenario. Trình bày outline:
 
 ```
 {DOMAIN}-UC1: {Name}
@@ -34,15 +34,15 @@ For each Use Case in the PRD, derive scenarios. Present outline:
   ...
 ```
 
-**CHECKPOINT** — Ask: "Does this outline look correct? Any missing scenarios?"
-Wait for confirmation before generating files.
+**CHECKPOINT** — Hỏi: "Outline này đúng chưa? Có scenario nào còn thiếu không?"
+Chờ xác nhận trước khi sinh file.
 
 ### Generate
 
-For each UC, write `specs/{domain}/{prd-slug}/bdd/{UC-ID}-{slug}.feature`:
+Với mỗi UC, ghi `specs/{domain}/{prd-slug}/bdd/{UC-ID}-{slug}.feature`:
 
 ```gherkin
-# @trace.source=specs/{domain}/{prd-slug}/prd.md
+# @trace.source=specs/{domain}/{prd-slug}/{TICKET-ID}-{prd-slug}.md
 # @trace.uc={UC-ID}
 Feature: {UC Name}
 
@@ -75,12 +75,12 @@ Feature: {UC Name}
 
 ### Quality Check
 
-After generating, self-evaluate:
-- [ ] Every acceptance criteria from PRD has at least one scenario
-- [ ] Every business rule is covered by at least one scenario
-- [ ] Error scenarios are present (validation, not-found, unauthorized)
-- [ ] Scenarios are atomic (one behavior per scenario)
-- [ ] No implementation details in feature files (no SQL, no class names)
+Sau khi sinh, tự đánh giá:
+- [ ] Mỗi acceptance criteria từ PRD có ít nhất một scenario
+- [ ] Mỗi business rule được phủ bởi ít nhất một scenario
+- [ ] Có error scenario (validation, not-found, unauthorized)
+- [ ] Scenario atomic (một behavior mỗi scenario)
+- [ ] Không có chi tiết implementation trong feature file (không SQL, không tên class)
 
 ### Output
 
@@ -102,12 +102,12 @@ Quality: {score}%
 
 ### Gate
 
-Check BDD quality (read .feature files, verify scenarios are well-formed).
-If quality < 80%, halt and report: "BDD quality insufficient. Fix these issues first: [list]"
+Kiểm tra chất lượng BDD (đọc file .feature, verify scenario well-formed).
+Nếu chất lượng < 80%, dừng và report: "BDD quality insufficient. Fix these issues first: [list]"
 
 ### Generate
 
-Write `specs/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design.md`:
+Ghi `specs/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design.md`:
 
 ```markdown
 # Technical Design — {UC-ID}: {Feature}
@@ -169,6 +169,6 @@ Sequence for each UC:
 {List external service calls, event producers/consumers}
 ```
 
-Instruct: "SA/Lead should review and approve before running /generate-code."
+Hướng dẫn: "SA/Lead nên review và approve trước khi chạy /generate-code."
 
 {{include:steps/report-footer.md}}