@anionzo/skill 1.6.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/README.md +65 -19
- package/docs/design-brief.md +3 -5
- package/docs/knowledge-spec.md +1 -0
- package/i18n/README.vi.md +65 -19
- package/i18n/design-brief.vi.md +3 -5
- package/i18n/knowledge-spec.vi.md +1 -0
- package/knowledge/global/skill-triggering-rules.md +1 -1
- package/package.json +1 -1
- package/scripts/install-opencode-skills +197 -35
- package/skills/brainstorming/SKILL.md +3 -3
- package/skills/brainstorming/meta.yaml +0 -1
- package/skills/commit/meta.yaml +0 -1
- package/skills/debug/meta.yaml +1 -0
- package/skills/docs-writer/meta.yaml +2 -1
- package/skills/extract/SKILL.md +48 -8
- package/skills/extract/meta.yaml +12 -6
- package/skills/feature-delivery/SKILL.md +3 -1
- package/skills/feature-delivery/meta.yaml +2 -2
- package/skills/planning/SKILL.md +19 -1
- package/skills/planning/meta.yaml +8 -5
- package/skills/research/SKILL.md +33 -3
- package/skills/research/meta.yaml +9 -5
- package/skills/using-skills/SKILL.md +4 -6
- package/skills/using-skills/examples.md +17 -2
- package/skills/using-skills/meta.yaml +1 -3
- package/skills/verification-before-completion/meta.yaml +0 -1
- package/skills/go-pipeline/SKILL.md +0 -156
- package/skills/go-pipeline/examples.md +0 -56
- package/skills/go-pipeline/meta.yaml +0 -27
- package/skills/go-pipeline/references/output-template.md +0 -17
- package/skills/repo-onboarding/SKILL.md +0 -56
- package/skills/repo-onboarding/examples.md +0 -115
- package/skills/repo-onboarding/meta.yaml +0 -25
- package/skills/repo-onboarding/references/output-template.md +0 -24
package/skills/commit/meta.yaml
CHANGED
package/skills/debug/meta.yaml
CHANGED
package/skills/extract/SKILL.md
CHANGED
|
@@ -6,6 +6,8 @@ Extract reusable patterns, significant decisions, and failure learnings from com
|
|
|
6
6
|
|
|
7
7
|
This skill exists to turn individual task outcomes into organizational memory — not just code patterns, but also the decisions and mistakes that are expensive to repeat.
|
|
8
8
|
|
|
9
|
+
It also covers session handoff when work is not yet complete: compress the active task state into the smallest high-signal baton pass so a new session can continue without rereading everything.
|
|
10
|
+
|
|
9
11
|
## When To Use
|
|
10
12
|
|
|
11
13
|
Load this skill when:
|
|
@@ -15,16 +17,45 @@ Load this skill when:
|
|
|
15
17
|
- a decision was made that future work should know about
|
|
16
18
|
- a mistake was made that should not be repeated
|
|
17
19
|
- the user says "extract learnings", "document what we learned", or "capture this pattern"
|
|
20
|
+
- the user asks "what did we do so far?" or "summarize where we are"
|
|
21
|
+
- work is being handed to another session or agent
|
|
22
|
+
- the current session is approaching its context limit
|
|
18
23
|
|
|
19
|
-
Skip this skill when work was routine with no surprises or
|
|
24
|
+
Skip this skill when work was routine with no surprises, novel patterns, or meaningful in-progress state to carry forward.
|
|
20
25
|
|
|
21
26
|
## Workflow
|
|
22
27
|
|
|
23
|
-
1. Identify the source of
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
+
1. Identify the source of value:
|
|
29
|
+
- completed task or debugging session -> durable learning extraction
|
|
30
|
+
- unfinished task or near-full context -> session handoff
|
|
31
|
+
2. If extracting durable knowledge, analyze across three categories: patterns, decisions, and failures.
|
|
32
|
+
3. If preparing a handoff, compress the active task into: goal, done so far, current state, locked decisions, open risks, and next best action.
|
|
33
|
+
4. Check for existing documentation that should be updated (avoid duplicates).
|
|
34
|
+
5. Create or update the right artifact:
|
|
35
|
+
- durable knowledge documentation
|
|
36
|
+
- temporary handoff summary
|
|
37
|
+
6. Promote critical learnings that would save significant time if known in advance.
|
|
38
|
+
|
|
39
|
+
## Session Handoff Mode
|
|
40
|
+
|
|
41
|
+
When the task is not complete, create a high-signal baton pass for the next session.
|
|
42
|
+
|
|
43
|
+
Include:
|
|
44
|
+
|
|
45
|
+
- **Goal** — what is actively being worked on
|
|
46
|
+
- **Done So Far** — completed changes, validation, commits, and approved decisions
|
|
47
|
+
- **Current State** — what is verified, what is still in progress, and any dirty worktree notes
|
|
48
|
+
- **Locked Decisions** — decisions that should not be re-litigated unless the user reopens them
|
|
49
|
+
- **Open Questions / Risks** — blockers, uncertainty, or easy-to-miss constraints
|
|
50
|
+
- **Next Best Action** — the single clearest next step
|
|
51
|
+
- **Handoff Payload** — a compact 5-15 line summary for copy-paste into a new session
|
|
52
|
+
|
|
53
|
+
Compression rules:
|
|
54
|
+
|
|
55
|
+
- include only details that save meaningful time in the next session
|
|
56
|
+
- prefer concrete file paths, commands, commits, and verification state when relevant
|
|
57
|
+
- do not replay the whole conversation
|
|
58
|
+
- keep temporary task state separate from durable knowledge
|
|
28
59
|
|
|
29
60
|
## Three-Category Analysis
|
|
30
61
|
|
|
@@ -126,12 +157,14 @@ Present results using the Shared Output Contract:
|
|
|
126
157
|
|
|
127
158
|
1. **Goal/Result** — what knowledge was extracted, updated, or intentionally not extracted
|
|
128
159
|
2. **Key Details:**
|
|
129
|
-
- what was extracted
|
|
160
|
+
- what was extracted or handed off
|
|
161
|
+
- whether this was durable knowledge or temporary task state
|
|
130
162
|
- whether docs were created or updated
|
|
131
163
|
- whether critical learnings were promoted
|
|
132
164
|
- where the canonical knowledge now lives
|
|
133
165
|
3. **Next Action** — only when findings lead somewhere:
|
|
134
166
|
- extracted from completed task → `commit` if changes pending
|
|
167
|
+
- task is not complete but should continue later → name the primary next skill
|
|
135
168
|
- no clear handoff → stop after the result
|
|
136
169
|
|
|
137
170
|
## No-Op Case
|
|
@@ -141,6 +174,7 @@ If the work was too routine to generalize, say so explicitly and do not force a
|
|
|
141
174
|
## Red Flags
|
|
142
175
|
|
|
143
176
|
- only extracting code patterns, ignoring decisions and failures
|
|
177
|
+
- replaying the full session instead of compressing it
|
|
144
178
|
- promoting everything as critical (noise kills the learning loop)
|
|
145
179
|
- writing generic learnings like "test more carefully" (worthless)
|
|
146
180
|
- fabricating findings when the task was straightforward
|
|
@@ -150,6 +184,7 @@ If the work was too routine to generalize, say so explicitly and do not force a
|
|
|
150
184
|
## Checklist
|
|
151
185
|
|
|
152
186
|
- [ ] Three categories analyzed (patterns, decisions, failures)
|
|
187
|
+
- [ ] Or handoff state compressed (goal, done, current state, risks, next action)
|
|
153
188
|
- [ ] Existing docs checked for duplicates
|
|
154
189
|
- [ ] Knowledge is genuinely generalizable
|
|
155
190
|
- [ ] Includes concrete examples (for patterns)
|
|
@@ -158,4 +193,9 @@ If the work was too routine to generalize, say so explicitly and do not force a
|
|
|
158
193
|
|
|
159
194
|
## Done Criteria
|
|
160
195
|
|
|
161
|
-
This skill is complete when
|
|
196
|
+
This skill is complete when either:
|
|
197
|
+
|
|
198
|
+
- the three-category analysis is done and any durable findings worth preserving are documented in the appropriate location, or
|
|
199
|
+
- the in-progress task has been compressed into a clear handoff that a new session can continue from without redoing expensive analysis.
|
|
200
|
+
|
|
201
|
+
If nothing worth extracting or handing off was found, an explicit "no-op" statement is the valid completion.
|
package/skills/extract/meta.yaml
CHANGED
|
@@ -1,25 +1,31 @@
|
|
|
1
1
|
name: extract
|
|
2
|
-
version: 0.
|
|
2
|
+
version: 0.2.0
|
|
3
3
|
category: knowledge
|
|
4
|
-
summary: Extract
|
|
5
|
-
summary_vi: "
|
|
4
|
+
summary: Extract durable learnings from completed work, or compress in-progress task state into a high-signal handoff for the next session.
|
|
5
|
+
summary_vi: "Trích xuất bài học bền vững từ công việc đã xong, hoặc nén trạng thái công việc đang dở thành handoff sắc gọn cho session tiếp theo."
|
|
6
6
|
triggers:
|
|
7
7
|
- extract learnings from this task
|
|
8
8
|
- document what we learned
|
|
9
9
|
- capture this pattern
|
|
10
10
|
- what did we learn
|
|
11
|
+
- what did we do so far
|
|
12
|
+
- summarize where we are
|
|
13
|
+
- prepare a handoff
|
|
14
|
+
- context is getting full
|
|
11
15
|
inputs:
|
|
12
|
-
- completed task or feature
|
|
13
|
-
- code changes or
|
|
16
|
+
- completed task, unfinished task, or feature
|
|
17
|
+
- code changes, debugging session, or current task state
|
|
14
18
|
outputs:
|
|
15
19
|
- patterns documented
|
|
16
20
|
- decisions recorded
|
|
17
21
|
- failures captured
|
|
18
22
|
- critical learnings promoted
|
|
23
|
+
- handoff payload for the next session
|
|
19
24
|
constraints:
|
|
20
25
|
- search existing docs before creating new ones
|
|
21
26
|
- do not fabricate findings
|
|
22
|
-
- three-category analysis
|
|
27
|
+
- use three-category analysis for durable knowledge
|
|
28
|
+
- compress instead of replaying the whole session for handoffs
|
|
23
29
|
related_skills:
|
|
24
30
|
- using-skills
|
|
25
31
|
- commit
|
|
@@ -28,7 +28,7 @@ Present results using the Shared Output Contract:
|
|
|
28
28
|
- files changed
|
|
29
29
|
- verification performed
|
|
30
30
|
- follow-up or risk note
|
|
31
|
-
3. **Next Action** — `verification-before-completion` to confirm, then `code-review` or `commit`
|
|
31
|
+
3. **Next Action** — `verification-before-completion` to confirm, then `code-review` or `commit`; if pausing mid-task, use `extract` in handoff mode
|
|
32
32
|
|
|
33
33
|
## Red Flags
|
|
34
34
|
|
|
@@ -42,3 +42,5 @@ Present results using the Shared Output Contract:
|
|
|
42
42
|
This skill is complete when the feature works as intended, the change is verified with the most relevant check available, and the outcome is summarized clearly.
|
|
43
43
|
|
|
44
44
|
Before declaring done, run `verification-before-completion` to confirm the claim is backed by fresh evidence.
|
|
45
|
+
|
|
46
|
+
If the task must pause before completion, use `extract` in handoff mode so the next session can resume without repeating the implementation analysis.
|
package/skills/planning/SKILL.md
CHANGED
|
@@ -6,6 +6,8 @@ Produce an execution-ready plan before code changes begin. Each step must be con
|
|
|
6
6
|
|
|
7
7
|
This skill exists to make planning explicit, especially for multi-file or non-trivial work.
|
|
8
8
|
|
|
9
|
+
It also covers go mode when the user wants an approved spec or clear task executed end-to-end with minimal review gates.
|
|
10
|
+
|
|
9
11
|
## When To Use
|
|
10
12
|
|
|
11
13
|
Load this skill when:
|
|
@@ -15,6 +17,7 @@ Load this skill when:
|
|
|
15
17
|
- the change touches APIs, data flow, persistence, or architecture boundaries
|
|
16
18
|
- the user explicitly asks for a plan
|
|
17
19
|
- implementation risk is high enough that code should not start immediately
|
|
20
|
+
- the user says "run all", "go mode", "execute everything", or wants one continuous plan-to-commit flow
|
|
18
21
|
|
|
19
22
|
## Workflow
|
|
20
23
|
|
|
@@ -30,6 +33,20 @@ Load this skill when:
|
|
|
30
33
|
10. Present for approval.
|
|
31
34
|
11. End with the next implementation skill to invoke.
|
|
32
35
|
|
|
36
|
+
## Go Mode
|
|
37
|
+
|
|
38
|
+
When the user wants an approved spec or clear task executed with minimal review gates, planning enters go mode:
|
|
39
|
+
|
|
40
|
+
1. Validate that requirements are clear enough to implement.
|
|
41
|
+
2. Break the work into ordered implementation tasks.
|
|
42
|
+
3. Map each task to acceptance criteria or explicit outcomes.
|
|
43
|
+
4. Plan and execute each task in dependency order.
|
|
44
|
+
5. Verify after each task.
|
|
45
|
+
6. Run full verification at the end.
|
|
46
|
+
7. Prepare a single commit proposal and ask the user before committing.
|
|
47
|
+
|
|
48
|
+
If the scope is too large for one context window, checkpoint progress and resume later rather than continuing blindly.
|
|
49
|
+
|
|
33
50
|
## Bite-Sized Task Granularity
|
|
34
51
|
|
|
35
52
|
Each step should be one action, completable in 2-5 minutes:
|
|
@@ -122,6 +139,7 @@ Present results using the Shared Output Contract:
|
|
|
122
139
|
- `feature-delivery` for implementation
|
|
123
140
|
- `test-driven-development` if TDD approach preferred
|
|
124
141
|
- `brainstorming` if requirements need more definition first
|
|
142
|
+
- if the user wants one continuous execution run: continue in go mode under `planning`
|
|
125
143
|
|
|
126
144
|
## Planning Rules
|
|
127
145
|
|
|
@@ -169,4 +187,4 @@ Present results using the Shared Output Contract:
|
|
|
169
187
|
|
|
170
188
|
## Done Criteria
|
|
171
189
|
|
|
172
|
-
This skill is complete when the implementation path, risks, and verification steps are clear enough to hand off to `feature-delivery`, `refactor-safe`, or `test-driven-development
|
|
190
|
+
This skill is complete when the implementation path, risks, and verification steps are clear enough to hand off to `feature-delivery`, `refactor-safe`, or `test-driven-development` — or, in go mode, when the work has been planned, executed, verified, and brought to a commit gate. The pre-execution check and self-review must have been run with all findings addressed or explicitly surfaced.
|
|
@@ -1,16 +1,20 @@
|
|
|
1
1
|
name: planning
|
|
2
|
-
version: 0.
|
|
2
|
+
version: 0.4.0
|
|
3
3
|
category: planning
|
|
4
|
-
summary: Execution-ready plans with bite-sized steps, no placeholders, self-review,
|
|
5
|
-
summary_vi: "Plan sẵn sàng thực thi với bước nhỏ gọn, không placeholder, tự review,
|
|
4
|
+
summary: Execution-ready plans with bite-sized steps, no placeholders, self-review, pre-execution validation, and optional go-mode execution.
|
|
5
|
+
summary_vi: "Plan sẵn sàng thực thi với bước nhỏ gọn, không placeholder, tự review, kiểm tra trước thực thi, và có thể chạy theo go mode."
|
|
6
6
|
triggers:
|
|
7
7
|
- make a plan
|
|
8
8
|
- think through the implementation first
|
|
9
9
|
- prepare before coding
|
|
10
|
+
- run all
|
|
11
|
+
- go mode
|
|
12
|
+
- execute everything
|
|
10
13
|
inputs:
|
|
11
14
|
- user request
|
|
12
15
|
- relevant repo context
|
|
13
16
|
- existing patterns and constraints
|
|
17
|
+
- optional approved spec or explicit requirements
|
|
14
18
|
outputs:
|
|
15
19
|
- scope (in/out)
|
|
16
20
|
- approach
|
|
@@ -18,6 +22,7 @@ outputs:
|
|
|
18
22
|
- pre-execution check results
|
|
19
23
|
- self-review results
|
|
20
24
|
- verification plan
|
|
25
|
+
- optional go-mode task execution and commit proposal
|
|
21
26
|
constraints:
|
|
22
27
|
- keep the plan concrete and bounded
|
|
23
28
|
- separate planning from implementation
|
|
@@ -27,12 +32,10 @@ constraints:
|
|
|
27
32
|
related_skills:
|
|
28
33
|
- using-skills
|
|
29
34
|
- brainstorming
|
|
30
|
-
- repo-onboarding
|
|
31
35
|
- research
|
|
32
36
|
- debug
|
|
33
37
|
- feature-delivery
|
|
34
38
|
- refactor-safe
|
|
35
39
|
- code-review
|
|
36
40
|
- test-driven-development
|
|
37
|
-
- go-pipeline
|
|
38
41
|
- verification-before-completion
|
package/skills/research/SKILL.md
CHANGED
|
@@ -2,19 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
## Purpose
|
|
4
4
|
|
|
5
|
-
Understand existing code, patterns, and
|
|
5
|
+
Understand existing code, patterns, decisions, and repository structure before writing new code.
|
|
6
6
|
|
|
7
7
|
This skill exists to prevent implementing from scratch what already exists, and to surface constraints that would otherwise be discovered mid-implementation.
|
|
8
8
|
|
|
9
|
+
It also covers repo onboarding: mapping a repository quickly enough to act safely when the task starts from little context.
|
|
10
|
+
|
|
9
11
|
## When To Use
|
|
10
12
|
|
|
11
13
|
Load this skill when:
|
|
12
14
|
|
|
13
15
|
- exploring a codebase before starting a task
|
|
16
|
+
- entering a repo for the first time
|
|
14
17
|
- looking for existing patterns, utilities, or conventions to follow
|
|
15
18
|
- trying to understand how a feature or subsystem works
|
|
16
19
|
- the implementation approach depends on what already exists
|
|
17
20
|
- the user says "research this", "look into", or "what do we have for X"
|
|
21
|
+
- the user asks "explain this repo" or "understand this codebase before we change it"
|
|
18
22
|
|
|
19
23
|
Skip this skill when you already have clear context and the task is straightforward.
|
|
20
24
|
|
|
@@ -31,7 +35,32 @@ Skip this skill when you already have clear context and the task is straightforw
|
|
|
31
35
|
- whether it is reusable, needs adaptation, or is irrelevant
|
|
32
36
|
- any conventions or constraints it reveals
|
|
33
37
|
4. Identify gaps — what does NOT exist that the task needs.
|
|
34
|
-
5.
|
|
38
|
+
5. If this is repo onboarding, also identify:
|
|
39
|
+
- project purpose
|
|
40
|
+
- major components and responsibilities
|
|
41
|
+
- runtime model and key integrations
|
|
42
|
+
- important development commands
|
|
43
|
+
- notable conventions and open questions
|
|
44
|
+
6. Summarize findings with concrete recommendations.
|
|
45
|
+
|
|
46
|
+
## Repo Onboarding Mode
|
|
47
|
+
|
|
48
|
+
When the user is entering an unfamiliar repo, use research in repo-map mode:
|
|
49
|
+
|
|
50
|
+
1. Read the top-level operating docs first, especially `AGENTS.md` and `README.md` when present.
|
|
51
|
+
2. Inspect the most informative files next:
|
|
52
|
+
- package manifests or build files
|
|
53
|
+
- app entrypoints and framework bootstraps
|
|
54
|
+
- core config files
|
|
55
|
+
- representative tests
|
|
56
|
+
3. Summarize:
|
|
57
|
+
- project purpose
|
|
58
|
+
- architecture summary
|
|
59
|
+
- major components
|
|
60
|
+
- important commands
|
|
61
|
+
- notable conventions or constraints
|
|
62
|
+
- open questions
|
|
63
|
+
4. Recommend the next files or directories to inspect for the user's likely goal.
|
|
35
64
|
|
|
36
65
|
## Search Techniques
|
|
37
66
|
|
|
@@ -66,6 +95,7 @@ Present findings using the Shared Output Contract:
|
|
|
66
95
|
3. **Next Action** — recommend a follow-up only when findings clearly lead somewhere:
|
|
67
96
|
- research for an active task → `planning`
|
|
68
97
|
- research revealed a gap → `brainstorming`
|
|
98
|
+
- research produced enough repo context → `planning`, `docs-writer`, or direct execution
|
|
69
99
|
- no clear handoff → stop after findings
|
|
70
100
|
|
|
71
101
|
## Research Rules
|
|
@@ -97,4 +127,4 @@ Present findings using the Shared Output Contract:
|
|
|
97
127
|
|
|
98
128
|
## Done Criteria
|
|
99
129
|
|
|
100
|
-
This skill is complete when the findings are concrete enough to inform the next step — whether that is planning, implementation, or a decision that more information is needed. Every finding should include a file path or explicit "not found" statement.
|
|
130
|
+
This skill is complete when the findings are concrete enough to inform the next step — whether that is planning, implementation, docs work, or a decision that more information is needed. Every finding should include a file path or explicit "not found" statement.
|
|
@@ -1,21 +1,25 @@
|
|
|
1
1
|
name: research
|
|
2
|
-
version: 0.
|
|
2
|
+
version: 0.2.0
|
|
3
3
|
category: discovery
|
|
4
|
-
summary: Understand existing code, patterns, and decisions before
|
|
5
|
-
summary_vi: "
|
|
4
|
+
summary: Understand repository structure, existing code, patterns, and decisions before acting so new work follows what already exists.
|
|
5
|
+
summary_vi: "Tìm hiểu cấu trúc repo, code, pattern, và quyết định hiện có trước khi hành động để công việc mới đi đúng theo cái đã có."
|
|
6
6
|
triggers:
|
|
7
7
|
- research this codebase
|
|
8
8
|
- what do we already have for X
|
|
9
9
|
- look into how this works
|
|
10
10
|
- explore before implementing
|
|
11
|
+
- explain this repo
|
|
12
|
+
- onboard into a codebase
|
|
13
|
+
- understand architecture before changing code
|
|
11
14
|
inputs:
|
|
12
|
-
- topic or
|
|
15
|
+
- topic, feature, or repository area to research
|
|
13
16
|
- optional file paths or package names
|
|
14
17
|
outputs:
|
|
15
18
|
- existing implementations found
|
|
16
19
|
- patterns and conventions discovered
|
|
17
20
|
- gaps identified
|
|
18
21
|
- actionable recommendations
|
|
22
|
+
- repo map and important commands when onboarding
|
|
19
23
|
constraints:
|
|
20
24
|
- search before assuming nothing exists
|
|
21
25
|
- read actual code not just filenames
|
|
@@ -24,4 +28,4 @@ related_skills:
|
|
|
24
28
|
- planning
|
|
25
29
|
- brainstorming
|
|
26
30
|
- extract
|
|
27
|
-
-
|
|
31
|
+
- docs-writer
|
|
@@ -34,7 +34,6 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
|
|
|
34
34
|
**Available skills:**
|
|
35
35
|
|
|
36
36
|
- `an:brainstorming` — explore ideas, lock decisions, optionally write a spec
|
|
37
|
-
- `an:repo-onboarding` — understand an unfamiliar codebase
|
|
38
37
|
- `an:research` — explore existing code and patterns before implementing
|
|
39
38
|
- `an:planning` — create an execution-ready plan with bite-sized steps
|
|
40
39
|
- `an:feature-delivery` — implement a feature
|
|
@@ -46,7 +45,6 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
|
|
|
46
45
|
- `an:commit` — create a conventional commit with verification
|
|
47
46
|
- `an:docs-writer` — update documentation
|
|
48
47
|
- `an:extract` — extract patterns, decisions, and learnings from completed work
|
|
49
|
-
- `an:go-pipeline` — execute a full spec-to-commit pipeline in one run
|
|
50
48
|
|
|
51
49
|
## Workflow
|
|
52
50
|
|
|
@@ -69,20 +67,20 @@ If the user types `an:<skill-name>` (for example `an:planning` or `an:debug`), s
|
|
|
69
67
|
|
|
70
68
|
- `an:<skill-name>` (direct trigger) -> load the named skill immediately
|
|
71
69
|
- vague feature idea, unclear goal, tradeoff exploration -> `brainstorming`, then `planning`
|
|
72
|
-
- unfamiliar repo or missing context -> `
|
|
70
|
+
- unfamiliar repo or missing context -> `research`
|
|
73
71
|
- need to understand existing code before implementing -> `research`
|
|
74
72
|
- complex feature needing requirements definition -> `brainstorming` (includes spec writing)
|
|
75
|
-
- docs work in an unfamiliar repo -> `
|
|
73
|
+
- docs work in an unfamiliar repo -> `research` first, then `docs-writer`
|
|
76
74
|
- bug report, error trace, failing test, regression -> `debug`
|
|
77
75
|
- implement or change behavior -> `planning`, then `feature-delivery`
|
|
78
76
|
- implement with TDD approach -> `planning`, then `test-driven-development`
|
|
77
|
+
- execute an approved spec or clear task end-to-end with minimal gates -> `planning` in go mode
|
|
79
78
|
- refactor, restructure, extract, or migrate without behavior change -> `planning`, then `refactor-safe`
|
|
80
79
|
- review diff, PR, or changed files -> `code-review`
|
|
81
80
|
- respond to review feedback -> `code-review` (receiving mode)
|
|
82
81
|
- ready to commit -> `commit`
|
|
83
82
|
- update README, runbook, onboarding docs, API notes in a known repo -> `docs-writer`
|
|
84
|
-
- extract learnings from completed work -> `extract`
|
|
85
|
-
- execute an approved spec end-to-end -> `go-pipeline`
|
|
83
|
+
- extract learnings from completed work, or summarize active work for the next session -> `extract`
|
|
86
84
|
|
|
87
85
|
## Planning Rule
|
|
88
86
|
|
|
@@ -41,7 +41,7 @@ Help me understand this repo before we add a new API endpoint.
|
|
|
41
41
|
Expected routing:
|
|
42
42
|
|
|
43
43
|
- task type: repo understanding
|
|
44
|
-
- chosen skill: `
|
|
44
|
+
- chosen skill: `research`
|
|
45
45
|
- planning required: not yet
|
|
46
46
|
- next step: read repo docs and inspect core entrypoints
|
|
47
47
|
|
|
@@ -60,7 +60,22 @@ Expected routing:
|
|
|
60
60
|
- planning required: yes
|
|
61
61
|
- next step: refine the exact SSO scope and constraints before writing the implementation plan
|
|
62
62
|
|
|
63
|
-
## Example 5
|
|
63
|
+
## Example 5
|
|
64
|
+
|
|
65
|
+
User request:
|
|
66
|
+
|
|
67
|
+
```text
|
|
68
|
+
What did we do so far? Prepare the next session to continue this task.
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Expected routing:
|
|
72
|
+
|
|
73
|
+
- task type: extraction / handoff
|
|
74
|
+
- chosen skill: `extract`
|
|
75
|
+
- planning required: no
|
|
76
|
+
- next step: summarize the active task, completed work, locked decisions, risks, and next action
|
|
77
|
+
|
|
78
|
+
## Example 6 — Sample completed output
|
|
64
79
|
|
|
65
80
|
User request:
|
|
66
81
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
name: using-skills
|
|
2
|
-
version: 0.
|
|
2
|
+
version: 0.4.0
|
|
3
3
|
category: routing
|
|
4
4
|
summary: Route a user request to the right primary skill and working mode before deeper work begins.
|
|
5
5
|
summary_vi: "Phân loại request và chọn đúng skill chính trước khi bắt đầu công việc sâu hơn."
|
|
@@ -19,7 +19,6 @@ constraints:
|
|
|
19
19
|
- prefer one primary skill at a time
|
|
20
20
|
related_skills:
|
|
21
21
|
- brainstorming
|
|
22
|
-
- repo-onboarding
|
|
23
22
|
- research
|
|
24
23
|
- planning
|
|
25
24
|
- test-driven-development
|
|
@@ -31,4 +30,3 @@ related_skills:
|
|
|
31
30
|
- verification-before-completion
|
|
32
31
|
- docs-writer
|
|
33
32
|
- extract
|
|
34
|
-
- go-pipeline
|
|
@@ -1,156 +0,0 @@
|
|
|
1
|
-
# Go Pipeline
|
|
2
|
-
|
|
3
|
-
## Purpose
|
|
4
|
-
|
|
5
|
-
Execute a full development pipeline from an approved spec: break into tasks, plan each, implement each, verify all, and commit — in one continuous run with minimal review gates.
|
|
6
|
-
|
|
7
|
-
This skill exists for when the spec is approved and the user wants execution, not incremental review at each step.
|
|
8
|
-
|
|
9
|
-
## When To Use
|
|
10
|
-
|
|
11
|
-
Load this skill when:
|
|
12
|
-
|
|
13
|
-
- the user has an approved spec and wants to execute everything in one shot
|
|
14
|
-
- the user says "run all", "go mode", "execute everything", or "just build it"
|
|
15
|
-
- all requirements are clear and decisions are locked
|
|
16
|
-
|
|
17
|
-
## When NOT To Use
|
|
18
|
-
|
|
19
|
-
- Spec is still a draft — redirect to `brainstorming` first.
|
|
20
|
-
- User wants to review each task individually — use `planning` + `feature-delivery` per task.
|
|
21
|
-
- Spec has unresolved open questions — resolve them first.
|
|
22
|
-
- The scope is too large for one context window — use `planning` + `feature-delivery` incrementally.
|
|
23
|
-
|
|
24
|
-
## Workflow
|
|
25
|
-
|
|
26
|
-
### Phase 1: Validate Spec
|
|
27
|
-
|
|
28
|
-
Before starting, verify the spec is ready:
|
|
29
|
-
|
|
30
|
-
- [ ] Spec exists and is approved
|
|
31
|
-
- [ ] Has acceptance criteria defined
|
|
32
|
-
- [ ] No unresolved blocking questions
|
|
33
|
-
- [ ] Requirements are specific enough to implement
|
|
34
|
-
|
|
35
|
-
If any check fails, STOP and redirect:
|
|
36
|
-
> "Spec not ready. [specific issue]. Run `brainstorming` first."
|
|
37
|
-
|
|
38
|
-
### Phase 2: Generate Tasks
|
|
39
|
-
|
|
40
|
-
Parse the spec and break it into ordered implementation tasks:
|
|
41
|
-
|
|
42
|
-
- Group related requirements into logical tasks
|
|
43
|
-
- Order by dependency (foundational first, dependent last)
|
|
44
|
-
- Each task should be completable in a single implementation session
|
|
45
|
-
- Map each task to the spec acceptance criteria it fulfills
|
|
46
|
-
|
|
47
|
-
**Report:** "Created X tasks from spec. Starting implementation..."
|
|
48
|
-
|
|
49
|
-
### Phase 3: Plan + Implement Each Task
|
|
50
|
-
|
|
51
|
-
Loop through all tasks in dependency order:
|
|
52
|
-
|
|
53
|
-
For each task:
|
|
54
|
-
1. **Research context** — check related code, patterns, docs
|
|
55
|
-
2. **Draft plan** — concrete steps, files to change, tests to add
|
|
56
|
-
3. **Implement** — work through plan steps
|
|
57
|
-
4. **Verify** — run tests/lint/build after each task
|
|
58
|
-
5. **Mark complete** — note what was done
|
|
59
|
-
|
|
60
|
-
**Progress report between tasks:**
|
|
61
|
-
> "Task X/Y done: [title]. Continuing..."
|
|
62
|
-
|
|
63
|
-
### Phase 4: Full Verification
|
|
64
|
-
|
|
65
|
-
After all tasks complete:
|
|
66
|
-
|
|
67
|
-
1. Run the full test suite
|
|
68
|
-
2. Run the build
|
|
69
|
-
3. Run linting
|
|
70
|
-
4. Check acceptance criteria coverage:
|
|
71
|
-
|
|
72
|
-
```
|
|
73
|
-
Coverage Report
|
|
74
|
-
===============
|
|
75
|
-
Spec: [name]
|
|
76
|
-
Tasks: X/X complete (100%)
|
|
77
|
-
ACs: Y/Z verified
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
If coverage < 100%, identify and address gaps.
|
|
81
|
-
|
|
82
|
-
### Phase 5: Commit
|
|
83
|
-
|
|
84
|
-
Stage all changes and prepare a single conventional commit:
|
|
85
|
-
|
|
86
|
-
```
|
|
87
|
-
feat(<scope>): implement <spec-name>
|
|
88
|
-
|
|
89
|
-
- Task 1: <title>
|
|
90
|
-
- Task 2: <title>
|
|
91
|
-
- All ACs verified
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
**This is the ONE gate in go-pipeline — ask user before committing:**
|
|
95
|
-
|
|
96
|
-
> Pipeline complete. X tasks done, all verified.
|
|
97
|
-
> Ready to commit. Proceed? (yes / no / edit)
|
|
98
|
-
|
|
99
|
-
## Context Budget Management
|
|
100
|
-
|
|
101
|
-
If context exceeds approximately 60% during implementation:
|
|
102
|
-
|
|
103
|
-
1. Finish the current task
|
|
104
|
-
2. Commit completed work so far
|
|
105
|
-
3. Report progress and remaining tasks
|
|
106
|
-
4. Suggest: "Run `go-pipeline` again to continue remaining tasks."
|
|
107
|
-
|
|
108
|
-
The skill should detect already-completed tasks and skip them on re-run.
|
|
109
|
-
|
|
110
|
-
## Error Handling
|
|
111
|
-
|
|
112
|
-
- **Build/test fails during a task:** Fix the error, re-run tests. If unfixable, mark task as blocked, note why, continue to next task.
|
|
113
|
-
- **Spec has conflicting requirements:** STOP and ask user to clarify.
|
|
114
|
-
- **Task depends on blocked task:** Skip and report at the end.
|
|
115
|
-
|
|
116
|
-
## Output Format
|
|
117
|
-
|
|
118
|
-
Present results using the Shared Output Contract:
|
|
119
|
-
|
|
120
|
-
1. **Goal/Result** — what was completed across the full pipeline run
|
|
121
|
-
2. **Key Details:**
|
|
122
|
-
- total tasks created and completed
|
|
123
|
-
- any blocked or skipped tasks
|
|
124
|
-
- acceptance criteria coverage percentage
|
|
125
|
-
- build/test/lint status
|
|
126
|
-
- commit proposal
|
|
127
|
-
3. **Next Action:**
|
|
128
|
-
- if complete → commit confirmation
|
|
129
|
-
- if interrupted → how to resume
|
|
130
|
-
- if blocked → what to resolve
|
|
131
|
-
|
|
132
|
-
## Red Flags
|
|
133
|
-
|
|
134
|
-
- running on a draft or unapproved spec
|
|
135
|
-
- skipping verification between tasks
|
|
136
|
-
- not checking acceptance criteria before marking tasks done
|
|
137
|
-
- committing without user approval
|
|
138
|
-
- ignoring build/test failures
|
|
139
|
-
- not reporting progress between tasks
|
|
140
|
-
- continuing past context budget limit without checkpointing
|
|
141
|
-
- treating this as a shortcut to skip proper spec work
|
|
142
|
-
|
|
143
|
-
## Checklist
|
|
144
|
-
|
|
145
|
-
- [ ] Spec is approved
|
|
146
|
-
- [ ] Spec validated (requirements clear, ACs defined)
|
|
147
|
-
- [ ] Tasks generated with AC mapping
|
|
148
|
-
- [ ] Each task: planned, implemented, verified, completed
|
|
149
|
-
- [ ] Full verification passed (tests, build, lint)
|
|
150
|
-
- [ ] AC coverage reported
|
|
151
|
-
- [ ] User approved commit
|
|
152
|
-
- [ ] Commit created
|
|
153
|
-
|
|
154
|
-
## Done Criteria
|
|
155
|
-
|
|
156
|
-
This skill is complete when all tasks from the spec are implemented, verified, and committed with user approval — or when progress is checkpointed and the user is informed how to resume.
|