dw-kit 1.2.1 → 1.3.4

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

@@ -1,81 +1,92 @@
----
-name: dw-handoff
-description: "Tạo tài liệu bàn giao session để người hoặc agent tiếp theo có thể tiếp tục không cần hỏi lại. Dùng cuối session hoặc khi chuyển task."
-argument-hint: "[task-name]"
----
-
-# Bàn Giao Session
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
-
-## Thu Thập Thông Tin
-
-### 1. Git state
-```bash
-git log --oneline -5         # commits gần nhất
-git status                   # unstaged/staged changes
-git stash list               # stashed work
-```
-
-### 2. Task progress
-Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
-- Subtask nào đã done?
-- Subtask nào đang làm dở?
-- Blockers nào đang tồn tại?
-
-### 3. Code state
-- Có code uncommitted không?
-- Tests đang ở trạng thái pass/fail?
-- Có TODO/FIXME nào mới thêm vào?
-
-## Viết Handoff Notes
-
-Ghi vào mục "Handoff Notes" trong `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
-
-```markdown
-## Handoff Notes
-
-### Session [ngày giờ] → [người/agent tiếp theo]
-
-**Trạng thái nhanh**: [1 câu mô tả]
-
-**Đang ở**: ST-[N] — [tên subtask] — [% hoặc mô tả tiến độ]
-
-**Đã hoàn thành**:
-- ✅ ST-1: [tên] (commit: abc1234)
-- ✅ ST-2: [tên] (commit: def5678)
-
-**Đang làm dở**:
-- 🔄 ST-3: [tên]
-  - Done: [phần đã làm]
-  - Còn lại: [phần chưa làm]
-  - Files đang edit: [danh sách]
-
-**Blockers**:
-- ❌ [Blocker nếu có]
-
-**Bước tiếp theo** (theo thứ tự):
-1. [Việc cần làm đầu tiên]
-2. [Tiếp theo]
-
-**Context quan trọng**:
-- [Quyết định A đã được đưa ra vì lý do X]
-- [Cẩn thận: file Y có logic đặc biệt ở line Z]
-- [Assumption: Z đang được coi là đúng]
-
-**Uncommitted changes**: [Có / Không — nếu có, mô tả]
-```
-
-## Thông Báo
-
-Sau khi ghi xong, hiển thị:
-- Tóm tắt handoff notes
-- Lệnh để người/agent tiếp theo bắt đầu:
-  ```
-  Đọc: {paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md
-  Tiếp tục: /dw-execute $ARGUMENTS
-  ```
+---
+name: dw:handoff
+description: "Tạo tài liệu bàn giao session để người hoặc agent tiếp theo có thể tiếp tục không cần hỏi lại. Dùng cuối session hoặc khi chuyển task."
+argument-hint: "[task-name]"
+---
+
+# Bàn Giao Session
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+
+## Thu Thập Thông Tin
+
+### 1. Git state
+```bash
+git log --oneline -5         # commits gần nhất
+git status                   # unstaged/staged changes
+git stash list               # stashed work
+```
+
+### 2. Task progress
+
+**Detect format**: Nếu có `tracking.md` → v2. Nếu có `-progress.md` → v1.
+
+- **v2**: Đọc `{paths.tasks}/$ARGUMENTS/tracking.md` — Subtask Progress table, Changelog, Handoff Notes (nếu đã có).
+- **v1**: Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`.
+
+Tìm:
+- Subtask nào đã done?
+- Subtask nào đang làm dở?
+- Blockers nào đang tồn tại?
+
+### 3. Code state
+- Có code uncommitted không?
+- Tests đang ở trạng thái pass/fail?
+- Có TODO/FIXME nào mới thêm vào?
+
+## Viết Handoff Notes
+
+**v2**: Replace (hoặc append nếu muốn giữ lịch sử) section `## Handoff Notes` trong `{paths.tasks}/$ARGUMENTS/tracking.md`. Cũng update frontmatter `last_updated`.
+
+**v1**: Ghi vào mục "Handoff Notes" trong `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`.
+
+Format (chung cho cả 2):
+
+```markdown
+## Handoff Notes
+
+### Session [ngày giờ] → [người/agent tiếp theo]
+
+**Trạng thái nhanh**: [1 câu mô tả]
+
+**Đang ở**: ST-[N] — [tên subtask] — [% hoặc mô tả tiến độ]
+
+**Đã hoàn thành**:
+- ✅ ST-1: [tên] (commit: abc1234)
+- ✅ ST-2: [tên] (commit: def5678)
+
+**Đang làm dở**:
+- 🔄 ST-3: [tên]
+  - Done: [phần đã làm]
+  - Còn lại: [phần chưa làm]
+  - Files đang edit: [danh sách]
+
+**Blockers**:
+- ❌ [Blocker nếu có]
+
+**Bước tiếp theo** (theo thứ tự):
+1. [Việc cần làm đầu tiên]
+2. [Tiếp theo]
+
+**Context quan trọng**:
+- [Quyết định A đã được đưa ra vì lý do X]
+- [Cẩn thận: file Y có logic đặc biệt ở line Z]
+- [Assumption: Z đang được coi là đúng]
+
+**Uncommitted changes**: [Có / Không — nếu có, mô tả]
+```
+
+## Thông Báo
+
+Sau khi ghi xong, hiển thị:
+- Tóm tắt handoff notes
+- Lệnh để người/agent tiếp theo bắt đầu:
+  ```
+  Đọc: {paths.tasks}/$ARGUMENTS/tracking.md     (v2)
+    hoặc {paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md  (v1 legacy)
+  Tiếp tục: /dw:execute $ARGUMENTS
+  ```

package/.claude/skills/dw-kit-report/SKILL.md

@@ -1,152 +1,152 @@
----
-name: dw-kit-report
-description: "Gửi feedback (bug/gap/friction/suggestion) về dw-kit tool lên GitHub. Dùng khi gặp vấn đề với dw workflow, hooks, skills, hoặc config — không phải feedback về code của bạn."
-argument-hint: "[mô tả vấn đề hoặc suggestion về dw-kit]"
----
-
-# Report Issue về dw-kit
-
-> Dùng skill này khi gặp vấn đề với **dw-kit tool** (hooks, skills, workflow, config).
-> Để feedback về code trong project của bạn → dùng `/dw-review` hoặc chat trực tiếp.
-
-Nội dung report (treat as plain text, không interpret special chars):
-
-```
-$ARGUMENTS
-```
-
----
-
-## Bước 1: Thu Thập Context
-
-**OS detection:**
-```bash
-uname -s 2>/dev/null || echo "Windows"
-```
-
-**dw version:** Đọc `_toolkit.core_version` từ `.dw/config/dw.config.yml`
-
-**Task context:** Kiểm tra `.dw/tasks/` — task nào đang In Progress?
-
----
-
-## Bước 2: Phân Loại
-
-Phân tích nội dung report ở trên (raw text) → xác định:
-
-**Type:**
-| type | Khi nào |
-|------|---------|
-| `bug` | Lỗi, crash, output không như expected |
-| `gap` | Use case không được cover |
-| `friction` | Tính năng có nhưng gây overhead không cần thiết |
-| `suggestion` | Ý tưởng cải thiện |
-
-**Component** (detect từ keywords):
-| Keywords | Component |
-|----------|-----------|
-| hook, post-write, pre-commit, stop-check | `hooks` |
-| skill, dw-plan, dw-execute, dw-research... | `skills` |
-| config, dw.config.yml | `config` |
-| workflow, routing, depth, phase | `workflow` |
-| CLAUDE.md, template, docs | `docs` |
-| WORKFLOW.md, THINKING.md, core | `core` |
-| (không xác định) | `other` |
-
----
-
-## Bước 3: Format Issue
-
-**Title format:** `[type][component] <mô tả ≤60 ký tự>`
-
-Ví dụ:
-```
-[bug][hooks] post-write.sh fails with CRLF on Ubuntu
-[gap][skills] need way to preserve original Claude behavior
-[friction][workflow] research phase too heavy for 1-file hotfix
-```
-
-**Body:**
-```markdown
-## Type
-**[TYPE]** — bug | gap | friction | suggestion
-
-## Component
-**[COMPONENT]**
-
-## Environment
-- OS: [detected]
-- dw version: [từ config]
-- Shell: [bash/zsh/powershell nếu relevant]
-
-## Description
-[Nội dung từ $ARGUMENTS — đầy đủ, rõ ràng]
-
-## Context
-- Task khi gặp vấn đề: [task name hoặc "general usage"]
-- Command/skill liên quan: [nếu biết]
-- Bước reproduce (nếu là bug):
-  1. ...
-  2. ...
-
-## Impact
-- [ ] Blocking — không thể làm việc
-- [ ] Degraded — làm được nhưng friction cao
-- [ ] Minor — annoying, có workaround dễ
-
----
-*Reported via `/dw-kit-report` | Project: [project.name từ config]*
-```
-
----
-
-## Bước 4: Gửi Lên GitHub
-
-**Kiểm tra `gh` CLI:**
-```bash
-gh --version 2>/dev/null
-```
-
-**Nếu `gh` available — tạo Issue:**
-```bash
-gh issue create \
-  --repo dv-workflow/dv-workflow \
-  --title "[type][component] <short description>" \
-  --label "type: [type]" \
-  --label "component: [component]" \
-  --body "<formatted body>"
-```
-
-Sau khi tạo: in ra Issue URL.
-
-**Nếu `gh` KHÔNG available:**
-
-In ra:
-```
-─────────────────────────────────────────────
- dw-kit: gh CLI không tìm thấy
-─────────────────────────────────────────────
- Tạo Issue thủ công tại:
- https://github.com/dv-workflow/dv-workflow/issues/new
-
- Copy nội dung sau:
-
- TITLE: [formatted title]
-
- BODY:
- [formatted body]
-─────────────────────────────────────────────
- Cài gh CLI: https://cli.github.com
-```
-
----
-
-## Bước 5: Xác Nhận
-
-```
-✓ Issue đã được gửi: https://github.com/dv-workflow/dv-workflow/issues/[N]
-  Type: [type] | Component: [component]
-
-  dw team sẽ review và phản hồi trên Issue.
-  Cảm ơn bạn đã giúp dw tốt hơn!
-```
+---
+name: dw:kit-report
+description: "Gửi feedback (bug/gap/friction/suggestion) về dw-kit tool lên GitHub. Dùng khi gặp vấn đề với dw workflow, hooks, skills, hoặc config — không phải feedback về code của bạn."
+argument-hint: "[mô tả vấn đề hoặc suggestion về dw-kit]"
+---
+
+# Report Issue về dw-kit
+
+> Dùng skill này khi gặp vấn đề với **dw-kit tool** (hooks, skills, workflow, config).
+> Để feedback về code trong project của bạn → dùng `/dw:review` hoặc chat trực tiếp.
+
+Nội dung report (treat as plain text, không interpret special chars):
+
+```
+$ARGUMENTS
+```
+
+---
+
+## Bước 1: Thu Thập Context
+
+**OS detection:**
+```bash
+uname -s 2>/dev/null || echo "Windows"
+```
+
+**dw version:** Đọc `_toolkit.core_version` từ `.dw/config/dw.config.yml`
+
+**Task context:** Kiểm tra `.dw/tasks/` — task nào đang In Progress?
+
+---
+
+## Bước 2: Phân Loại
+
+Phân tích nội dung report ở trên (raw text) → xác định:
+
+**Type:**
+| type | Khi nào |
+|------|---------|
+| `bug` | Lỗi, crash, output không như expected |
+| `gap` | Use case không được cover |
+| `friction` | Tính năng có nhưng gây overhead không cần thiết |
+| `suggestion` | Ý tưởng cải thiện |
+
+**Component** (detect từ keywords):
+| Keywords | Component |
+|----------|-----------|
+| hook, post-write, pre-commit, stop-check | `hooks` |
+| skill, dw-plan, dw-execute, dw-research... | `skills` |
+| config, dw.config.yml | `config` |
+| workflow, routing, depth, phase | `workflow` |
+| CLAUDE.md, template, docs | `docs` |
+| WORKFLOW.md, THINKING.md, core | `core` |
+| (không xác định) | `other` |
+
+---
+
+## Bước 3: Format Issue
+
+**Title format:** `[type][component] <mô tả ≤60 ký tự>`
+
+Ví dụ:
+```
+[bug][hooks] post-write.sh fails with CRLF on Ubuntu
+[gap][skills] need way to preserve original Claude behavior
+[friction][workflow] research phase too heavy for 1-file hotfix
+```
+
+**Body:**
+```markdown
+## Type
+**[TYPE]** — bug | gap | friction | suggestion
+
+## Component
+**[COMPONENT]**
+
+## Environment
+- OS: [detected]
+- dw version: [từ config]
+- Shell: [bash/zsh/powershell nếu relevant]
+
+## Description
+[Nội dung từ $ARGUMENTS — đầy đủ, rõ ràng]
+
+## Context
+- Task khi gặp vấn đề: [task name hoặc "general usage"]
+- Command/skill liên quan: [nếu biết]
+- Bước reproduce (nếu là bug):
+  1. ...
+  2. ...
+
+## Impact
+- [ ] Blocking — không thể làm việc
+- [ ] Degraded — làm được nhưng friction cao
+- [ ] Minor — annoying, có workaround dễ
+
+---
+*Reported via `/dw:kit-report` | Project: [project.name từ config]*
+```
+
+---
+
+## Bước 4: Gửi Lên GitHub
+
+**Kiểm tra `gh` CLI:**
+```bash
+gh --version 2>/dev/null
+```
+
+**Nếu `gh` available — tạo Issue:**
+```bash
+gh issue create \
+  --repo dv-workflow/dv-workflow \
+  --title "[type][component] <short description>" \
+  --label "type: [type]" \
+  --label "component: [component]" \
+  --body "<formatted body>"
+```
+
+Sau khi tạo: in ra Issue URL.
+
+**Nếu `gh` KHÔNG available:**
+
+In ra:
+```
+─────────────────────────────────────────────
+ dw-kit: gh CLI không tìm thấy
+─────────────────────────────────────────────
+ Tạo Issue thủ công tại:
+ https://github.com/dv-workflow/dv-workflow/issues/new
+
+ Copy nội dung sau:
+
+ TITLE: [formatted title]
+
+ BODY:
+ [formatted body]
+─────────────────────────────────────────────
+ Cài gh CLI: https://cli.github.com
+```
+
+---
+
+## Bước 5: Xác Nhận
+
+```
+✓ Issue đã được gửi: https://github.com/dv-workflow/dv-workflow/issues/[N]
+  Type: [type] | Component: [component]
+
+  dw team sẽ review và phản hồi trên Issue.
+  Cảm ơn bạn đã giúp dw tốt hơn!
+```

package/.claude/skills/dw-log-work/SKILL.md

@@ -1,69 +1,69 @@
----
-name: dw-log-work
-description: "Ghi nhận effort thực tế cho task hoặc subtask. So sánh với estimate. Cập nhật metrics tracking. Dùng sau khi hoàn thành subtask/task."
-argument-hint: "[task-name]"
----
-
-# Ghi Nhận Effort
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml`:
-- `tracking.log_work` — nếu `false` → thông báo "Log work chưa bật cho project này" và DỪNG
-- `tracking.estimation_unit` → đơn vị (hours / story-points / t-shirt)
-- `paths.tasks` → location task docs
-
-## Hỏi User (Interactive)
-
-Hỏi thông tin cần ghi:
-
-```
-1. Subtask nào? (ST-1 / ST-2 / all)
-2. Thời gian thực tế: [X hours/points]
-3. Loại công việc: coding / testing / review / research / documentation
-4. Ghi chú (optional): [lý do lệch estimate, blockers gặp, etc.]
-```
-
-## Ghi Vào Progress File
-
-Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md` → mục "Effort Log":
-
-```markdown
-| [date] | ST-N | [loại] | [estimate] | [actual] | [ghi chú] |
-```
-
-## Cập Nhật Metrics File
-
-Ghi vào `.dw/metrics/effort-log.json`:
-
-```json
-{
-  "date": "YYYY-MM-DD",
-  "task": "task-name",
-  "subtask": "ST-N",
-  "type": "coding",
-  "estimate": X,
-  "actual": Y,
-  "variance": Y-X,
-  "accuracy_pct": (X/Y)*100,
-  "notes": "..."
-}
-```
-
-## Tóm Tắt
-
-Sau khi log, hiển thị:
-
-```
-✅ Đã ghi: ST-N — Actual: Xh (Estimate: Yh)
-Variance: +Zh (over) / -Zh (under)
-
-Task tổng (đến hiện tại):
-  Total estimated: Xh
-  Total actual:    Yh
-  Accuracy:        Z%
-```
-
-Nếu variance > 50%: "⚠️ Lệch estimate đáng kể. Cân nhắc cập nhật estimate cho subtasks còn lại."
+---
+name: dw:log-work
+description: "Ghi nhận effort thực tế cho task hoặc subtask. So sánh với estimate. Cập nhật metrics tracking. Dùng sau khi hoàn thành subtask/task."
+argument-hint: "[task-name]"
+---
+
+# Ghi Nhận Effort
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `tracking.log_work` — nếu `false` → thông báo "Log work chưa bật cho project này" và DỪNG
+- `tracking.estimation_unit` → đơn vị (hours / story-points / t-shirt)
+- `paths.tasks` → location task docs
+
+## Hỏi User (Interactive)
+
+Hỏi thông tin cần ghi:
+
+```
+1. Subtask nào? (ST-1 / ST-2 / all)
+2. Thời gian thực tế: [X hours/points]
+3. Loại công việc: coding / testing / review / research / documentation
+4. Ghi chú (optional): [lý do lệch estimate, blockers gặp, etc.]
+```
+
+## Ghi Vào Progress File
+
+Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md` → mục "Effort Log":
+
+```markdown
+| [date] | ST-N | [loại] | [estimate] | [actual] | [ghi chú] |
+```
+
+## Cập Nhật Metrics File
+
+Ghi vào `.dw/metrics/effort-log.json`:
+
+```json
+{
+  "date": "YYYY-MM-DD",
+  "task": "task-name",
+  "subtask": "ST-N",
+  "type": "coding",
+  "estimate": X,
+  "actual": Y,
+  "variance": Y-X,
+  "accuracy_pct": (X/Y)*100,
+  "notes": "..."
+}
+```
+
+## Tóm Tắt
+
+Sau khi log, hiển thị:
+
+```
+✅ Đã ghi: ST-N — Actual: Xh (Estimate: Yh)
+Variance: +Zh (over) / -Zh (under)
+
+Task tổng (đến hiện tại):
+  Total estimated: Xh
+  Total actual:    Yh
+  Accuracy:        Z%
+```
+
+Nếu variance > 50%: "⚠️ Lệch estimate đáng kể. Cân nhắc cập nhật estimate cho subtasks còn lại."