dw-kit 1.2.1 → 1.3.4

package/.claude/skills/dw-execute/SKILL.md

@@ -1,98 +1,121 @@
----
-name: dw-execute
-description: "Thực hiện implementation theo plan đã được approve. Tuân thủ TDD, commit sau mỗi subtask. Chỉ dùng khi plan đã được duyệt."
-argument-hint: "[task-name]"
----
-
-# Thực Hiện Implementation
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → lấy:
-- `paths.tasks` → location task docs
-- `quality.test_command` → lệnh chạy tests (nếu có)
-- `quality.lint_command` → lệnh chạy linter (nếu có)
-- `quality.block_on_fail` → có block commit khi fail không
-- `tracking.log_work` → ghi effort tracking không
-- `workflow.default_depth` → `thorough` = cần docs-update, review bắt buộc
-
-## Trước Khi Bắt Đầu
-
-1. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
-2. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
-3. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`
-4. Xác nhận plan có `Trạng thái: Approved`
-
-Nếu plan chưa approved → **DỪNG**, yêu cầu approve trước.
-Nếu chưa có plan → **DỪNG**, yêu cầu chạy `/dw-plan $ARGUMENTS`.
-Nếu có progress → tiếp tục từ subtask cuối cùng chưa done.
-
-## Quy Trình Cho MỖI Subtask
-
-### Step 1: Chuẩn bị
-- Đọc subtask từ plan (mô tả, files, criteria)
-- Cập nhật progress: subtask → `in_progress`
-
-### Step 2: Test First (TDD)
-- Viết test cho subtask (nếu applicable)
-- Chạy test → confirm FAIL (red)
-- Nếu test đã pass → kiểm tra lại, có thể test sai
-
-### Step 3: Implement
-- Code theo spec trong plan
-- Tuân thủ conventions trong `.claude/rules/code-style.md`
-- KHÔNG thay đổi scope ngoài plan
-
-### Step 4: Verify
-- Chạy test → confirm PASS (green)
-- Nếu `quality.lint_command` không rỗng: chạy linter
-- Nếu `quality.block_on_fail = true` và fail → DỪNG, fix trước
-- Nếu `quality.block_on_fail = false` → cảnh báo, cho phép tiếp tục
-
-### Step 5: Cập nhật Progress
-Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
-```markdown
-| ST-N | [Subtask name] | Done | abc1234 | [ghi chú] |
-```
-
-Nếu `tracking.log_work = true`, ghi effort thực tế vào:
-```markdown
-### Effort Log
-| Subtask | Estimate | Actual | Ghi chú |
-```
-
-### Step 6: Commit
-```
-<type>(<scope>): <mô tả subtask>
-
-Subtask ST-N of $ARGUMENTS
-```
-
-## Khi Phát Hiện Vấn Đề
-
-### Giả định sai / Scope thay đổi
-1. **DỪNG** implementation ngay
-2. Ghi vào progress → mục "Phát Hiện Mới"
-3. Thông báo user: vấn đề gì, ảnh hưởng gì
-4. Đề xuất: tiếp tục / cập nhật plan / thay đổi hướng
-5. **CHỜ** quyết định từ user
-
-### Test fail không rõ nguyên nhân
-1. KHÔNG sửa test để pass (trừ khi test sai)
-2. Chạy `/dw-debug` nếu cần
-3. Ghi vào progress nếu mất thời gian
-
-### Conflict với code khác
-1. Ghi vào progress
-2. Thông báo user
-3. Đề xuất giải quyết
-
-## Khi Hoàn Thành Tất Cả Subtasks
-
-1. Cập nhật progress: Trạng thái → `Done`
-2. Tóm tắt: subtasks completed, commits, issues encountered
-3. Luôn gợi ý: "Tiếp theo: `/dw-review $ARGUMENTS`"
-4. Nếu `workflow.default_depth = thorough`: "Cần chạy `/dw-docs-update $ARGUMENTS`"
-5. Nếu `tracking.log_work = true`: Hiển thị estimate vs actual, gợi ý `/dw-log-work $ARGUMENTS`
+---
+name: dw:execute
+description: "Thực hiện implementation theo plan đã được approve. Tuân thủ TDD, commit sau mỗi subtask. Chỉ dùng khi plan đã được duyệt."
+argument-hint: "[task-name]"
+---
+
+# Thực Hiện Implementation
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy:
+- `paths.tasks` → location task docs
+- `quality.test_command` → lệnh chạy tests (nếu có)
+- `quality.lint_command` → lệnh chạy linter (nếu có)
+- `quality.block_on_fail` → có block commit khi fail không
+- `tracking.log_work` → ghi effort tracking không
+- `workflow.default_depth` → `thorough` = cần docs-update, review bắt buộc
+
+## Detect Task Format (v1 vs v2)
+
+Kiểm tra `{paths.tasks}/$ARGUMENTS/`:
+- **v2**: có `spec.md` + `tracking.md` → đọc/ghi 2 files này.
+- **v1** (legacy): có `-context.md`/`-plan.md`/`-progress.md` → đọc/ghi bộ 3 files.
+
+## Trước Khi Bắt Đầu
+
+**v2:**
+1. Đọc `{paths.tasks}/$ARGUMENTS/spec.md` — Intent, Scope, Subtasks, Success Criteria, Research Findings.
+2. Đọc `{paths.tasks}/$ARGUMENTS/tracking.md` — Subtask Progress table, Changelog, Handoff Notes.
+3. Xác nhận `spec.md` frontmatter có `status: Approved`.
+
+**v1:**
+1. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
+2. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
+3. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`
+4. Xác nhận plan có `Trạng thái: Approved`
+
+Nếu plan chưa approved → **DỪNG**, yêu cầu approve trước.
+Nếu chưa có plan → **DỪNG**, yêu cầu chạy `/dw:plan $ARGUMENTS`.
+Nếu có progress → tiếp tục từ subtask cuối cùng chưa done.
+
+## Quy Trình Cho MỖI Subtask
+
+### Step 1: Chuẩn bị
+- Đọc subtask từ plan (mô tả, files, criteria)
+- Cập nhật progress: subtask → `in_progress`
+
+### Step 2: Test First (TDD)
+- Viết test cho subtask (nếu applicable)
+- Chạy test → confirm FAIL (red)
+- Nếu test đã pass → kiểm tra lại, có thể test sai
+
+### Step 3: Implement
+- Code theo spec trong plan
+- Tuân thủ conventions trong `.claude/rules/code-style.md`
+- KHÔNG thay đổi scope ngoài plan
+
+### Step 4: Verify
+- Chạy test → confirm PASS (green)
+- Nếu `quality.lint_command` không rỗng: chạy linter
+- Nếu `quality.block_on_fail = true` và fail → DỪNG, fix trước
+- Nếu `quality.block_on_fail = false` → cảnh báo, cho phép tiếp tục
+
+### Step 5: Cập nhật Progress
+**v2**: Cập nhật `{paths.tasks}/$ARGUMENTS/tracking.md`:
+- Update row trong section `## Subtask Progress` table với status `✅ Done`, Date, Notes (commit SHA).
+- Append entry vào `## Changelog` theo format:
+  ```markdown
+  ### {date} — ST-N complete
+  **Actions taken:** ...
+  ```
+- Update frontmatter `last_updated`.
+
+**v1**: Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
+```markdown
+| ST-N | [Subtask name] | Done | abc1234 | [ghi chú] |
+```
+
+Nếu `tracking.log_work = true`, ghi effort thực tế:
+- **v2**: thêm cột "Actual" vào Subtask Progress table hoặc ghi trong Changelog entry.
+- **v1**:
+  ```markdown
+  ### Effort Log
+  | Subtask | Estimate | Actual | Ghi chú |
+  ```
+
+### Step 6: Commit
+```
+<type>(<scope>): <mô tả subtask>
+
+Subtask ST-N of $ARGUMENTS
+```
+
+## Khi Phát Hiện Vấn Đề
+
+### Giả định sai / Scope thay đổi
+1. **DỪNG** implementation ngay
+2. Ghi vào progress → mục "Phát Hiện Mới"
+3. Thông báo user: vấn đề gì, ảnh hưởng gì
+4. Đề xuất: tiếp tục / cập nhật plan / thay đổi hướng
+5. **CHỜ** quyết định từ user
+
+### Test fail không rõ nguyên nhân
+1. KHÔNG sửa test để pass (trừ khi test sai)
+2. Chạy `/dw:debug` nếu cần
+3. Ghi vào progress nếu mất thời gian
+
+### Conflict với code khác
+1. Ghi vào progress
+2. Thông báo user
+3. Đề xuất giải quyết
+
+## Khi Hoàn Thành Tất Cả Subtasks
+
+1. Cập nhật status: **v2** `tracking.md` frontmatter `status: Done` · **v1** progress.md `Trạng thái: Done`.
+2. Tóm tắt: subtasks completed, commits, issues encountered
+3. Luôn gợi ý: "Tiếp theo: `/dw:review $ARGUMENTS`"
+4. Nếu `workflow.default_depth = thorough`: "Cần chạy `/dw:docs-update $ARGUMENTS`"
+5. Nếu `tracking.log_work = true`: Hiển thị estimate vs actual, gợi ý `/dw:log-work $ARGUMENTS`