spec-lite 1.1.9 → 1.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Spec-driven development kit for Claude Code",
   "type": "module",
   "bin": {

package/skills/review/SKILL.md

@@ -31,5 +31,139 @@ git diff $(git merge-base HEAD $BASE)...HEAD
 
 ## Sau khi review
 
-- **Có Critical/Important:** Dừng, không tiếp tục `/build`. Sửa và re-review.
-- **Chỉ Suggestion hoặc không có finding:** Approve, tiếp tục `/build` task tiếp theo.
+### Chỉ Nit/Optional/FYI hoặc không có finding
+
+Approve và thông báo tiếp tục `/build` task tiếp theo.
+
+### Có Critical hoặc Important
+
+**Bước 1 — Tổng hợp findings thành tasks:**
+
+Nhóm các findings thành tasks cụ thể có thể implement được. Mỗi finding Critical/Important là ít nhất một task. Đặt tên task bắt đầu bằng động từ, mô tả rõ việc phải sửa.
+
+**Bước 2 — Đề xuất thêm phase mới vào plan.md và todo.md:**
+
+Hiển thị preview phase sẽ được thêm:
+
+```
+Phát hiện {N} Critical / {M} Important findings. Đề xuất thêm phase mới:
+
+Phase Review: Fix review findings
+
+  T0XX · Fix {mô tả finding 1}
+  T0XY · Fix {mô tả finding 2}
+  ...
+
+Thêm phase này vào plan.md và todo.md, rồi chạy /build để fix?
+```
+
+Hỏi user bằng `AskUserQuestion`:
+
+```
+question: "Thêm phase Review vào plan.md/todo.md và chạy /build ngay?"
+options:
+  - label: "Thêm phase và chạy /build"
+    description: "Thêm các tasks fix findings vào plan.md và todo.md, rồi gọi /build để thực thi"
+  - label: "Thêm phase nhưng không chạy /build"
+    description: "Chỉ cập nhật plan.md và todo.md, tự chạy /build sau"
+  - label: "Lưu vào techdebt.md"
+    description: "Ghi findings vào specs/integrations/{slug}/techdebt.md để theo dõi sau, không fix ngay"
+```
+
+**Bước 3 — Nếu user chọn "Thêm phase" (cả hai option đầu):**
+
+Xác định số phase tiếp theo từ plan.md (đếm số `### Phase` hiện có, cộng 1).
+
+Xác định task ID tiếp theo từ plan.md (lấy task ID lớn nhất hiện có, cộng 1).
+
+Append vào `plan.md` (trước section `## Definition of Done`):
+
+```markdown
+### Phase {N}: Review Findings
+
+#### T{XXX} · {task title — bắt đầu bằng động từ}
+
+**Mục tiêu:** {mô tả finding cần fix}
+
+**depends:** {task ID cuối cùng trước phase này}
+
+**Các bước:**
+1. {bước fix cụ thể từ finding}
+
+**Verification:**
+- [ ] {điều kiện verify finding đã được fix}
+
+---
+```
+
+Append vào `todo.md`:
+
+```markdown
+### Phase {N}: Review Findings
+- [ ] T{XXX} — {mô tả task fix}
+```
+
+**Bước 4 — Nếu user chọn "Thêm phase và chạy /build":**
+
+Sau khi cập nhật xong plan.md và todo.md, invoke ngay `/build` để thực thi phase Review vừa thêm.
+
+**Bước 4 — Nếu user chọn "Lưu vào techdebt.md":**
+
+Lấy short SHA hiện tại: `git rev-parse --short HEAD`.
+
+Ghi findings vào `specs/integrations/{slug}/techdebt.md`.
+
+Nếu file chưa tồn tại, tạo mới từ `.claude/templates/integrations/techdebt-template.md`, điền `slug`, `title`, `created`.
+
+Append section mới vào cuối file (không ghi đè section cũ):
+
+```markdown
+
+## {YYYY-MM-DD} — {short-sha}
+
+- [ ] **Critical** — {mô tả finding 1}
+- [ ] **Important** — {mô tả finding 2}
+```
+
+Sau khi ghi xong, thông báo:
+
+```
+Đã lưu {N} findings vào specs/integrations/{slug}/techdebt.md.
+Integration được đánh dấu có tech debt chưa xử lý.
+```
+
+---
+
+## Đánh dấu techdebt đã resolved
+
+Khi `/build` hoàn thành **thành công** một Phase Review, nó phải tìm và mark các techdebt findings tương ứng là resolved.
+
+**Cơ chế liên kết:** Khi append Phase Review vào `plan.md` (Bước 3 ở trên), thêm field `resolves-techdebt` vào task đầu tiên của phase, trỏ đến section date trong techdebt.md:
+
+```markdown
+#### T{XXX} · Fix {mô tả finding 1}
+
+**Mục tiêu:** {mô tả finding cần fix}
+
+**depends:** {task ID cuối cùng trước phase này}
+
+**resolves-techdebt:** {YYYY-MM-DD} — {short-sha}
+
+**Các bước:**
+...
+```
+
+**Khi `/build` hoàn thành Phase Review:**
+
+1. Đọc field `resolves-techdebt` từ task đầu tiên của Phase Review trong `plan.md`
+2. Tìm section tương ứng trong `techdebt.md` (match theo `## {YYYY-MM-DD} — {short-sha}`)
+3. Với mỗi dòng `- [ ]` trong section đó → đổi thành `- [x]` và append ` *(resolved by T{XXX})*`:
+
+```markdown
+## 2026-05-08 — abc1234
+
+- [x] **Critical** — {mô tả finding 1} *(resolved by T005)*
+- [x] **Important** — {mô tả finding 2} *(resolved by T005)*
+```
+
+4. Nếu không tìm được field `resolves-techdebt` hoặc không tìm được section trong techdebt.md → bỏ qua, không báo lỗi.

package/templates/integrations/techdebt-template.md

@@ -0,0 +1,13 @@
+---
+slug: "{slug}"
+created: {YYYY-MM-DD}
+referenced_by:
+  - skills/review/SKILL.md > Bước 4 — Lưu vào techdebt.md
+---
+
+# Tech Debt — {title}
+
+## {YYYY-MM-DD} — {short-sha}
+
+- [ ] **Critical** — {mô tả finding}
+- [ ] **Important** — {mô tả finding}