dw-kit 1.2.1 → 1.3.4

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

@@ -1,98 +1,98 @@
----
-name: dw-requirements
-description: "BA skill: Thu thập, phân tích và viết requirements document + user stories. Dùng ở đầu feature trước khi dev bắt đầu."
-argument-hint: "[feature-name]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
----
-
-# Thu Thập & Viết Requirements
-
-Feature: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `team.roles`, `workflow.default_depth`.
-Skill này dành cho depth: `standard` hoặc `thorough`.
-
-## Quy Trình
-
-### 1. Thu thập thông tin
-
-Hỏi (hoặc đọc từ conversation context):
-- **Business goal**: Mục tiêu kinh doanh là gì?
-- **User problems**: Người dùng đang gặp vấn đề gì?
-- **Stakeholders**: Ai bị ảnh hưởng? (end user, admin, ops)
-- **Scope**: In-scope là gì? Out-of-scope là gì?
-- **Constraints**: Deadline? Tech constraints? Budget?
-- **Success criteria**: Làm sao biết feature thành công?
-
-### 2. Phân tích & cấu trúc
-
-Tổ chức yêu cầu thành:
-- **Functional requirements**: Hệ thống PHẢI làm gì
-- **Non-functional requirements**: Performance, security, scalability
-- **User stories**: As [who], I want [what], so that [why]
-- **Acceptance criteria**: Điều kiện pass/fail
-
-### 3. Tạo Requirements Doc
-
-Ghi ra `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md`:
-
-```markdown
-# Requirements: [Feature Name]
-
-## Ngày: [date] | Author: BA | Status: Draft
-
-## Business Context
-**Goal**: [Mục tiêu kinh doanh]
-**Problem**: [Vấn đề cần giải quyết]
-**Success Metrics**: [Đo lường thành công bằng gì]
-
-## Stakeholders
-| Role | Nhu cầu | Priority |
-|------|---------|---------|
-| End User | | Must-have |
-| Admin | | |
-
-## User Stories
-
-### Epic: [Tên epic]
-
-**US-001**: Tiêu đề ngắn gọn
-- **As**: [role]
-- **I want**: [action/feature]
-- **So that**: [business value]
-- **Acceptance Criteria**:
-  - [ ] Given [context], when [action], then [result]
-  - [ ] Given [context], when [edge case], then [expected behavior]
-- **Priority**: Must-have / Should-have / Nice-to-have
-- **Estimate**: [rough size]
-
-## Functional Requirements
-| # | Requirement | Priority | Notes |
-|---|------------|---------|-------|
-
-## Non-Functional Requirements
-| # | Requirement | Metric |
-|---|------------|--------|
-| NFR-1 | Performance: page load < 2s | p95 |
-| NFR-2 | Availability: 99.9% uptime | |
-
-## Out of Scope
-- [Điều này KHÔNG bao gồm]
-
-## Open Questions
-- [ ] [Câu hỏi cần BA/PM làm rõ]
-
-## Dependencies
-- [Feature/system khác cần có trước]
-```
-
-## Sau Khi Tạo
-
-- Thông báo dev: "Requirements doc sẵn sàng tại [path]"
-- Gợi ý: "TL có thể chạy `/dw-arch-review $ARGUMENTS` để review technical feasibility"
-- Gợi ý: "Dev có thể chạy `/dw-task-init $ARGUMENTS` để bắt đầu implementation"
+---
+name: dw:requirements
+description: "BA skill: Thu thập, phân tích và viết requirements document + user stories. Dùng ở đầu feature trước khi dev bắt đầu."
+argument-hint: "[feature-name]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+---
+
+# Thu Thập & Viết Requirements
+
+Feature: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `team.roles`, `workflow.default_depth`.
+Skill này dành cho depth: `standard` hoặc `thorough`.
+
+## Quy Trình
+
+### 1. Thu thập thông tin
+
+Hỏi (hoặc đọc từ conversation context):
+- **Business goal**: Mục tiêu kinh doanh là gì?
+- **User problems**: Người dùng đang gặp vấn đề gì?
+- **Stakeholders**: Ai bị ảnh hưởng? (end user, admin, ops)
+- **Scope**: In-scope là gì? Out-of-scope là gì?
+- **Constraints**: Deadline? Tech constraints? Budget?
+- **Success criteria**: Làm sao biết feature thành công?
+
+### 2. Phân tích & cấu trúc
+
+Tổ chức yêu cầu thành:
+- **Functional requirements**: Hệ thống PHẢI làm gì
+- **Non-functional requirements**: Performance, security, scalability
+- **User stories**: As [who], I want [what], so that [why]
+- **Acceptance criteria**: Điều kiện pass/fail
+
+### 3. Tạo Requirements Doc
+
+Ghi ra `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md`:
+
+```markdown
+# Requirements: [Feature Name]
+
+## Ngày: [date] | Author: BA | Status: Draft
+
+## Business Context
+**Goal**: [Mục tiêu kinh doanh]
+**Problem**: [Vấn đề cần giải quyết]
+**Success Metrics**: [Đo lường thành công bằng gì]
+
+## Stakeholders
+| Role | Nhu cầu | Priority |
+|------|---------|---------|
+| End User | | Must-have |
+| Admin | | |
+
+## User Stories
+
+### Epic: [Tên epic]
+
+**US-001**: Tiêu đề ngắn gọn
+- **As**: [role]
+- **I want**: [action/feature]
+- **So that**: [business value]
+- **Acceptance Criteria**:
+  - [ ] Given [context], when [action], then [result]
+  - [ ] Given [context], when [edge case], then [expected behavior]
+- **Priority**: Must-have / Should-have / Nice-to-have
+- **Estimate**: [rough size]
+
+## Functional Requirements
+| # | Requirement | Priority | Notes |
+|---|------------|---------|-------|
+
+## Non-Functional Requirements
+| # | Requirement | Metric |
+|---|------------|--------|
+| NFR-1 | Performance: page load < 2s | p95 |
+| NFR-2 | Availability: 99.9% uptime | |
+
+## Out of Scope
+- [Điều này KHÔNG bao gồm]
+
+## Open Questions
+- [ ] [Câu hỏi cần BA/PM làm rõ]
+
+## Dependencies
+- [Feature/system khác cần có trước]
+```
+
+## Sau Khi Tạo
+
+- Thông báo dev: "Requirements doc sẵn sàng tại [path]"
+- Gợi ý: "TL có thể chạy `/dw:arch-review $ARGUMENTS` để review technical feasibility"
+- Gợi ý: "Dev có thể chạy `/dw:task-init $ARGUMENTS` để bắt đầu implementation"

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

@@ -1,114 +1,128 @@
----
-name: dw-research
-description: "Khảo sát và phân tích codebase trước khi lập kế hoạch. Tìm patterns, dependencies, và ảnh hưởng của thay đổi. Dùng khi cần hiểu code trước khi implement."
-argument-hint: "[task-name]"
-context: fork
-agent: researcher
-allowed-tools:
-  - Read
-  - Grep
-  - Glob
-  - "Bash(git log *)"
-  - "Bash(git diff *)"
-  - "Bash(git show *)"
-  - "Bash(git blame *)"
-  - "Bash(ls *)"
-  - "Bash(wc *)"
----
-
-# Khảo Sát Codebase
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → lấy `paths.tasks` để biết output location.
-
-## Bước 1: Đọc yêu cầu
-
-- Đọc file `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md` nếu đã có mô tả yêu cầu
-- Hoặc lấy yêu cầu từ conversation context
-
-## Bước 2: Khảo sát
-
-Thực hiện các bước sau (không cần theo thứ tự cứng):
-
-1. **Tìm files liên quan**: Dùng Glob + Grep để tìm files theo keywords từ yêu cầu
-2. **Đọc code**: Đọc các files tìm được, hiểu logic hiện tại
-3. **Trace data flow**: Theo dõi luồng dữ liệu từ input → processing → output
-4. **Xác định dependencies**:
-   - Upstream: modules/APIs mà code hiện tại gọi đến
-   - Downstream: modules/APIs gọi đến code hiện tại
-5. **Tìm patterns**: Conventions, design patterns đang dùng trong project
-6. **Kiểm tra tests**: Đã có test coverage cho khu vực liên quan?
-7. **Git history**: Xem lịch sử thay đổi gần đây của files liên quan
-
-## Bước 3: Áp dụng tư duy phản biện
-
-Từ framework `.claude/skills/dw-thinking/THINKING.md`:
-- **Giả định**: Những gì đang giả định là đúng? Cần kiểm chứng?
-- **Dependencies**: Module nào bị ảnh hưởng nếu thay đổi?
-- **Edge cases**: Trường hợp biên nào cần xem xét?
-- **Rủi ro**: Rủi ro kỹ thuật, bảo mật, performance?
-
-## Bước 4: Ghi kết quả
-
-Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md` theo cấu trúc:
-
-```markdown
-# Context: [Task Name]
-
-## Ngày khảo sát: [date]
-
-## Yêu Cầu Gốc
-[Copy yêu cầu]
-
-## Files Liên Quan
-| File | Vai trò | Cần thay đổi? | Ghi chú |
-|------|---------|----------------|---------|
-
-## Kiến Trúc Hiện Tại
-[Mô tả luồng, diagram nếu cần]
-
-## Dependencies
-**Upstream**: ...
-**Downstream**: ...
-
-## Patterns & Conventions
-- [Pattern]: [mô tả]
-
-## Giả Định & Hạn Chế
-- Giả định: ...
-- Hạn chế: ...
-- Chưa rõ: ...
-
-## Test Coverage Hiện Tại
-[Có test không? Coverage ở đâu?]
-
-## Ghi Chú
-[Bất kỳ thông tin bổ sung]
-```
-
-## Bước 5: Tạo Report (optional — standard/thorough depth)
-
-Nếu task có `.dw/tasks/$ARGUMENTS/reports/` directory (hoặc depth ≥ standard), tạo report:
-
-```
-.dw/tasks/$ARGUMENTS/reports/[YYMMDD-HHMM]-from-researcher-to-planner-findings.md
-```
-
-Dùng template `.claude/templates/agent-report.md` với:
-- `status: DONE` (hoặc `DONE_WITH_CONCERNS` nếu có risks lớn)
-- Summary: top 3 findings
-- Details: key files, patterns, dependencies
-- Next Steps: những gì planner cần biết
-
-> Quick depth tasks: bỏ qua bước này — progress.md đã đủ.
-
-## Bước 6: Tóm tắt
-
-Khi hoàn thành, trả về tóm tắt:
-- Số files khảo sát
-- Key findings (3-5 bullets)
-- Risks & unknowns
-- Gợi ý: "Tiếp theo chạy `/dw-plan $ARGUMENTS`"
+---
+name: dw:research
+description: "Khảo sát và phân tích codebase trước khi lập kế hoạch. Tìm patterns, dependencies, và ảnh hưởng của thay đổi. Dùng khi cần hiểu code trước khi implement."
+argument-hint: "[task-name]"
+context: fork
+agent: researcher
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - "Bash(git log *)"
+  - "Bash(git diff *)"
+  - "Bash(git show *)"
+  - "Bash(git blame *)"
+  - "Bash(ls *)"
+  - "Bash(wc *)"
+---
+
+# Khảo Sát Codebase
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy `paths.tasks` để biết output location.
+
+## Detect Task Format (v1 vs v2)
+
+Kiểm tra `{paths.tasks}/$ARGUMENTS/`:
+- Nếu có `spec.md` + `tracking.md` → **v2 format**. Output ghi vào spec.md section "## Research Findings".
+- Nếu có `-context.md`/`-plan.md`/`-progress.md` → **v1 format** (legacy). Output ghi vào `$ARGUMENTS-context.md` như cũ.
+- Nếu chưa có gì → gợi ý user chạy `/dw:task-init $ARGUMENTS` trước.
+
+Trong các bước dưới, "context file" = `spec.md` (v2) hoặc `$ARGUMENTS-context.md` (v1).
+
+## Bước 1: Đọc yêu cầu
+
+- **v2**: Đọc `{paths.tasks}/$ARGUMENTS/spec.md` lấy Intent + Scope.
+- **v1**: Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md` nếu đã có mô tả yêu cầu.
+- Hoặc lấy yêu cầu từ conversation context.
+
+## Bước 2: Khảo sát
+
+Thực hiện các bước sau (không cần theo thứ tự cứng):
+
+1. **Tìm files liên quan**: Dùng Glob + Grep để tìm files theo keywords từ yêu cầu
+2. **Đọc code**: Đọc các files tìm được, hiểu logic hiện tại
+3. **Trace data flow**: Theo dõi luồng dữ liệu từ input → processing → output
+4. **Xác định dependencies**:
+   - Upstream: modules/APIs mà code hiện tại gọi đến
+   - Downstream: modules/APIs gọi đến code hiện tại
+5. **Tìm patterns**: Conventions, design patterns đang dùng trong project
+6. **Kiểm tra tests**: Đã có test coverage cho khu vực liên quan?
+7. **Git history**: Xem lịch sử thay đổi gần đây của files liên quan
+
+## Bước 3: Áp dụng tư duy phản biện
+
+Từ framework `.claude/skills/dw-thinking/THINKING.md`:
+- **Giả định**: Những gì đang giả định là đúng? Cần kiểm chứng?
+- **Dependencies**: Module nào bị ảnh hưởng nếu thay đổi?
+- **Edge cases**: Trường hợp biên nào cần xem xét?
+- **Rủi ro**: Rủi ro kỹ thuật, bảo mật, performance?
+
+## Bước 4: Ghi kết quả
+
+**v2 format**: Append (hoặc replace nếu đã có) section `## Research Findings` vào `spec.md`, đặt ngay sau section `## Intent`. Giữ frontmatter và các section khác không đổi.
+
+**v1 format** (legacy): Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`.
+
+Cấu trúc nội dung (dùng chung cho cả 2 format):
+
+```markdown
+# Context: [Task Name]
+
+## Ngày khảo sát: [date]
+
+## Yêu Cầu Gốc
+[Copy yêu cầu]
+
+## Files Liên Quan
+| File | Vai trò | Cần thay đổi? | Ghi chú |
+|------|---------|----------------|---------|
+
+## Kiến Trúc Hiện Tại
+[Mô tả luồng, diagram nếu cần]
+
+## Dependencies
+**Upstream**: ...
+**Downstream**: ...
+
+## Patterns & Conventions
+- [Pattern]: [mô tả]
+
+## Giả Định & Hạn Chế
+- Giả định: ...
+- Hạn chế: ...
+- Chưa rõ: ...
+
+## Test Coverage Hiện Tại
+[Có test không? Coverage ở đâu?]
+
+## Ghi Chú
+[Bất kỳ thông tin bổ sung]
+```
+
+## Bước 5: Tạo Report (optional — standard/thorough depth)
+
+Nếu task có `.dw/tasks/$ARGUMENTS/reports/` directory (hoặc depth ≥ standard), tạo report:
+
+```
+.dw/tasks/$ARGUMENTS/reports/[YYMMDD-HHMM]-from-researcher-to-planner-findings.md
+```
+
+Dùng template `.claude/templates/agent-report.md` với:
+- `status: DONE` (hoặc `DONE_WITH_CONCERNS` nếu có risks lớn)
+- Summary: top 3 findings
+- Details: key files, patterns, dependencies
+- Next Steps: những gì planner cần biết
+
+> Quick depth tasks: bỏ qua bước này — tracking.md (v2) / progress.md (v1) đã đủ.
+
+## Bước 6: Tóm tắt
+
+Khi hoàn thành, trả về tóm tắt:
+- Số files khảo sát
+- Key findings (3-5 bullets)
+- Risks & unknowns
+- Gợi ý: "Tiếp theo chạy `/dw:plan $ARGUMENTS`"