@anionzo/skill 1.4.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CONTRIBUTING.md +2 -1
  2. package/README.md +82 -24
  3. package/docs/design-brief.md +17 -13
  4. package/docs/knowledge-spec.md +1 -0
  5. package/i18n/CONTRIBUTING.vi.md +2 -1
  6. package/i18n/README.vi.md +82 -24
  7. package/i18n/design-brief.vi.md +17 -13
  8. package/i18n/knowledge-spec.vi.md +1 -0
  9. package/knowledge/global/skill-triggering-rules.md +3 -2
  10. package/package.json +1 -1
  11. package/scripts/install-opencode-skills +197 -35
  12. package/skills/brainstorming/SKILL.md +176 -13
  13. package/skills/brainstorming/meta.yaml +18 -10
  14. package/skills/code-review/SKILL.md +214 -19
  15. package/skills/code-review/meta.yaml +21 -9
  16. package/skills/commit/SKILL.md +187 -0
  17. package/skills/commit/examples.md +62 -0
  18. package/skills/commit/meta.yaml +29 -0
  19. package/skills/commit/references/output-template.md +14 -0
  20. package/skills/debug/SKILL.md +252 -0
  21. package/skills/debug/examples.md +83 -0
  22. package/skills/debug/meta.yaml +39 -0
  23. package/skills/debug/references/output-template.md +16 -0
  24. package/skills/docs-writer/SKILL.md +85 -10
  25. package/skills/docs-writer/meta.yaml +18 -13
  26. package/skills/extract/SKILL.md +201 -0
  27. package/skills/extract/examples.md +47 -0
  28. package/skills/extract/meta.yaml +33 -0
  29. package/skills/extract/references/output-template.md +24 -0
  30. package/skills/feature-delivery/SKILL.md +12 -5
  31. package/skills/feature-delivery/meta.yaml +6 -1
  32. package/skills/planning/SKILL.md +146 -17
  33. package/skills/planning/meta.yaml +19 -7
  34. package/skills/refactor-safe/SKILL.md +10 -7
  35. package/skills/research/SKILL.md +130 -0
  36. package/skills/research/examples.md +79 -0
  37. package/skills/research/meta.yaml +31 -0
  38. package/skills/research/references/output-template.md +23 -0
  39. package/skills/test-driven-development/SKILL.md +194 -0
  40. package/skills/test-driven-development/examples.md +77 -0
  41. package/skills/test-driven-development/meta.yaml +31 -0
  42. package/skills/test-driven-development/references/.gitkeep +0 -0
  43. package/skills/test-driven-development/references/output-template.md +31 -0
  44. package/skills/using-skills/SKILL.md +33 -17
  45. package/skills/using-skills/examples.md +20 -5
  46. package/skills/using-skills/meta.yaml +7 -4
  47. package/skills/verification-before-completion/SKILL.md +127 -13
  48. package/skills/verification-before-completion/meta.yaml +23 -14
  49. package/templates/SKILL.md +8 -1
  50. package/skills/bug-triage/SKILL.md +0 -47
  51. package/skills/bug-triage/examples.md +0 -68
  52. package/skills/bug-triage/meta.yaml +0 -25
  53. package/skills/bug-triage/references/output-template.md +0 -26
  54. package/skills/repo-onboarding/SKILL.md +0 -52
  55. package/skills/repo-onboarding/examples.md +0 -115
  56. package/skills/repo-onboarding/meta.yaml +0 -23
  57. package/skills/repo-onboarding/references/output-template.md +0 -24
package/CONTRIBUTING.md CHANGED
@@ -79,7 +79,7 @@ cp -r templates/ skills/<your-skill-name>/
79
79
  |---|---|---|
80
80
  | `name` | ✅ | Skill identifier (kebab-case) |
81
81
  | `version` | ✅ | Semantic version (`1.0.0`) |
82
- | `category` | ✅ | One of: `routing`, `discovery`, `planning`, `implementation`, `debugging`, `review`, `documentation`, `verification` |
82
+ | `category` | ✅ | One of: `routing`, `discovery`, `planning`, `implementation`, `troubleshooting`, `review`, `documentation`, `quality`, `knowledge`, `workflow` |
83
83
  | `summary` | ✅ | One-line English description |
84
84
  | `summary_vi` | 🟡 | One-line Vietnamese description |
85
85
  | `triggers` | 🟡 | When to activate this skill |
@@ -161,6 +161,7 @@ Knowledge files live in `knowledge/global/`. They contain principles, heuristics
161
161
  | 🔍 `review-heuristics.md` | Code review rules |
162
162
  | 🐛 `debugging-patterns.md` | Systematic debugging approaches |
163
163
  | 🧠 `skill-triggering-rules.md` | When to load which skill |
164
+ | 📋 `evidence-before-claims.md` | Evidence requirements before completion claims |
164
165
 
165
166
  When adding or editing knowledge:
166
167
 
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  **A vendor-neutral, multi-agent skill library for AI-powered software engineering**
6
6
 
7
- [![Skills](https://img.shields.io/badge/skills-10-blue?style=flat-square&logo=bookstack)](skills/)
7
+ [![Skills](https://img.shields.io/badge/skills-13-blue?style=flat-square&logo=bookstack)](skills/)
8
8
  [![Knowledge](https://img.shields.io/badge/knowledge-5_files-green?style=flat-square&logo=readme)](knowledge/)
9
9
  [![Platforms](https://img.shields.io/badge/platforms-5_agents-purple?style=flat-square&logo=robot-framework)](adapters/)
10
10
  [![License](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
@@ -23,6 +23,8 @@
23
23
 
24
24
  This repo is intentionally lighter than a full workflow product. It borrows the **workflow-first** mindset from `hoangnb24/skills`, the **plan-first** behavior from modern coding agents like OpenCode, and the **multi-platform** approach from `knowns-dev/knowns` — then turns them into a practical personal library.
25
25
 
26
+ The current library is intentionally consolidated: it keeps **13 higher-signal skills** instead of splitting every adjacent workflow into separate names. Overlapping flows such as repo onboarding, session handoff, and end-to-end go mode are folded into stronger core skills (`research`, `extract`, and `planning`) to reduce routing noise.
27
+
26
28
  ### 🏗️ Design Goals
27
29
 
28
30
  | | Goal |
@@ -48,39 +50,47 @@ This repo is intentionally lighter than a full workflow product. It borrows the
48
50
 
49
51
  ### 🎯 Skill Catalog
50
52
 
53
+ This catalog is intentionally compact: each skill should own a clearly distinct job, and nearby workflows are merged unless the risk profile or working mode is meaningfully different.
54
+
51
55
  | | Skill | Purpose |
52
56
  |---|---|---|
53
57
  | 🧭 | `using-skills` | Route a request to the right skill and working mode |
54
- | 💡 | `brainstorming` | Refine rough ideas into a concrete direction before planning |
55
- | 🗺️ | `repo-onboarding` | Understand an unfamiliar codebase before acting |
56
- | 📐 | `planning` | Turn a request into an execution-ready plan |
58
+ | 💡 | `brainstorming` | Explore ideas, lock decisions, optionally write a spec |
59
+ | 🔎 | `research` | Explore existing code and patterns before implementing |
60
+ | 📐 | `planning` | Execution-ready plans, plus optional go-mode execution for approved work |
57
61
  | 🚀 | `feature-delivery` | Implement a feature with minimal, repo-aligned change |
58
- | 🐛 | `bug-triage` | Investigate errors, regressions, and unclear failures |
62
+ | 🧪 | `test-driven-development` | Enforce test-first discipline with red-green-refactor |
63
+ | 🐛 | `debug` | 4-phase systematic debugging with root cause investigation |
59
64
  | ♻️ | `refactor-safe` | Restructure code without changing behavior |
60
- | ✅ | `verification-before-completion` | Require fresh evidence before claiming done |
61
- | 🔍 | `code-review` | Review diffs bugs, regressions, test gaps first |
62
- | 📝 | `docs-writer` | Update docs from verified source behavior |
65
+ | ✅ | `verification-before-completion` | Iron law: no completion claims without fresh evidence |
66
+ | 🔍 | `code-review` | Give and receive code reviews with severity triage |
67
+ | 📝 | `commit` | Create conventional commits with staged change review |
68
+ | 📖 | `docs-writer` | Update docs from verified source behavior |
69
+ | 🧬 | `extract` | Extract durable learnings or compress active work into a handoff |
63
70
 
64
71
  ### 🔄 Default Workflow
65
72
 
66
73
  ```
67
74
  ┌─────────────┐ ┌───────────────┐ ┌─────────────────┐
68
- │ using-skills │────▶│ brainstorming │────▶│ repo-onboarding
69
- │ (router) │ │ (if vague) │ │ (if new repo)
70
- └──────┬───────┘ └───────┬───────┘ └────────┬────────┘
71
- │ │
72
- │ ▼
73
- │ ┌──────────┐
74
- └─────────────▶│ planning │◀─────────────────┘
75
+ │ using-skills │────▶│ brainstorming │────▶│ research
76
+ │ (router) │ │ (if vague) │ │ (if needed)
77
+ └──────┬───────┘ └───────┬───────┘ └──────┬──────┘
78
+ │ │
79
+ │ ▼
80
+ │ ┌──────────┐
81
+ └─────────────▶│ planning │◀────────────────┘
75
82
  └────┬─────┘
76
83
 
77
84
  ┌────────────┼────────────┐
78
85
  ▼ ▼ ▼
79
86
  ┌────────────┐ ┌───────────┐ ┌──────────────┐
80
- │ feature- │ │ bug-triage│ │ refactor-safe│
87
+ │ feature- │ │ debug │ │ refactor-safe│
81
88
  │ delivery │ │ │ │ │
82
89
  └─────┬──────┘ └─────┬─────┘ └──────┬───────┘
83
90
  │ │ │
91
+ │ ┌──────┴──────┐ │
92
+ │ │ TDD │ │
93
+ │ └──────┬──────┘ │
84
94
  ▼ ▼ ▼
85
95
  ┌─────────────────────────────────────────┐
86
96
  │ verification-before-completion │
@@ -88,7 +98,15 @@ This repo is intentionally lighter than a full workflow product. It borrows the
88
98
 
89
99
  ┌─────────────┐
90
100
  │ code-review │
91
- └─────────────┘
101
+ └──────┬──────┘
102
+
103
+ ┌──────────┐
104
+ │ commit │
105
+ └────┬─────┘
106
+
107
+ ┌──────────┐
108
+ │ extract │
109
+ └──────────┘
92
110
  ```
93
111
 
94
112
  ### 📖 Research Highlights
@@ -105,23 +123,63 @@ This scaffold distills patterns from strong public repos:
105
123
 
106
124
  ### 🚀 Quick Start
107
125
 
126
+ #### Use the library
127
+
128
+ If you just want to use the skill library in your agent:
129
+
130
+ ```bash
131
+ # 1. Install the library into your current project or workspace
132
+ npx @anionzo/skill
133
+
134
+ # 2. Open your agent in the target repo
135
+ # Then start with the router skill
136
+ an:using-skills
137
+
138
+ # 3. Ask naturally, for example:
139
+ # "Help me understand this repo"
140
+ # "Plan this feature first"
141
+ # "Review these changes"
142
+ ```
143
+
144
+ The router will pick the right primary skill and next step.
145
+
146
+ Installer behavior:
147
+
148
+ - `npx @anionzo/skill` opens an interactive terminal picker
149
+ - use **arrow keys** to move
150
+ - press **space** to select one or more platforms
151
+ - press **enter** to install the selected platforms
152
+ - you can also choose whether to update `.gitignore` with the installed agent files
153
+ - `npm install @anionzo/skill` still runs in silent postinstall mode and installs the default skill directories automatically
154
+
155
+ #### Edit or extend the library
156
+
157
+ If you want to customize this repository itself:
158
+
108
159
  ```bash
109
- # 1. Understand the repo shape
110
- cat docs/design-brief.md
160
+ # 1. Read the design and authoring docs
161
+ less docs/design-brief.md
162
+ less docs/authoring-guide.md
111
163
 
112
- # 2. Customize knowledge to your preferences
164
+ # 2. Adjust global knowledge if you want different defaults
113
165
  vim knowledge/global/engineering-principles.md
114
166
 
115
- # 3. Start working the router picks the right skill
116
- cat skills/using-skills/SKILL.md
167
+ # 3. Edit skills, docs, or adapters
168
+ vim skills/using-skills/SKILL.md
117
169
 
118
- # 4. Validate your skills
170
+ # 4. Validate the library structure
119
171
  bash scripts/validate-skills
120
172
 
121
- # 5. Generate platform files
173
+ # 5. Regenerate platform files after skill/knowledge changes
122
174
  bash scripts/sync-platform-files
123
175
  ```
124
176
 
177
+ Notes:
178
+
179
+ - `bash scripts/validate-skills` checks required files, metadata keys, and basic library consistency.
180
+ - `bash scripts/sync-platform-files` regenerates the files in `generated/` for each target agent.
181
+ - You only need to run sync when skills, knowledge, adapters, or summaries change.
182
+
125
183
  ### 📦 Install via npm
126
184
 
127
185
  > Available on [npm](https://www.npmjs.com/package/@anionzo/skill) — no authentication required
@@ -73,19 +73,23 @@ A personal operating library with three layers:
73
73
  5. ⚙️ The first version uses simple shell scripts instead of introducing a build system
74
74
  6. ✅ Planning and verification are explicit phases for code-changing work
75
75
 
76
- ### 🎯 Initial Scope
77
-
78
- The first version focuses on the work patterns most likely to pay off immediately:
79
-
80
- - 🧭 Routing requests
81
- - 💡 Refining rough requests into a workable direction
82
- - 🗺️ Onboarding into repos
83
- - 🐛 Triaging bugs
84
- - 📐 Planning implementation work before code edits
85
- - 🚀 Delivering features
86
- - Verifying outcomes before claiming completion
87
- - 🔍 Reviewing code
88
- - 📝 Updating docs
76
+ ### 🎯 Current Scope
77
+
78
+ The library has expanded beyond the original v1 scope. The current skill set covers 13 repeatable work patterns:
79
+
80
+ - 🧭 Routing requests with `using-skills`
81
+ - 💡 Refining ideas and writing specs with `brainstorming`
82
+ - 🔎 Researching existing code and patterns with `research`
83
+ - 📐 Planning implementation work before code edits, or running approved work in go mode, with `planning`
84
+ - 🚀 Delivering features with `feature-delivery`
85
+ - 🧪 Implementing with test-first discipline through `test-driven-development`
86
+ - 🐛 Systematically debugging failures with `debug`
87
+ - ♻️ Refactoring safely with `refactor-safe`
88
+ - Verifying outcomes before claiming completion with `verification-before-completion`
89
+ - 🔍 Giving and receiving code reviews with `code-review`
90
+ - 📝 Creating intentional commits with `commit`
91
+ - 📖 Updating docs with `docs-writer`
92
+ - 🧬 Extracting reusable learnings or handing work off between sessions with `extract`
89
93
 
90
94
  ### 🔮 Next Steps
91
95
 
@@ -43,6 +43,7 @@ Use for session-scoped or temporary notes:
43
43
  - 🧪 Active hypotheses
44
44
  - ⏳ Temporary decisions
45
45
  - 📌 Follow-ups to promote later
46
+ - 🪄 Session handoff summaries for unfinished work
46
47
 
47
48
  > ⚡ This layer changes **often** and can be cleaned up aggressively.
48
49
 
@@ -79,7 +79,7 @@ cp -r templates/ skills/<ten-skill>/
79
79
  |---|---|---|
80
80
  | `name` | ✅ | Định danh skill (kebab-case) |
81
81
  | `version` | ✅ | Phiên bản semantic (`1.0.0`) |
82
- | `category` | ✅ | Một trong: `routing`, `discovery`, `planning`, `implementation`, `debugging`, `review`, `documentation`, `verification` |
82
+ | `category` | ✅ | Một trong: `routing`, `discovery`, `planning`, `implementation`, `troubleshooting`, `review`, `documentation`, `quality`, `knowledge`, `workflow` |
83
83
  | `summary` | ✅ | Mô tả một dòng bằng tiếng Anh |
84
84
  | `summary_vi` | 🟡 | Mô tả một dòng bằng tiếng Việt |
85
85
  | `triggers` | 🟡 | Khi nào kích hoạt skill |
@@ -161,6 +161,7 @@ File knowledge nằm trong `knowledge/global/`. Chúng chứa nguyên tắc, heu
161
161
  | 🔍 `review-heuristics.md` | Quy tắc code review |
162
162
  | 🐛 `debugging-patterns.md` | Phương pháp debug có hệ thống |
163
163
  | 🧠 `skill-triggering-rules.md` | Khi nào load skill nào |
164
+ | 📋 `evidence-before-claims.md` | Yêu cầu bằng chứng trước tuyên bố hoàn thành |
164
165
 
165
166
  Khi thêm hoặc sửa knowledge:
166
167
 
package/i18n/README.vi.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  **Thư viện skill đa agent, vendor-neutral cho kỹ thuật phần mềm hỗ trợ AI**
6
6
 
7
- [![Skills](https://img.shields.io/badge/skills-10-blue?style=flat-square&logo=bookstack)](../skills/)
7
+ [![Skills](https://img.shields.io/badge/skills-13-blue?style=flat-square&logo=bookstack)](../skills/)
8
8
  [![Knowledge](https://img.shields.io/badge/knowledge-5_files-green?style=flat-square&logo=readme)](../knowledge/)
9
9
  [![Platforms](https://img.shields.io/badge/platforms-5_agents-purple?style=flat-square&logo=robot-framework)](../adapters/)
10
10
  [![License](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](../LICENSE)
@@ -23,6 +23,8 @@
23
23
 
24
24
  Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy **workflow-first** từ `hoangnb24/skills`, hành vi **plan-first** từ các coding agent hiện đại như OpenCode, và tư duy **multi-platform** từ `knowns-dev/knowns` — rồi biến chúng thành thư viện cá nhân thực dụng.
25
25
 
26
+ Thư viện hiện tại được cô đọng có chủ đích: giữ **13 skill sắc nét hơn** thay vì tách mỗi workflow gần nhau thành một tên riêng. Các luồng bị chồng lắp như onboarding repo, handoff giữa session, và go mode end-to-end đã được nhập vào các skill lõi mạnh hơn (`research`, `extract`, và `planning`) để giảm nhiễu khi route.
27
+
26
28
  ### 🏗️ Mục Tiêu Thiết Kế
27
29
 
28
30
  | | Mục tiêu |
@@ -48,39 +50,47 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
48
50
 
49
51
  ### 🎯 Danh Mục Skill
50
52
 
53
+ Catalog này được giữ gọn có chủ đích: mỗi skill nên sở hữu một nhiệm vụ thật sự khác biệt, còn các workflow gần nhau sẽ được gộp lại trừ khi mức rủi ro hoặc cách làm việc khác nhau rõ rệt.
54
+
51
55
  | | Skill | Mục đích |
52
56
  |---|---|---|
53
57
  | 🧭 | `using-skills` | Phân loại request và chọn đúng skill |
54
- | 💡 | `brainstorming` | Làm ý tưởng hồ trước khi lập plan |
55
- | 🗺️ | `repo-onboarding` | Hiểu codebase lạ trước khi hành động |
56
- | 📐 | `planning` | Biến request thành plan thực thi trước khi code |
58
+ | 💡 | `brainstorming` | Khám phá ý tưởng, khóa quyết định, viết spec nếu cần |
59
+ | 🔎 | `research` | Tìm hiểu code và pattern có sẵn trước khi implement |
60
+ | 📐 | `planning` | Plan thực thi, kèm go mode cho công việc đã rõ và đã duyệt |
57
61
  | 🚀 | `feature-delivery` | Triển khai feature với thay đổi tối thiểu, phù hợp repo |
58
- | 🐛 | `bug-triage` | Điều tra lỗi, regression, failure chưa nguyên nhân |
62
+ | 🧪 | `test-driven-development` | Kỷ luật test-first với chu trình red-green-refactor |
63
+ | 🐛 | `debug` | Gỡ lỗi hệ thống 4 giai đoạn với điều tra nguyên nhân gốc |
59
64
  | ♻️ | `refactor-safe` | Tái cấu trúc code mà không thay đổi hành vi |
60
- | ✅ | `verification-before-completion` | Yêu cầu bằng chứng trước khi tuyên bố xong |
61
- | 🔍 | `code-review` | Review diff ưu tiên bug, regression, test gap |
62
- | 📝 | `docs-writer` | Cập nhật docs từ hành vi thực tế đã xác minh |
65
+ | ✅ | `verification-before-completion` | Luật sắt: không tuyên bố xong mà không có bằng chứng mới |
66
+ | 🔍 | `code-review` | Cho nhận code review với phân loại mức độ |
67
+ | 📝 | `commit` | Tạo commit conventional với review thay đổi staged |
68
+ | 📖 | `docs-writer` | Cập nhật docs từ hành vi thực tế đã xác minh |
69
+ | 🧬 | `extract` | Trích xuất bài học bền vững hoặc cô đọng công việc đang dở thành handoff |
63
70
 
64
71
  ### 🔄 Workflow Mặc Định
65
72
 
66
73
  ```
67
74
  ┌─────────────┐ ┌───────────────┐ ┌─────────────────┐
68
- │ using-skills │────▶│ brainstorming │────▶│ repo-onboarding
69
- │ (router) │ │ (nếu mơ hồ) │ │ (nếu repo lạ) │
70
- └──────┬───────┘ └───────┬───────┘ └────────┬────────┘
71
- │ │
72
- │ ▼
73
- │ ┌──────────┐
74
- └─────────────▶│ planning │◀─────────────────┘
75
+ │ using-skills │────▶│ brainstorming │────▶│ research
76
+ │ (router) │ │ (nếu mơ hồ) │ │ (nếu cần) │
77
+ └──────┬───────┘ └───────┬───────┘ └──────┬──────┘
78
+ │ │
79
+ │ ▼
80
+ │ ┌──────────┐
81
+ └─────────────▶│ planning │◀────────────────┘
75
82
  └────┬─────┘
76
83
 
77
84
  ┌────────────┼────────────┐
78
85
  ▼ ▼ ▼
79
86
  ┌────────────┐ ┌───────────┐ ┌──────────────┐
80
- │ feature- │ │ bug-triage│ │ refactor-safe│
87
+ │ feature- │ │ debug │ │ refactor-safe│
81
88
  │ delivery │ │ │ │ │
82
89
  └─────┬──────┘ └─────┬─────┘ └──────┬───────┘
83
90
  │ │ │
91
+ │ ┌──────┴──────┐ │
92
+ │ │ TDD │ │
93
+ │ └──────┬──────┘ │
84
94
  ▼ ▼ ▼
85
95
  ┌─────────────────────────────────────────┐
86
96
  │ verification-before-completion │
@@ -88,7 +98,15 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
88
98
 
89
99
  ┌─────────────┐
90
100
  │ code-review │
91
- └─────────────┘
101
+ └──────┬──────┘
102
+
103
+ ┌──────────┐
104
+ │ commit │
105
+ └────┬─────┘
106
+
107
+ ┌──────────┐
108
+ │ extract │
109
+ └──────────┘
92
110
  ```
93
111
 
94
112
  ### 📖 Nghiên Cứu Tham Khảo
@@ -103,23 +121,63 @@ Repo này nhẹ hơn một sản phẩm workflow đầy đủ. Nó lấy tư duy
103
121
 
104
122
  ### 🚀 Bắt Đầu Nhanh
105
123
 
124
+ #### Dùng thư viện
125
+
126
+ Nếu bạn chỉ muốn dùng skill library trong agent của mình:
127
+
128
+ ```bash
129
+ # 1. Cài thư viện vào project hoặc workspace hiện tại
130
+ npx @anionzo/skill
131
+
132
+ # 2. Mở agent trong repo đích
133
+ # Sau đó bắt đầu bằng router skill
134
+ an:using-skills
135
+
136
+ # 3. Hỏi tự nhiên, ví dụ:
137
+ # "Help me understand this repo"
138
+ # "Plan this feature first"
139
+ # "Review these changes"
140
+ ```
141
+
142
+ Router sẽ chọn đúng skill chính và bước tiếp theo.
143
+
144
+ Hành vi của installer:
145
+
146
+ - `npx @anionzo/skill` sẽ mở terminal picker tương tác
147
+ - dùng **phím mũi tên** để di chuyển
148
+ - nhấn **space** để chọn một hoặc nhiều platform
149
+ - nhấn **enter** để cài các platform đã chọn
150
+ - bạn cũng có thể chọn cập nhật `.gitignore` cho các file agent vừa cài
151
+ - `npm install @anionzo/skill` vẫn chạy theo postinstall silent mode và tự cài các thư mục skill mặc định
152
+
153
+ #### Sửa hoặc mở rộng thư viện
154
+
155
+ Nếu bạn muốn tùy biến chính repo này:
156
+
106
157
  ```bash
107
- # 1. Hiểu hình dạng repo
108
- cat docs/design-brief.md
158
+ # 1. Đọc tài liệu thiết kế và quy tắc viết
159
+ less docs/design-brief.md
160
+ less docs/authoring-guide.md
109
161
 
110
- # 2. Tùy chỉnh knowledge theo phong cách của bạn
162
+ # 2. Chỉnh knowledge global nếu muốn đổi default behavior
111
163
  vim knowledge/global/engineering-principles.md
112
164
 
113
- # 3. Bắt đầu router sẽ chọn đúng skill
114
- cat skills/using-skills/SKILL.md
165
+ # 3. Sửa skill, docs, hoặc adapters
166
+ vim skills/using-skills/SKILL.md
115
167
 
116
- # 4. Validate các skill
168
+ # 4. Validate cấu trúc thư viện
117
169
  bash scripts/validate-skills
118
170
 
119
- # 5. Sinh platform file
171
+ # 5. Sinh lại platform file sau khi đổi skill/knowledge
120
172
  bash scripts/sync-platform-files
121
173
  ```
122
174
 
175
+ Ghi chú:
176
+
177
+ - `bash scripts/validate-skills` kiểm tra file bắt buộc, key metadata, và tính nhất quán cơ bản của thư viện.
178
+ - `bash scripts/sync-platform-files` sinh lại các file trong `generated/` cho từng agent đích.
179
+ - Chỉ cần chạy sync khi skill, knowledge, adapter, hoặc summary thay đổi.
180
+
123
181
  ### 📦 Cài Đặt Qua npm
124
182
 
125
183
  > Có sẵn trên [npm](https://www.npmjs.com/package/@anionzo/skill) — không cần xác thực
@@ -73,19 +73,23 @@ Thư viện vận hành cá nhân với ba lớp:
73
73
  5. ⚙️ Phiên bản đầu dùng shell script đơn giản thay vì build system
74
74
  6. ✅ Planning và verification là các pha rõ ràng cho công việc thay đổi code
75
75
 
76
- ### 🎯 Phạm Vi Ban Đầu
77
-
78
- Phiên bản đầu tập trung vào các pattern giá trị ngay:
79
-
80
- - 🧭 Phân loại request
81
- - 💡 Làm rõ request hồ thành hướng đi cụ thể
82
- - 🗺️ Onboard vào repo
83
- - 🐛 Triage bug
84
- - 📐 Lập plan trước khi code
85
- - 🚀 Triển khai feature
86
- - Xác minh kết quả trước khi tuyên bố hoàn thành
87
- - 🔍 Review code
88
- - 📝 Cập nhật docs
76
+ ### 🎯 Phạm Vi Hiện Tại
77
+
78
+ Thư viện đã mở rộng vượt quá phạm vi v1 ban đầu. Bộ skill hiện tại bao phủ 13 pattern công việc lặp lại:
79
+
80
+ - 🧭 Phân loại request với `using-skills`
81
+ - 💡 Làm rõ ý tưởng viết spec với `brainstorming`
82
+ - 🔎 Nghiên cứu code và pattern có sẵn với `research`
83
+ - 📐 Lập plan trước khi code, hoặc chạy theo go mode khi công việc đã rõ, với `planning`
84
+ - 🚀 Triển khai feature với `feature-delivery`
85
+ - 🧪 Implement theo test-first với `test-driven-development`
86
+ - 🐛 Gỡ lỗi hệ thống với `debug`
87
+ - ♻️ Refactor an toàn với `refactor-safe`
88
+ - Xác minh kết quả trước khi tuyên bố hoàn thành với `verification-before-completion`
89
+ - 🔍 Cho và nhận code review với `code-review`
90
+ - 📝 Tạo commit có chủ đích với `commit`
91
+ - 📖 Cập nhật tài liệu với `docs-writer`
92
+ - 🧬 Trích xuất bài học tái sử dụng hoặc handoff công việc giữa các session với `extract`
89
93
 
90
94
  ### 🔮 Bước Tiếp Theo
91
95
 
@@ -43,6 +43,7 @@ Dùng cho ghi chú tạm thời trong session:
43
43
  - 🧪 Giả thuyết đang active
44
44
  - ⏳ Quyết định tạm thời
45
45
  - 📌 Follow-up cần promote sau
46
+ - 🪄 Tóm tắt handoff cho công việc chưa hoàn thành
46
47
 
47
48
  > ⚡ Lớp này thay đổi **thường xuyên** và có thể dọn dẹp mạnh tay.
48
49
 
@@ -10,10 +10,11 @@ These notes keep the library behavior consistent across agents and sessions.
10
10
  - Use `brainstorming` when the request is still fuzzy and the user is really asking for a clarified direction.
11
11
  - Use `planning` before code changes for multi-file, ambiguous, or higher-risk work.
12
12
  - Use `feature-delivery` only after the implementation path is concrete enough to execute.
13
- - Use `bug-triage` before fixing an issue whose cause is not yet grounded.
13
+ - Use `debug` before fixing an issue whose cause is not yet grounded.
14
+ - Use `test-driven-development` when implementing with TDD discipline (red-green-refactor).
14
15
  - Use `verification-before-completion` before any strong success claim.
15
16
  - Use `code-review` for review requests and post-implementation risk checks.
16
- - Use `repo-onboarding` when entering an unfamiliar codebase before productive work can begin.
17
+ - Use `research` when entering an unfamiliar codebase before productive work can begin.
17
18
  - Use `docs-writer` for documentation tasks in a repo whose structure is already understood.
18
19
  - Use `refactor-safe` for restructuring, extracting, or migrating code without intended behavior change.
19
20
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@anionzo/skill",
3
- "version": "1.4.0",
3
+ "version": "1.7.0",
4
4
  "description": "Personal AI Skill Library — vendor-neutral, multi-agent skill library for AI-powered software engineering",
5
5
  "bin": {
6
6
  "anionzo-skill": "scripts/install-opencode-skills"