@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.
- package/CONTRIBUTING.md +2 -1
- package/README.md +82 -24
- package/docs/design-brief.md +17 -13
- package/docs/knowledge-spec.md +1 -0
- package/i18n/CONTRIBUTING.vi.md +2 -1
- package/i18n/README.vi.md +82 -24
- package/i18n/design-brief.vi.md +17 -13
- package/i18n/knowledge-spec.vi.md +1 -0
- package/knowledge/global/skill-triggering-rules.md +3 -2
- package/package.json +1 -1
- package/scripts/install-opencode-skills +197 -35
- package/skills/brainstorming/SKILL.md +176 -13
- package/skills/brainstorming/meta.yaml +18 -10
- package/skills/code-review/SKILL.md +214 -19
- package/skills/code-review/meta.yaml +21 -9
- package/skills/commit/SKILL.md +187 -0
- package/skills/commit/examples.md +62 -0
- package/skills/commit/meta.yaml +29 -0
- package/skills/commit/references/output-template.md +14 -0
- package/skills/debug/SKILL.md +252 -0
- package/skills/debug/examples.md +83 -0
- package/skills/debug/meta.yaml +39 -0
- package/skills/debug/references/output-template.md +16 -0
- package/skills/docs-writer/SKILL.md +85 -10
- package/skills/docs-writer/meta.yaml +18 -13
- package/skills/extract/SKILL.md +201 -0
- package/skills/extract/examples.md +47 -0
- package/skills/extract/meta.yaml +33 -0
- package/skills/extract/references/output-template.md +24 -0
- package/skills/feature-delivery/SKILL.md +12 -5
- package/skills/feature-delivery/meta.yaml +6 -1
- package/skills/planning/SKILL.md +146 -17
- package/skills/planning/meta.yaml +19 -7
- package/skills/refactor-safe/SKILL.md +10 -7
- package/skills/research/SKILL.md +130 -0
- package/skills/research/examples.md +79 -0
- package/skills/research/meta.yaml +31 -0
- package/skills/research/references/output-template.md +23 -0
- package/skills/test-driven-development/SKILL.md +194 -0
- package/skills/test-driven-development/examples.md +77 -0
- package/skills/test-driven-development/meta.yaml +31 -0
- package/skills/test-driven-development/references/.gitkeep +0 -0
- package/skills/test-driven-development/references/output-template.md +31 -0
- package/skills/using-skills/SKILL.md +33 -17
- package/skills/using-skills/examples.md +20 -5
- package/skills/using-skills/meta.yaml +7 -4
- package/skills/verification-before-completion/SKILL.md +127 -13
- package/skills/verification-before-completion/meta.yaml +23 -14
- package/templates/SKILL.md +8 -1
- package/skills/bug-triage/SKILL.md +0 -47
- package/skills/bug-triage/examples.md +0 -68
- package/skills/bug-triage/meta.yaml +0 -25
- package/skills/bug-triage/references/output-template.md +0 -26
- package/skills/repo-onboarding/SKILL.md +0 -52
- package/skills/repo-onboarding/examples.md +0 -115
- package/skills/repo-onboarding/meta.yaml +0 -23
- 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`, `
|
|
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/)
|
|
8
8
|
[](knowledge/)
|
|
9
9
|
[](adapters/)
|
|
10
10
|
[](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` |
|
|
55
|
-
|
|
|
56
|
-
| 📐 | `planning` |
|
|
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
|
-
|
|
|
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` |
|
|
61
|
-
| 🔍 | `code-review` |
|
|
62
|
-
| 📝 | `
|
|
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 │────▶│
|
|
69
|
-
│ (router) │ │ (if vague) │ │
|
|
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- │ │
|
|
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.
|
|
110
|
-
|
|
160
|
+
# 1. Read the design and authoring docs
|
|
161
|
+
less docs/design-brief.md
|
|
162
|
+
less docs/authoring-guide.md
|
|
111
163
|
|
|
112
|
-
# 2.
|
|
164
|
+
# 2. Adjust global knowledge if you want different defaults
|
|
113
165
|
vim knowledge/global/engineering-principles.md
|
|
114
166
|
|
|
115
|
-
# 3.
|
|
116
|
-
|
|
167
|
+
# 3. Edit skills, docs, or adapters
|
|
168
|
+
vim skills/using-skills/SKILL.md
|
|
117
169
|
|
|
118
|
-
# 4. Validate
|
|
170
|
+
# 4. Validate the library structure
|
|
119
171
|
bash scripts/validate-skills
|
|
120
172
|
|
|
121
|
-
# 5.
|
|
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
|
package/docs/design-brief.md
CHANGED
|
@@ -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
|
-
### 🎯
|
|
77
|
-
|
|
78
|
-
The
|
|
79
|
-
|
|
80
|
-
- 🧭 Routing requests
|
|
81
|
-
- 💡 Refining
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
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
|
|
package/docs/knowledge-spec.md
CHANGED
package/i18n/CONTRIBUTING.vi.md
CHANGED
|
@@ -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`, `
|
|
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/)
|
|
8
8
|
[](../knowledge/)
|
|
9
9
|
[](../adapters/)
|
|
10
10
|
[](../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` |
|
|
55
|
-
|
|
|
56
|
-
| 📐 | `planning` |
|
|
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
|
-
|
|
|
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` |
|
|
61
|
-
| 🔍 | `code-review` |
|
|
62
|
-
| 📝 | `
|
|
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 và 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 │────▶│
|
|
69
|
-
│ (router) │ │ (nếu mơ hồ) │ │ (nếu
|
|
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- │ │
|
|
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.
|
|
108
|
-
|
|
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.
|
|
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.
|
|
114
|
-
|
|
165
|
+
# 3. Sửa skill, docs, hoặc adapters
|
|
166
|
+
vim skills/using-skills/SKILL.md
|
|
115
167
|
|
|
116
|
-
# 4. Validate
|
|
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
|
package/i18n/design-brief.vi.md
CHANGED
|
@@ -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
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
- 🧭 Phân loại request
|
|
81
|
-
- 💡 Làm rõ
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
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 và 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 có 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
|
|
|
@@ -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 `
|
|
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 `
|
|
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