@edupia-tutor/spec-driven-docs 0.14.7 → 0.14.8

package/skills/code/SKILL.tmpl

@@ -4,173 +4,16 @@ description: Sinh implementation code từ BDD spec đã duyệt kèm tag tracea
 
 # Code Skills — Generate & Review
 
-Skill này xử lý `/generate-code` (implementation) và `/review-code` (review read-only).
+Skill này xử lý `/generate-code` và `/review-code`. Để **không lệch schema/gate**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
 
----
-
-## /generate-code — Generate Implementation Code
-
-### Gate
-
-<!-- Directory: specs/*/*/bdd/*.feature -->
-{{include:steps/gate.md}}
-
-4. Kiểm tra trace state có sẵn: đọc `.trace/{domain}/{prd-slug}/{UC-ID}.tsv` nếu tồn tại.
-   - Xác định: scenario mới vs. drifted (đã đổi) vs. synced (skip)
-
-5. Hiện **CHECKPOINT — Comprehension**:
-   ```
-   I understand:
-   - Feature: {name} | Ticket: {TICKET_ID if known}
-   - UC: {UC-ID} in domain: {domain}
-   - Scenarios: {N} total ({X} new, {Y} drifted, {Z} synced-skip)
-   - Layer order: {from CLAUDE.md architecture}
-   - Files to create/update: [list in generation order]
-
-   Proceed? (Y/N)
-   ```
-   Chờ xác nhận.
-
-### Context Load
-
-{{include:steps/context-loader.md}}
-
-Cũng đọc:
-- File `.feature` (cần implement gì)
-- Tech doc `specs/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design.md` (nếu tồn tại)
-- File entity/model có sẵn trong domain này (để theo pattern)
-
-### Branch
-
-Tạo feature branch:
-```bash
-git checkout -b feature/{TICKET_ID}-{slug}
-# If no ticket ID: feature/{UC-ID}-{slug}
-```
-
-### Generate
-
-Sinh code theo thứ tự layer (thích ứng theo stack của bạn):
-
-**Cho một backend phân lớp điển hình (vd Controller → Service → Repository):**
-
-1. **DTOs / Request-Response models** — validate input, shape output
-2. **Domain entity / model** — biểu diễn dữ liệu
-3. **Repository / Data Access** — query, filter
-4. **Service interface** — contract
-5. **Service implementation** — business logic, `@Transactional` khi cần
-6. **Facade interface** (nếu kiến trúc dùng facade layer) — contract orchestration
-7. **Facade implementation** — orchestration liên-service
-8. **Controller / Handler** — HTTP mapping, auth, tag `@trace`
-
-**Quan trọng: Tag traceability trên mỗi controller method:**
-```
-# @trace.implements={UC-ID}-SC{N}
-# @trace.source=specs/{domain}/{prd-slug}/bdd/{UC-ID}.feature
-```
-(Dùng cú pháp comment của ngôn ngữ bạn)
-
-### Self-Review (3 vòng)
-
-Sau khi sinh, verify:
-- [ ] Mỗi scenario trong .feature có controller endpoint tương ứng
-- [ ] Tag `@trace.implements` trên mỗi endpoint
-- [ ] Tôn trọng quy tắc layer kiến trúc (từ CLAUDE.md)
-- [ ] Error handling khớp CLAUDE.md §error_handling
-- [ ] Không magic number, không debug logging
-- [ ] Theo coding standards từ CLAUDE.md
-
-Nếu phát hiện issue → fix inline trước khi tiếp tục.
-
-### Build Verify
-
-```bash
-{BUILD_COMMAND}   # from project-context.yaml, max 3 retries
-```
-
-Nếu build fail: đọc lỗi, fix, retry. Sau 3 lần fail, report cho user kèm diagnosis.
-
-### Write Trace State
-
-Cập nhật `.trace/{domain}/{prd-slug}/{UC-ID}.tsv`:
-```
-UC-ID\tSC-ID\tsc_version\timplemented_by\tlast_updated
-{UC-ID}\tSC1\t{hash of scenario text}\t{ControllerClass}.{method}\t{date}
-```
-
-### Commit
-
-```bash
-git add {changed files}
-git commit -m "{commit_format from CLAUDE.md}: {description}"
-```
-
-### Report
-
-```
-/generate-code Complete — {UC-ID}
-- Files created: {N}  |  Updated: {M}
-- Build: SUCCESS (attempt {K}/3)
-- Branch: feature/{TICKET_ID}-{slug}
-- Trace: .trace/{domain}/{prd-slug}/{UC-ID}.tsv updated
-```
-
-{{include:steps/report-footer.md}}
-
----
-
-## /review-code — Code Review chỉ-đọc
-
-**QUAN TRỌNG**: Đây là READ-ONLY. Report issue nhưng KHÔNG sửa.
-
-### Input
-
-Nhận: UC-ID, file path, hoặc tên branch hiện tại.
-
-### Review Dimensions
-
-#### 1. Traceability
-- [ ] Mỗi controller endpoint có tag `@trace.implements`?
-- [ ] Mỗi test file có tag `@trace.verifies`?
-- [ ] Không có tag `@trace` ở layer không phải controller (Service, Repository, v.v.)?
-- [ ] `.trace/{domain}/{prd-slug}/{UC-ID}.tsv` cập nhật chưa?
-
-#### 2. Layer Architecture (từ CLAUDE.md)
-- [ ] Mỗi class ở đúng layer?
-- [ ] Phụ thuộc giữa layer đi đúng chiều?
-- [ ] Không layer nào bị bypass (vd Controller gọi Repository trực tiếp)?
-
-#### 3. Coding Standards (từ CLAUDE.md)
-- [ ] Tuân theo naming convention?
-- [ ] Response wrapper dùng nhất quán?
-- [ ] Exception được throw (không bị nuốt hoặc tự build vào response)?
-- [ ] Không magic number?
-- [ ] Không dữ liệu nhạy cảm trong log?
-- [ ] Annotation transaction đúng?
-
-#### 4. Spec Compliance
-- [ ] Mỗi scenario trong .feature có implementation?
-- [ ] Không có endpoint không tài liệu (code không có spec backing)?
-
-### Output
-
-```
-/review-code Report — {UC-ID}
-Critical: {X}  |  Major: {Y}  |  Minor: {Z}
-
-### Critical
-| # | File | Line | Issue | Suggested Fix |
-|---|------|------|-------|---------------|
+## /generate-code — Sinh Implementation Code
 
-### Major
-| # | File | Line | Issue | Suggested Fix |
+→ **Đọc và tuân theo `commands/generate-code.md`** với cùng `$ARGUMENTS`.
 
-### Minor
-| # | File | Line | Issue | Suggested Fix |
+Command lo: guard mềm BDD `@trace.status` approved + Design Spec (approved/độ-tươi/sanity) cho FE/App · `--phase=ui`/`--phase=integration` · branch + build verify · trace TSV (22 cột) `@trace.implements`.
 
-Verdict: APPROVED ✅ | NEEDS_FIX ❌
-```
+## /review-code — Code Review chỉ-đọc (READ-ONLY)
 
-Nếu `NEEDS_FIX`: liệt kê file cụ thể cần đổi và chạy `/fix-bug` hoặc sửa inline.
+→ **Đọc và tuân theo `commands/review-code.md`** với cùng `$ARGUMENTS`.
 
-{{include:steps/report-footer.md}}
+Command lo: Pre-Review Scan · 4 lăng kính (Traceability · Layer Architecture · Coding Standards · Spec Compliance) · đề xuất ghi Lesson cho lỗi AI lặp.