dw-kit 1.2.1 → 1.3.0

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

@@ -1,66 +1,66 @@
----
-name: dw-review
-description: "Review code thay đổi gần đây hoặc cả task. Kiểm tra correctness, security, conventions, test coverage. Tạo báo cáo phân loại Critical/Warning/Suggestion."
-argument-hint: "[task-name | branch | file]"
-context: fork
-agent: reviewer
-allowed-tools:
-  - Read
-  - Grep
-  - Glob
-  - "Bash(git diff *)"
-  - "Bash(git log *)"
-  - "Bash(git show *)"
----
-
-# Code Review
-
-Target: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
-
-## Xác Định Scope
-
-- Nếu có argument = task-name: review tất cả commits liên quan đến task
-- Nếu có argument = branch: `git diff main...$ARGUMENTS`
-- Nếu không có argument: `git diff HEAD~1` (commit gần nhất)
-
-## Quy Trình
-
-### 1. Lấy diff
-```bash
-git diff [scope] --name-only   # danh sách files changed
-git diff [scope]                # nội dung thay đổi
-```
-
-### 2. Đọc files liên quan
-Đọc toàn bộ files đã changed để hiểu full context (không chỉ diff).
-
-### 3. Review theo reviewer agent
-
-Agent `reviewer` sẽ kiểm tra:
-- **Correctness**: Logic, edge cases, error handling
-- **Security**: Input validation, auth, data exposure
-- **Performance**: N+1, unnecessary calls, complexity
-- **Tests**: Coverage, test quality
-- **Conventions**: Naming, structure, code style (`.claude/rules/code-style.md`)
-
-### 4. Kiểm tra checklist cụ thể
-
-Nếu có plan file (`{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`):
-- Đối chiếu acceptance criteria từng subtask
-- Kiểm tra scope có vượt plan không
-
-### 5. Output
-
-Tạo báo cáo đầy đủ theo format của reviewer agent.
-
-## Sau Review
-
-- Nếu có Critical issues: "Cần fix trước khi merge"
-- Nếu chỉ có Warnings: "Khuyến khích fix, nhưng có thể proceed"
-- Nếu pass: "Approved — có thể chạy `/dw-commit`"
-
-Nếu team có TL: "Gợi ý gửi báo cáo này cho TL để final approve."
+---
+name: dw:review
+description: "Review code thay đổi gần đây hoặc cả task. Kiểm tra correctness, security, conventions, test coverage. Tạo báo cáo phân loại Critical/Warning/Suggestion."
+argument-hint: "[task-name | branch | file]"
+context: fork
+agent: reviewer
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - "Bash(git diff *)"
+  - "Bash(git log *)"
+  - "Bash(git show *)"
+---
+
+# Code Review
+
+Target: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+
+## Xác Định Scope
+
+- Nếu có argument = task-name: review tất cả commits liên quan đến task
+- Nếu có argument = branch: `git diff main...$ARGUMENTS`
+- Nếu không có argument: `git diff HEAD~1` (commit gần nhất)
+
+## Quy Trình
+
+### 1. Lấy diff
+```bash
+git diff [scope] --name-only   # danh sách files changed
+git diff [scope]                # nội dung thay đổi
+```
+
+### 2. Đọc files liên quan
+Đọc toàn bộ files đã changed để hiểu full context (không chỉ diff).
+
+### 3. Review theo reviewer agent
+
+Agent `reviewer` sẽ kiểm tra:
+- **Correctness**: Logic, edge cases, error handling
+- **Security**: Input validation, auth, data exposure
+- **Performance**: N+1, unnecessary calls, complexity
+- **Tests**: Coverage, test quality
+- **Conventions**: Naming, structure, code style (`.claude/rules/code-style.md`)
+
+### 4. Kiểm tra checklist cụ thể
+
+Nếu có plan file (`{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`):
+- Đối chiếu acceptance criteria từng subtask
+- Kiểm tra scope có vượt plan không
+
+### 5. Output
+
+Tạo báo cáo đầy đủ theo format của reviewer agent.
+
+## Sau Review
+
+- Nếu có Critical issues: "Cần fix trước khi merge"
+- Nếu chỉ có Warnings: "Khuyến khích fix, nhưng có thể proceed"
+- Nếu pass: "Approved — có thể chạy `/dw:commit`"
+
+Nếu team có TL: "Gợi ý gửi báo cáo này cho TL để final approve."

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

@@ -1,90 +1,90 @@
----
-name: dw-rollback
-description: "Revert task docs về trạng thái trước. Dùng khi plan sai, execute sai hướng, hoặc cần bắt đầu lại từ sau research."
-argument-hint: "[task-name] [checkpoint: after-research | after-plan | clean]"
----
-
-# Rollback Task Docs: $ARGUMENTS
-
-## Parse Arguments
-
-Từ `$ARGUMENTS`:
-- `task-name`: tên task cần rollback
-- `checkpoint` (optional): điểm muốn revert về
-  - `after-research` — giữ context.md, xóa plan.md và reset progress.md
-  - `after-plan` — giữ context.md + plan.md, reset progress.md về trạng thái ban đầu
-  - `clean` — xóa toàn bộ nội dung, giữ files trống (restart từ đầu)
-  - (không có) → hỏi user chọn
-
-## Bước 1: Đọc config
-
-`paths.tasks` → xác định thư mục task.
-
-## Bước 2: Kiểm tra task tồn tại
-
-```
-{paths.tasks}/[task-name]/
-├── [task-name]-context.md
-├── [task-name]-plan.md
-└── [task-name]-progress.md
-```
-
-Nếu không tìm thấy → thông báo và DỪNG.
-
-## Bước 3: Git checkpoint (an toàn)
-
-Kiểm tra uncommitted changes trong task docs:
-```bash
-git status {paths.tasks}/[task-name]/
-```
-
-Nếu có uncommitted changes → hỏi: "Có uncommitted changes trong task docs. Commit trước khi rollback? (y/n/skip)"
-
-## Bước 4: Hiển thị preview và confirm
-
-Hiển thị rõ sẽ làm gì:
-```
-Rollback [task-name] về checkpoint: [checkpoint]
-
-Sẽ GIỮ:
-  ✓ [task-name]-context.md  (research findings)
-
-Sẽ RESET:
-  ✗ [task-name]-plan.md     → xóa nội dung, giữ file trống
-  ✗ [task-name]-progress.md → reset về "Not Started"
-
-Tiếp tục? (y/n)
-```
-
-Chờ user confirm trước khi thực hiện.
-
-## Bước 5: Thực hiện rollback
-
-### checkpoint = "after-research"
-- Giữ `context.md` nguyên vẹn
-- Reset `plan.md` → file trống (chỉ giữ header)
-- Reset `progress.md` → status = "Not Started", xóa subtask rows
-
-### checkpoint = "after-plan"
-- Giữ `context.md` nguyên vẹn
-- Giữ `plan.md` nguyên vẹn
-- Reset `progress.md` → status = "Not Started", tất cả subtasks = Pending
-
-### checkpoint = "clean"
-- Reset tất cả 3 files về template trống
-- Điền lại [Task Name] và [date]
-
-## Bước 6: Thông báo
-
-```
-Rollback hoàn tất.
-
-Task: [task-name]
-Checkpoint: [checkpoint]
-Thời gian: [timestamp]
-
-Bước tiếp theo:
-- after-research → Chạy /dw-plan [task-name] để lập kế hoạch lại
-- after-plan     → Chạy /dw-execute [task-name] để implement lại
-- clean          → Chạy /dw-research [task-name] để bắt đầu từ đầu
-```
+---
+name: dw:rollback
+description: "Revert task docs về trạng thái trước. Dùng khi plan sai, execute sai hướng, hoặc cần bắt đầu lại từ sau research."
+argument-hint: "[task-name] [checkpoint: after-research | after-plan | clean]"
+---
+
+# Rollback Task Docs: $ARGUMENTS
+
+## Parse Arguments
+
+Từ `$ARGUMENTS`:
+- `task-name`: tên task cần rollback
+- `checkpoint` (optional): điểm muốn revert về
+  - `after-research` — giữ context.md, xóa plan.md và reset progress.md
+  - `after-plan` — giữ context.md + plan.md, reset progress.md về trạng thái ban đầu
+  - `clean` — xóa toàn bộ nội dung, giữ files trống (restart từ đầu)
+  - (không có) → hỏi user chọn
+
+## Bước 1: Đọc config
+
+`paths.tasks` → xác định thư mục task.
+
+## Bước 2: Kiểm tra task tồn tại
+
+```
+{paths.tasks}/[task-name]/
+├── [task-name]-context.md
+├── [task-name]-plan.md
+└── [task-name]-progress.md
+```
+
+Nếu không tìm thấy → thông báo và DỪNG.
+
+## Bước 3: Git checkpoint (an toàn)
+
+Kiểm tra uncommitted changes trong task docs:
+```bash
+git status {paths.tasks}/[task-name]/
+```
+
+Nếu có uncommitted changes → hỏi: "Có uncommitted changes trong task docs. Commit trước khi rollback? (y/n/skip)"
+
+## Bước 4: Hiển thị preview và confirm
+
+Hiển thị rõ sẽ làm gì:
+```
+Rollback [task-name] về checkpoint: [checkpoint]
+
+Sẽ GIỮ:
+  ✓ [task-name]-context.md  (research findings)
+
+Sẽ RESET:
+  ✗ [task-name]-plan.md     → xóa nội dung, giữ file trống
+  ✗ [task-name]-progress.md → reset về "Not Started"
+
+Tiếp tục? (y/n)
+```
+
+Chờ user confirm trước khi thực hiện.
+
+## Bước 5: Thực hiện rollback
+
+### checkpoint = "after-research"
+- Giữ `context.md` nguyên vẹn
+- Reset `plan.md` → file trống (chỉ giữ header)
+- Reset `progress.md` → status = "Not Started", xóa subtask rows
+
+### checkpoint = "after-plan"
+- Giữ `context.md` nguyên vẹn
+- Giữ `plan.md` nguyên vẹn
+- Reset `progress.md` → status = "Not Started", tất cả subtasks = Pending
+
+### checkpoint = "clean"
+- Reset tất cả 3 files về template trống
+- Điền lại [Task Name] và [date]
+
+## Bước 6: Thông báo
+
+```
+Rollback hoàn tất.
+
+Task: [task-name]
+Checkpoint: [checkpoint]
+Thời gian: [timestamp]
+
+Bước tiếp theo:
+- after-research → Chạy /dw:plan [task-name] để lập kế hoạch lại
+- after-plan     → Chạy /dw:execute [task-name] để implement lại
+- clean          → Chạy /dw:research [task-name] để bắt đầu từ đầu
+```

package/.claude/skills/dw-sprint-review/SKILL.md

@@ -1,99 +1,99 @@
----
-name: dw-sprint-review
-description: "Tổng kết sprint: tasks hoàn thành, metrics, lessons learned, items cho sprint tiếp theo. Dành cho team retrospective cuối sprint."
-argument-hint: "[sprint-name hoặc period: e.g. sprint-3, 2026-03]"
----
-
-# Sprint Review: $ARGUMENTS
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml`:
-- `paths.tasks` → tìm task docs
-- `.dw/metrics` → tìm effort data
-- `tracking.estimation`, `tracking.log_work` → biết có data nào
-
-## Bước 1: Thu thập dữ liệu
-
-### Tasks trong sprint
-Scan `{paths.tasks}/` tìm tasks có status Done hoặc In Progress trong kỳ sprint.
-Đọc `*-progress.md` của mỗi task để lấy:
-- Trạng thái cuối
-- Effort estimate vs actual
-- Blockers gặp phải
-- Commits liên quan
-
-### Git history
-```bash
-git log --oneline --since="[sprint-start]" --until="[sprint-end]"
-```
-
-## Bước 2: Tạo báo cáo sprint
-
-Ghi vào `{paths.reports}/sprint-review-$ARGUMENTS.md`:
-
-```markdown
-# Sprint Review: [Sprint Name]
-
-**Kỳ**: [start] → [end]
-**Team**: [roles từ config]
-**Ngày tạo**: [date]
-
----
-
-## Tóm Tắt
-
-| Metric | Giá trị |
-|--------|---------|
-| Tasks hoàn thành | X/Y |
-| Estimate tổng | Xh |
-| Actual tổng | Xh |
-| Accuracy | X% |
-| Commits | X |
-
-## Tasks Hoàn Thành
-
-| Task | Estimate | Actual | Variance | Ghi chú |
-|------|----------|--------|----------|---------|
-| [task-name] | | | | |
-
-## Tasks Chưa Hoàn Thành / Carry-over
-
-| Task | Lý do | Hành động |
-|------|-------|-----------|
-| | | |
-
-## Blockers Gặp Phải
-
-[Danh sách blockers, đã giải quyết hay chưa]
-
-## Lessons Learned
-
-### Làm tốt (Keep)
-- [Điều gì hiệu quả trong sprint này]
-
-### Cần cải thiện (Improve)
-- [Điều gì cần làm khác đi]
-
-### Thử nghiệm (Try)
-- [Điều gì muốn thử trong sprint sau]
-
-## Items Cho Sprint Tiếp Theo
-
-- [ ] [Action item 1] — owner: [role]
-- [ ] [Action item 2]
-
-## DORA Metrics (nếu có data)
-
-| Metric | Giá trị | Target |
-|--------|---------|--------|
-| Deployment frequency | | |
-| Lead time for changes | | |
-| Change failure rate | | |
-| MTTR | | |
-```
-
-## Bước 3: Thông báo
-
-Hiển thị summary và path đến file báo cáo.
-Gợi ý: "PM có thể chạy `/dw-dashboard` để xem báo cáo đầy đủ hơn."
+---
+name: dw:sprint-review
+description: "Tổng kết sprint: tasks hoàn thành, metrics, lessons learned, items cho sprint tiếp theo. Dành cho team retrospective cuối sprint."
+argument-hint: "[sprint-name hoặc period: e.g. sprint-3, 2026-03]"
+---
+
+# Sprint Review: $ARGUMENTS
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `paths.tasks` → tìm task docs
+- `.dw/metrics` → tìm effort data
+- `tracking.estimation`, `tracking.log_work` → biết có data nào
+
+## Bước 1: Thu thập dữ liệu
+
+### Tasks trong sprint
+Scan `{paths.tasks}/` tìm tasks có status Done hoặc In Progress trong kỳ sprint.
+Đọc `*-progress.md` của mỗi task để lấy:
+- Trạng thái cuối
+- Effort estimate vs actual
+- Blockers gặp phải
+- Commits liên quan
+
+### Git history
+```bash
+git log --oneline --since="[sprint-start]" --until="[sprint-end]"
+```
+
+## Bước 2: Tạo báo cáo sprint
+
+Ghi vào `{paths.reports}/sprint-review-$ARGUMENTS.md`:
+
+```markdown
+# Sprint Review: [Sprint Name]
+
+**Kỳ**: [start] → [end]
+**Team**: [roles từ config]
+**Ngày tạo**: [date]
+
+---
+
+## Tóm Tắt
+
+| Metric | Giá trị |
+|--------|---------|
+| Tasks hoàn thành | X/Y |
+| Estimate tổng | Xh |
+| Actual tổng | Xh |
+| Accuracy | X% |
+| Commits | X |
+
+## Tasks Hoàn Thành
+
+| Task | Estimate | Actual | Variance | Ghi chú |
+|------|----------|--------|----------|---------|
+| [task-name] | | | | |
+
+## Tasks Chưa Hoàn Thành / Carry-over
+
+| Task | Lý do | Hành động |
+|------|-------|-----------|
+| | | |
+
+## Blockers Gặp Phải
+
+[Danh sách blockers, đã giải quyết hay chưa]
+
+## Lessons Learned
+
+### Làm tốt (Keep)
+- [Điều gì hiệu quả trong sprint này]
+
+### Cần cải thiện (Improve)
+- [Điều gì cần làm khác đi]
+
+### Thử nghiệm (Try)
+- [Điều gì muốn thử trong sprint sau]
+
+## Items Cho Sprint Tiếp Theo
+
+- [ ] [Action item 1] — owner: [role]
+- [ ] [Action item 2]
+
+## DORA Metrics (nếu có data)
+
+| Metric | Giá trị | Target |
+|--------|---------|--------|
+| Deployment frequency | | |
+| Lead time for changes | | |
+| Change failure rate | | |
+| MTTR | | |
+```
+
+## Bước 3: Thông báo
+
+Hiển thị summary và path đến file báo cáo.
+Gợi ý: "PM có thể chạy `/dw:dashboard` để xem báo cáo đầy đủ hơn."

package/.claude/skills/dw-task-init/SKILL.md

@@ -1,59 +1,59 @@
----
-name: dw-task-init
-description: "Khởi tạo bộ documentation cho task mới. Tạo thư mục và 3 template files (context, plan, progress)."
-argument-hint: "[task-name]"
----
-
-# Khởi Tạo Task: $ARGUMENTS
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` để lấy:
-- `paths.tasks` → thư mục chứa task docs (mặc định: `.dw/tasks`)
-- `workflow.default_depth` → `quick | standard | thorough`
-- `tracking.estimation` → có tạo section estimation không
-- `tracking.log_work` → có tạo section effort log không
-- `team.roles` → hiển thị workflow phù hợp
-- `project.language` → chọn template ngôn ngữ
-
-## Tạo Thư Mục & Files
-
-```
-{paths.tasks}/$ARGUMENTS/
-├── $ARGUMENTS-context.md    # Research findings & codebase analysis
-├── $ARGUMENTS-plan.md       # Implementation plan & design
-└── $ARGUMENTS-progress.md   # Progress tracking, effort log, changelog
-```
-
-### File context.md
-Đọc `project.language` từ config để chọn template:
-- `language: "vi"` → dùng `.claude/templates/task-context.md`
-- `language: "en"` → dùng `.claude/templates/en/task-context.md`
-
-Điền vào template:
-- `[Task Name]` = `$ARGUMENTS`
-- `[date]` = ngày hiện tại
-
-### File plan.md
-Chọn template theo `project.language` (`.claude/templates/[lang]/task-plan.md`).
-- Nếu `tracking.estimation = true`: giữ nguyên section Estimation
-- Nếu `tracking.estimation = false`: xóa section Estimation
-
-### File progress.md
-Chọn template theo `project.language` (`.claude/templates/[lang]/task-progress.md`).
-- Điền `[Task Name]` = `$ARGUMENTS`
-- Điền `[date]` = ngày hiện tại
-- Nếu `tracking.log_work = true`: giữ section Effort Log
-- Nếu `tracking.log_work = false`: xóa section Effort Log
-
-## Sau Khi Tạo
-
-Hiển thị cho user:
-1. Danh sách files đã tạo
-2. Workflow tiếp theo dựa trên `workflow.default_depth`:
-
-**quick**: "Tiếp theo: Code ngay hoặc `/dw-research $ARGUMENTS` nếu cần khảo sát"
-**standard**: "Tiếp theo: `/dw-research $ARGUMENTS` → `/dw-plan $ARGUMENTS` → approve → `/dw-execute $ARGUMENTS`"
-**thorough**: "Tiếp theo: `/dw-requirements $ARGUMENTS` → `/dw-research $ARGUMENTS` → `/dw-estimate $ARGUMENTS` → `/dw-plan $ARGUMENTS`"
-
-Nếu team có BA: "Gợi ý: BA có thể chạy `/dw-requirements $ARGUMENTS` trước để chuẩn bị yêu cầu"
+---
+name: dw:task-init
+description: "Khởi tạo bộ documentation cho task mới. Tạo thư mục và 3 template files (context, plan, progress)."
+argument-hint: "[task-name]"
+---
+
+# Khởi Tạo Task: $ARGUMENTS
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` để lấy:
+- `paths.tasks` → thư mục chứa task docs (mặc định: `.dw/tasks`)
+- `workflow.default_depth` → `quick | standard | thorough`
+- `tracking.estimation` → có tạo section estimation không
+- `tracking.log_work` → có tạo section effort log không
+- `team.roles` → hiển thị workflow phù hợp
+- `project.language` → chọn template ngôn ngữ
+
+## Tạo Thư Mục & Files
+
+```
+{paths.tasks}/$ARGUMENTS/
+├── $ARGUMENTS-context.md    # Research findings & codebase analysis
+├── $ARGUMENTS-plan.md       # Implementation plan & design
+└── $ARGUMENTS-progress.md   # Progress tracking, effort log, changelog
+```
+
+### File context.md
+Đọc `project.language` từ config để chọn template:
+- `language: "vi"` → dùng `.claude/templates/task-context.md`
+- `language: "en"` → dùng `.claude/templates/en/task-context.md`
+
+Điền vào template:
+- `[Task Name]` = `$ARGUMENTS`
+- `[date]` = ngày hiện tại
+
+### File plan.md
+Chọn template theo `project.language` (`.claude/templates/[lang]/task-plan.md`).
+- Nếu `tracking.estimation = true`: giữ nguyên section Estimation
+- Nếu `tracking.estimation = false`: xóa section Estimation
+
+### File progress.md
+Chọn template theo `project.language` (`.claude/templates/[lang]/task-progress.md`).
+- Điền `[Task Name]` = `$ARGUMENTS`
+- Điền `[date]` = ngày hiện tại
+- Nếu `tracking.log_work = true`: giữ section Effort Log
+- Nếu `tracking.log_work = false`: xóa section Effort Log
+
+## Sau Khi Tạo
+
+Hiển thị cho user:
+1. Danh sách files đã tạo
+2. Workflow tiếp theo dựa trên `workflow.default_depth`:
+
+**quick**: "Tiếp theo: Code ngay hoặc `/dw:research $ARGUMENTS` nếu cần khảo sát"
+**standard**: "Tiếp theo: `/dw:research $ARGUMENTS` → `/dw:plan $ARGUMENTS` → approve → `/dw:execute $ARGUMENTS`"
+**thorough**: "Tiếp theo: `/dw:requirements $ARGUMENTS` → `/dw:research $ARGUMENTS` → `/dw:estimate $ARGUMENTS` → `/dw:plan $ARGUMENTS`"
+
+Nếu team có BA: "Gợi ý: BA có thể chạy `/dw:requirements $ARGUMENTS` trước để chuẩn bị yêu cầu"