@zmice/zc 0.2.8 → 0.3.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 (84) hide show
  1. package/README.md +430 -430
  2. package/dist/cli/__tests__/platform.test.js +89 -112
  3. package/dist/cli/__tests__/platform.test.js.map +1 -1
  4. package/dist/cli/__tests__/surface.test.js +1 -1
  5. package/dist/cli/__tests__/surface.test.js.map +1 -1
  6. package/dist/cli/platform.d.ts.map +1 -1
  7. package/dist/cli/platform.js +5 -62
  8. package/dist/cli/platform.js.map +1 -1
  9. package/dist/node_modules/@zmice/platform-core/dist/index.test.js +3 -5
  10. package/dist/node_modules/@zmice/platform-core/dist/index.test.js.map +1 -1
  11. package/dist/runtime/worktree-manager.js +2 -2
  12. package/dist/runtime/worktree-manager.js.map +1 -1
  13. package/dist/utils/install-target.test.js +2 -3
  14. package/dist/utils/install-target.test.js.map +1 -1
  15. package/dist/utils/qwen-extension-cli.d.ts.map +1 -1
  16. package/dist/utils/qwen-extension-cli.js +4 -4
  17. package/dist/utils/qwen-extension-cli.js.map +1 -1
  18. package/dist/utils/qwen-extension-cli.test.js +6 -9
  19. package/dist/utils/qwen-extension-cli.test.js.map +1 -1
  20. package/dist/utils/workspace.js +1 -1
  21. package/dist/utils/workspace.js.map +1 -1
  22. package/dist/utils/workspace.test.js +0 -14
  23. package/dist/utils/workspace.test.js.map +1 -1
  24. package/package.json +5 -5
  25. package/vendor/node_modules/@zmice/platform-core/dist/index.test.js +3 -5
  26. package/vendor/node_modules/@zmice/platform-core/dist/index.test.js.map +1 -1
  27. package/vendor/packages/platform-claude/dist/index.js +75 -75
  28. package/vendor/packages/platform-claude/dist/index.test.js +8 -11
  29. package/vendor/packages/platform-claude/dist/index.test.js.map +1 -1
  30. package/vendor/packages/platform-codex/dist/index.js +194 -194
  31. package/vendor/packages/platform-codex/dist/index.test.js +13 -16
  32. package/vendor/packages/platform-codex/dist/index.test.js.map +1 -1
  33. package/vendor/packages/platform-opencode/dist/index.js +75 -75
  34. package/vendor/packages/platform-opencode/dist/index.test.js +15 -19
  35. package/vendor/packages/platform-opencode/dist/index.test.js.map +1 -1
  36. package/vendor/packages/platform-qwen/dist/index.js +75 -75
  37. package/vendor/packages/platform-qwen/dist/index.test.js +7 -9
  38. package/vendor/packages/platform-qwen/dist/index.test.js.map +1 -1
  39. package/vendor/packages/toolkit/dist/content-lint.test.js +161 -1
  40. package/vendor/packages/toolkit/dist/content-lint.test.js.map +1 -1
  41. package/vendor/packages/toolkit/dist/lint/content-lint.d.ts.map +1 -1
  42. package/vendor/packages/toolkit/dist/lint/content-lint.js +183 -2
  43. package/vendor/packages/toolkit/dist/lint/content-lint.js.map +1 -1
  44. package/vendor/packages/toolkit/dist/manifests.test.js +9 -0
  45. package/vendor/packages/toolkit/dist/manifests.test.js.map +1 -1
  46. package/vendor/packages/toolkit/src/content/agents/architect/body.md +42 -42
  47. package/vendor/packages/toolkit/src/content/agents/code-reviewer/body.md +41 -41
  48. package/vendor/packages/toolkit/src/content/agents/product-owner/body.md +40 -40
  49. package/vendor/packages/toolkit/src/content/commands/plan-review/body.md +42 -31
  50. package/vendor/packages/toolkit/src/content/commands/start/body.md +236 -197
  51. package/vendor/packages/toolkit/src/content/commands/start/meta.yaml +55 -55
  52. package/vendor/packages/toolkit/src/content/skills/branch-finish-and-cleanup/body.md +172 -172
  53. package/vendor/packages/toolkit/src/content/skills/browser-qa-testing/body.md +111 -111
  54. package/vendor/packages/toolkit/src/content/skills/ci-cd-and-automation/body.md +86 -86
  55. package/vendor/packages/toolkit/src/content/skills/code-review-and-quality/body.md +140 -140
  56. package/vendor/packages/toolkit/src/content/skills/code-simplification/body.md +80 -80
  57. package/vendor/packages/toolkit/src/content/skills/context-engineering/body.md +67 -67
  58. package/vendor/packages/toolkit/src/content/skills/continuous-learning/body.md +102 -102
  59. package/vendor/packages/toolkit/src/content/skills/documentation-and-adrs/body.md +8 -6
  60. package/vendor/packages/toolkit/src/content/skills/engineering-principles/body.md +10 -5
  61. package/vendor/packages/toolkit/src/content/skills/git-workflow-and-versioning/body.md +9 -9
  62. package/vendor/packages/toolkit/src/content/skills/multi-perspective-review/body.md +129 -81
  63. package/vendor/packages/toolkit/src/content/skills/parallel-agent-dispatch/body.md +143 -113
  64. package/vendor/packages/toolkit/src/content/skills/performance-optimization/body.md +75 -75
  65. package/vendor/packages/toolkit/src/content/skills/planning-and-task-breakdown/body.md +162 -83
  66. package/vendor/packages/toolkit/src/content/skills/sdd-tdd-workflow/body.md +130 -95
  67. package/vendor/packages/toolkit/src/content/skills/sprint-retrospective/body.md +99 -99
  68. package/vendor/packages/toolkit/src/content/skills/subagent-driven-development/body.md +49 -7
  69. package/vendor/packages/toolkit/src/content/skills/team-orchestration/body.md +133 -126
  70. package/vendor/packages/toolkit/src/content/skills/test-driven-development/body.md +78 -78
  71. package/vendor/packages/toolkit/src/content/skills/using-agent-skills/body.md +193 -193
  72. package/vendor/references/upstreams.yaml +94 -94
  73. package/dist/cli/setup.d.ts +0 -3
  74. package/dist/cli/setup.d.ts.map +0 -1
  75. package/dist/cli/setup.js +0 -41
  76. package/dist/cli/setup.js.map +0 -1
  77. package/dist/utils/codex-config-merge.d.ts +0 -3
  78. package/dist/utils/codex-config-merge.d.ts.map +0 -1
  79. package/dist/utils/codex-config-merge.js +0 -43
  80. package/dist/utils/codex-config-merge.js.map +0 -1
  81. package/dist/utils/codex-config-merge.test.d.ts +0 -2
  82. package/dist/utils/codex-config-merge.test.d.ts.map +0 -1
  83. package/dist/utils/codex-config-merge.test.js +0 -64
  84. package/dist/utils/codex-config-merge.test.js.map +0 -1
@@ -1,193 +1,193 @@
1
- # Using Agent Skills
2
-
3
- ## Overview
4
-
5
- Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
6
-
7
- ## Skill Discovery
8
-
9
- When a task arrives, identify the development phase and apply the corresponding skill:
10
-
11
- ```
12
- Task arrives
13
-
14
- ├── Vague idea/need refinement? ──→ idea-refine
15
- ├── New project/feature/change? ──→ spec-driven-development
16
- ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
17
- ├── Implementing code? ────────────→ incremental-implementation
18
- │ ├── UI work? ─────────────────→ frontend-ui-engineering
19
- │ ├── API work? ────────────────→ api-and-interface-design
20
- │ ├── Need better context? ─────→ context-engineering
21
- │ └── Need doc-verified code? ───→ source-driven-development
22
- ├── Writing/running tests? ────────→ test-driven-development
23
- │ └── Browser-based? ───────────→ browser-testing-with-devtools
24
- ├── Something broke? ──────────────→ debugging-and-error-recovery
25
- ├── Reviewing code? ───────────────→ code-review-and-quality
26
- │ ├── Security concerns? ───────→ security-and-hardening
27
- │ └── Performance concerns? ────→ performance-optimization
28
- ├── Committing/branching? ─────────→ git-workflow-and-versioning
29
- ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
30
- ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
31
- └── Deploying/launching? ─────────→ shipping-and-launch
32
- ```
33
-
34
- ## Routing Metadata and Context Loading
35
-
36
- Skill discovery depends on short metadata before the full skill is loaded. Treat each
37
- skill description as an activation contract:
38
-
39
- - It must say what capability the skill provides.
40
- - It must say when to activate it.
41
- - It should include exclusions when a nearby skill would be a better fit.
42
- - It should not summarize the entire workflow; the agent should read the full skill
43
- only after the skill is selected.
44
-
45
- Prefer on-demand skill loading over always-on context. Persistent files such as
46
- `AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, or platform rules should contain stable project
47
- conventions and canonical routing only. Do not load every skill into every session;
48
- that wastes context and makes phase-specific rules compete with each other.
49
-
50
- When a platform has native skill discovery, use its native directory or metadata model.
51
- When it does not, use agent-driven routing through the project entry file. Do not imply
52
- native plugin or slash-command behavior that the platform does not actually support.
53
-
54
- ## Core Operating Behaviors
55
-
56
- These behaviors apply at all times, across all skills. They are non-negotiable.
57
-
58
- ### 1. Surface Assumptions
59
-
60
- Before implementing anything non-trivial, explicitly state your assumptions:
61
-
62
- ```
63
- ASSUMPTIONS I'M MAKING:
64
- 1. [assumption about requirements]
65
- 2. [assumption about architecture]
66
- 3. [assumption about scope]
67
- → Correct me now or I'll proceed with these.
68
- ```
69
-
70
- Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
71
-
72
- ### 2. Manage Confusion Actively
73
-
74
- When you encounter inconsistencies, conflicting requirements, or unclear specifications:
75
-
76
- 1. **STOP.** Do not proceed with a guess.
77
- 2. Name the specific confusion.
78
- 3. Present the tradeoff or ask the clarifying question.
79
- 4. Wait for resolution before continuing.
80
-
81
- **Bad:** Silently picking one interpretation and hoping it's right.
82
- **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
83
-
84
- ### 3. Push Back When Warranted
85
-
86
- You are not a yes-machine. When an approach has clear problems:
87
-
88
- - Point out the issue directly
89
- - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
90
- - Propose an alternative
91
- - Accept the human's decision if they override with full information
92
-
93
- Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
94
-
95
- ### 4. Enforce Simplicity
96
-
97
- Your natural tendency is to overcomplicate. Actively resist it.
98
-
99
- Before finishing any implementation, ask:
100
- - Can this be done in fewer lines?
101
- - Are these abstractions earning their complexity?
102
- - Would a staff engineer look at this and say "why didn't you just..."?
103
-
104
- If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
105
-
106
- ### 5. Maintain Scope Discipline
107
-
108
- Touch only what you're asked to touch.
109
-
110
- Do NOT:
111
- - Remove comments you don't understand
112
- - "Clean up" code orthogonal to the task
113
- - Refactor adjacent systems as a side effect
114
- - Delete code that seems unused without explicit approval
115
- - Add features not in the spec because they "seem useful"
116
-
117
- Your job is surgical precision, not unsolicited renovation.
118
-
119
- ### 6. Verify, Don't Assume
120
-
121
- Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
122
-
123
- ## Failure Modes to Avoid
124
-
125
- These are the subtle errors that look like productivity but create problems:
126
-
127
- 1. Making wrong assumptions without checking
128
- 2. Not managing your own confusion — plowing ahead when lost
129
- 3. Not surfacing inconsistencies you notice
130
- 4. Not presenting tradeoffs on non-obvious decisions
131
- 5. Being sycophantic ("Of course!") to approaches with clear problems
132
- 6. Overcomplicating code and APIs
133
- 7. Modifying code or comments orthogonal to the task
134
- 8. Removing things you don't fully understand
135
- 9. Building without a spec because "it's obvious"
136
- 10. Skipping verification because "it looks right"
137
-
138
- ## Skill Rules
139
-
140
- 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
141
-
142
- 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
143
-
144
- 3. **Load only the skills needed for the current phase.** If a task moves from planning to implementation, switch skills instead of carrying the entire planning context forward.
145
-
146
- 4. **Multiple skills can apply in sequence.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `shipping-and-launch`.
147
-
148
- 5. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
149
-
150
- 6. **Ask only when it changes the route.** If the correct skill can be inferred from evidence, select it and state the assumption. Ask only for high-stakes ambiguity, conflicting goals, or missing context that would change the workflow.
151
-
152
- ## Lifecycle Sequence
153
-
154
- For a complete feature, the typical skill sequence is:
155
-
156
- ```
157
- 1. idea-refine → Refine vague ideas
158
- 2. spec-driven-development → Define what we're building
159
- 3. planning-and-task-breakdown → Break into verifiable chunks
160
- 4. context-engineering → Load the right context
161
- 5. source-driven-development → Verify against official docs
162
- 6. incremental-implementation → Build slice by slice
163
- 7. test-driven-development → Prove each slice works
164
- 8. code-review-and-quality → Review before merge
165
- 9. git-workflow-and-versioning → Clean commit history
166
- 10. documentation-and-adrs → Document decisions
167
- 11. shipping-and-launch → Deploy safely
168
- ```
169
-
170
- Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
171
-
172
- ## Quick Reference
173
-
174
- | Phase | Skill | One-Line Summary |
175
- |-------|-------|-----------------|
176
- | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
177
- | Define | spec-driven-development | Requirements and acceptance criteria before code |
178
- | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
179
- | Build | incremental-implementation | Thin vertical slices, test each before expanding |
180
- | Build | source-driven-development | Verify against official docs before implementing |
181
- | Build | context-engineering | Right context at the right time |
182
- | Build | frontend-ui-engineering | Production-quality UI with accessibility |
183
- | Build | api-and-interface-design | Stable interfaces with clear contracts |
184
- | Verify | test-driven-development | Failing test first, then make it pass |
185
- | Verify | browser-testing-with-devtools | Chrome DevTools MCP for runtime verification |
186
- | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
187
- | Review | code-review-and-quality | Five-axis review with quality gates |
188
- | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
189
- | Review | performance-optimization | Measure first, optimize only what matters |
190
- | Ship | git-workflow-and-versioning | Atomic commits, clean history |
191
- | Ship | ci-cd-and-automation | Automated quality gates on every change |
192
- | Ship | documentation-and-adrs | Document the why, not just the what |
193
- | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
1
+ # Using Agent Skills
2
+
3
+ ## Overview
4
+
5
+ Agent Skills is a collection of engineering workflow skills organized by development phase. Each skill encodes a specific process that senior engineers follow. This meta-skill helps you discover and apply the right skill for your current task.
6
+
7
+ ## Skill Discovery
8
+
9
+ When a task arrives, identify the development phase and apply the corresponding skill:
10
+
11
+ ```
12
+ Task arrives
13
+
14
+ ├── Vague idea/need refinement? ──→ idea-refine
15
+ ├── New project/feature/change? ──→ spec-driven-development
16
+ ├── Have a spec, need tasks? ──────→ planning-and-task-breakdown
17
+ ├── Implementing code? ────────────→ incremental-implementation
18
+ │ ├── UI work? ─────────────────→ frontend-ui-engineering
19
+ │ ├── API work? ────────────────→ api-and-interface-design
20
+ │ ├── Need better context? ─────→ context-engineering
21
+ │ └── Need doc-verified code? ───→ source-driven-development
22
+ ├── Writing/running tests? ────────→ test-driven-development
23
+ │ └── Browser-based? ───────────→ browser-qa-testing
24
+ ├── Something broke? ──────────────→ debugging-and-error-recovery
25
+ ├── Reviewing code? ───────────────→ code-review-and-quality
26
+ │ ├── Security concerns? ───────→ security-and-hardening
27
+ │ └── Performance concerns? ────→ performance-optimization
28
+ ├── Committing/branching? ─────────→ git-workflow-and-versioning
29
+ ├── CI/CD pipeline work? ──────────→ ci-cd-and-automation
30
+ ├── Writing docs/ADRs? ───────────→ documentation-and-adrs
31
+ └── Deploying/launching? ─────────→ shipping-and-launch
32
+ ```
33
+
34
+ ## Routing Metadata and Context Loading
35
+
36
+ Skill discovery depends on short metadata before the full skill is loaded. Treat each
37
+ skill description as an activation contract:
38
+
39
+ - It must say what capability the skill provides.
40
+ - It must say when to activate it.
41
+ - It should include exclusions when a nearby skill would be a better fit.
42
+ - It should not summarize the entire workflow; the agent should read the full skill
43
+ only after the skill is selected.
44
+
45
+ Prefer on-demand skill loading over always-on context. Persistent files such as
46
+ `AGENTS.md`, `GEMINI.md`, `CLAUDE.md`, or platform rules should contain stable project
47
+ conventions and canonical routing only. Do not load every skill into every session;
48
+ that wastes context and makes phase-specific rules compete with each other.
49
+
50
+ When a platform has native skill discovery, use its native directory or metadata model.
51
+ When it does not, use agent-driven routing through the project entry file. Do not imply
52
+ native plugin or slash-command behavior that the platform does not actually support.
53
+
54
+ ## Core Operating Behaviors
55
+
56
+ These behaviors apply at all times, across all skills. They are non-negotiable.
57
+
58
+ ### 1. Surface Assumptions
59
+
60
+ Before implementing anything non-trivial, explicitly state your assumptions:
61
+
62
+ ```
63
+ ASSUMPTIONS I'M MAKING:
64
+ 1. [assumption about requirements]
65
+ 2. [assumption about architecture]
66
+ 3. [assumption about scope]
67
+ → Correct me now or I'll proceed with these.
68
+ ```
69
+
70
+ Don't silently fill in ambiguous requirements. The most common failure mode is making wrong assumptions and running with them unchecked. Surface uncertainty early — it's cheaper than rework.
71
+
72
+ ### 2. Manage Confusion Actively
73
+
74
+ When you encounter inconsistencies, conflicting requirements, or unclear specifications:
75
+
76
+ 1. **STOP.** Do not proceed with a guess.
77
+ 2. Name the specific confusion.
78
+ 3. Present the tradeoff or ask the clarifying question.
79
+ 4. Wait for resolution before continuing.
80
+
81
+ **Bad:** Silently picking one interpretation and hoping it's right.
82
+ **Good:** "I see X in the spec but Y in the existing code. Which takes precedence?"
83
+
84
+ ### 3. Push Back When Warranted
85
+
86
+ You are not a yes-machine. When an approach has clear problems:
87
+
88
+ - Point out the issue directly
89
+ - Explain the concrete downside (quantify when possible — "this adds ~200ms latency" not "this might be slower")
90
+ - Propose an alternative
91
+ - Accept the human's decision if they override with full information
92
+
93
+ Sycophancy is a failure mode. "Of course!" followed by implementing a bad idea helps no one. Honest technical disagreement is more valuable than false agreement.
94
+
95
+ ### 4. Enforce Simplicity
96
+
97
+ Your natural tendency is to overcomplicate. Actively resist it.
98
+
99
+ Before finishing any implementation, ask:
100
+ - Can this be done in fewer lines?
101
+ - Are these abstractions earning their complexity?
102
+ - Would a staff engineer look at this and say "why didn't you just..."?
103
+
104
+ If you build 1000 lines and 100 would suffice, you have failed. Prefer the boring, obvious solution. Cleverness is expensive.
105
+
106
+ ### 5. Maintain Scope Discipline
107
+
108
+ Touch only what you're asked to touch.
109
+
110
+ Do NOT:
111
+ - Remove comments you don't understand
112
+ - "Clean up" code orthogonal to the task
113
+ - Refactor adjacent systems as a side effect
114
+ - Delete code that seems unused without explicit approval
115
+ - Add features not in the spec because they "seem useful"
116
+
117
+ Your job is surgical precision, not unsolicited renovation.
118
+
119
+ ### 6. Verify, Don't Assume
120
+
121
+ Every skill includes a verification step. A task is not complete until verification passes. "Seems right" is never sufficient — there must be evidence (passing tests, build output, runtime data).
122
+
123
+ ## Failure Modes to Avoid
124
+
125
+ These are the subtle errors that look like productivity but create problems:
126
+
127
+ 1. Making wrong assumptions without checking
128
+ 2. Not managing your own confusion — plowing ahead when lost
129
+ 3. Not surfacing inconsistencies you notice
130
+ 4. Not presenting tradeoffs on non-obvious decisions
131
+ 5. Being sycophantic ("Of course!") to approaches with clear problems
132
+ 6. Overcomplicating code and APIs
133
+ 7. Modifying code or comments orthogonal to the task
134
+ 8. Removing things you don't fully understand
135
+ 9. Building without a spec because "it's obvious"
136
+ 10. Skipping verification because "it looks right"
137
+
138
+ ## Skill Rules
139
+
140
+ 1. **Check for an applicable skill before starting work.** Skills encode processes that prevent common mistakes.
141
+
142
+ 2. **Skills are workflows, not suggestions.** Follow the steps in order. Don't skip verification steps.
143
+
144
+ 3. **Load only the skills needed for the current phase.** If a task moves from planning to implementation, switch skills instead of carrying the entire planning context forward.
145
+
146
+ 4. **Multiple skills can apply in sequence.** A feature implementation might involve `idea-refine` → `spec-driven-development` → `planning-and-task-breakdown` → `incremental-implementation` → `test-driven-development` → `code-review-and-quality` → `shipping-and-launch`.
147
+
148
+ 5. **When in doubt, start with a spec.** If the task is non-trivial and there's no spec, begin with `spec-driven-development`.
149
+
150
+ 6. **Ask only when it changes the route.** If the correct skill can be inferred from evidence, select it and state the assumption. Ask only for high-stakes ambiguity, conflicting goals, or missing context that would change the workflow.
151
+
152
+ ## Lifecycle Sequence
153
+
154
+ For a complete feature, the typical skill sequence is:
155
+
156
+ ```
157
+ 1. idea-refine → Refine vague ideas
158
+ 2. spec-driven-development → Define what we're building
159
+ 3. planning-and-task-breakdown → Break into verifiable chunks
160
+ 4. context-engineering → Load the right context
161
+ 5. source-driven-development → Verify against official docs
162
+ 6. incremental-implementation → Build slice by slice
163
+ 7. test-driven-development → Prove each slice works
164
+ 8. code-review-and-quality → Review before merge
165
+ 9. git-workflow-and-versioning → Clean commit history
166
+ 10. documentation-and-adrs → Document decisions
167
+ 11. shipping-and-launch → Deploy safely
168
+ ```
169
+
170
+ Not every task needs every skill. A bug fix might only need: `debugging-and-error-recovery` → `test-driven-development` → `code-review-and-quality`.
171
+
172
+ ## Quick Reference
173
+
174
+ | Phase | Skill | One-Line Summary |
175
+ |-------|-------|-----------------|
176
+ | Define | idea-refine | Refine ideas through structured divergent and convergent thinking |
177
+ | Define | spec-driven-development | Requirements and acceptance criteria before code |
178
+ | Plan | planning-and-task-breakdown | Decompose into small, verifiable tasks |
179
+ | Build | incremental-implementation | Thin vertical slices, test each before expanding |
180
+ | Build | source-driven-development | Verify against official docs before implementing |
181
+ | Build | context-engineering | Right context at the right time |
182
+ | Build | frontend-ui-engineering | Production-quality UI with accessibility |
183
+ | Build | api-and-interface-design | Stable interfaces with clear contracts |
184
+ | Verify | test-driven-development | Failing test first, then make it pass |
185
+ | Verify | browser-qa-testing | Real-browser runtime verification for user-facing flows |
186
+ | Verify | debugging-and-error-recovery | Reproduce → localize → fix → guard |
187
+ | Review | code-review-and-quality | Five-axis review with quality gates |
188
+ | Review | security-and-hardening | OWASP prevention, input validation, least privilege |
189
+ | Review | performance-optimization | Measure first, optimize only what matters |
190
+ | Ship | git-workflow-and-versioning | Atomic commits, clean history |
191
+ | Ship | ci-cd-and-automation | Automated quality gates on every change |
192
+ | Ship | documentation-and-adrs | Document the why, not just the what |
193
+ | Ship | shipping-and-launch | Pre-launch checklist, monitoring, rollback plan |
@@ -1,94 +1,94 @@
1
- schema_version: 1
2
-
3
- governance:
4
- manual_review_required: true
5
- notes_root: references/notes
6
- snapshots_root: references/snapshots
7
- snapshot_policy: immutable
8
-
9
- upstreams:
10
- - id: agent-skills
11
- title: Agent Skills
12
- kind: github-public-repo
13
- status: active
14
- owner: codex
15
- source_url: https://github.com/addyosmani/agent-skills.git
16
- source_paths:
17
- - skills
18
- - commands
19
- notes_path: references/notes/agent-skills.md
20
- snapshots_path: references/snapshots/agent-skills/
21
- sync:
22
- mode: manual-review
23
- review_required: true
24
- compare_against: snapshots
25
- publish_target: toolkit-and-platform-generation
26
- - id: superpowers
27
- title: Superpowers
28
- kind: github-public-repo
29
- status: active
30
- owner: codex
31
- source_url: https://github.com/obra/superpowers.git
32
- source_paths:
33
- - prompts
34
- - instructions
35
- - agents
36
- notes_path: references/notes/superpowers.md
37
- snapshots_path: references/snapshots/superpowers/
38
- sync:
39
- mode: manual-review
40
- review_required: true
41
- compare_against: snapshots
42
- publish_target: toolkit-and-platform-generation
43
- - id: everything-claude-code
44
- title: Everything Claude Code
45
- kind: github-public-repo
46
- status: active
47
- owner: codex
48
- source_url: https://github.com/affaan-m/everything-claude-code.git
49
- source_paths:
50
- - CLAUDE.md
51
- - docs
52
- - commands
53
- notes_path: references/notes/everything-claude-code.md
54
- snapshots_path: references/snapshots/everything-claude-code/
55
- sync:
56
- mode: manual-review
57
- review_required: true
58
- compare_against: snapshots
59
- publish_target: toolkit-and-platform-generation
60
- - id: gstack
61
- title: GStack
62
- kind: github-public-repo
63
- status: active
64
- owner: codex
65
- source_url: https://github.com/garrytan/gstack.git
66
- source_paths:
67
- - prompts
68
- - commands
69
- - docs
70
- notes_path: references/notes/gstack.md
71
- snapshots_path: references/snapshots/gstack/
72
- sync:
73
- mode: manual-review
74
- review_required: true
75
- compare_against: snapshots
76
- publish_target: toolkit-and-platform-generation
77
- - id: andrej-karpathy-skills
78
- title: Andrej Karpathy Skills
79
- kind: github-public-repo
80
- status: active
81
- owner: codex
82
- source_url: https://github.com/multica-ai/andrej-karpathy-skills.git
83
- source_paths:
84
- - CLAUDE.md
85
- - README.md
86
- - EXAMPLES.md
87
- - skills/karpathy-guidelines
88
- notes_path: references/notes/andrej-karpathy-skills.md
89
- snapshots_path: references/snapshots/andrej-karpathy-skills/
90
- sync:
91
- mode: manual-review
92
- review_required: true
93
- compare_against: snapshots
94
- publish_target: toolkit-and-platform-generation
1
+ schema_version: 1
2
+
3
+ governance:
4
+ manual_review_required: true
5
+ notes_root: references/notes
6
+ snapshots_root: references/snapshots
7
+ snapshot_policy: immutable
8
+
9
+ upstreams:
10
+ - id: agent-skills
11
+ title: Agent Skills
12
+ kind: github-public-repo
13
+ status: active
14
+ owner: codex
15
+ source_url: https://github.com/addyosmani/agent-skills.git
16
+ source_paths:
17
+ - skills
18
+ - commands
19
+ notes_path: references/notes/agent-skills.md
20
+ snapshots_path: references/snapshots/agent-skills/
21
+ sync:
22
+ mode: manual-review
23
+ review_required: true
24
+ compare_against: snapshots
25
+ publish_target: toolkit-and-platform-generation
26
+ - id: superpowers
27
+ title: Superpowers
28
+ kind: github-public-repo
29
+ status: active
30
+ owner: codex
31
+ source_url: https://github.com/obra/superpowers.git
32
+ source_paths:
33
+ - prompts
34
+ - instructions
35
+ - agents
36
+ notes_path: references/notes/superpowers.md
37
+ snapshots_path: references/snapshots/superpowers/
38
+ sync:
39
+ mode: manual-review
40
+ review_required: true
41
+ compare_against: snapshots
42
+ publish_target: toolkit-and-platform-generation
43
+ - id: everything-claude-code
44
+ title: Everything Claude Code
45
+ kind: github-public-repo
46
+ status: active
47
+ owner: codex
48
+ source_url: https://github.com/affaan-m/everything-claude-code.git
49
+ source_paths:
50
+ - CLAUDE.md
51
+ - docs
52
+ - commands
53
+ notes_path: references/notes/everything-claude-code.md
54
+ snapshots_path: references/snapshots/everything-claude-code/
55
+ sync:
56
+ mode: manual-review
57
+ review_required: true
58
+ compare_against: snapshots
59
+ publish_target: toolkit-and-platform-generation
60
+ - id: gstack
61
+ title: GStack
62
+ kind: github-public-repo
63
+ status: active
64
+ owner: codex
65
+ source_url: https://github.com/garrytan/gstack.git
66
+ source_paths:
67
+ - prompts
68
+ - commands
69
+ - docs
70
+ notes_path: references/notes/gstack.md
71
+ snapshots_path: references/snapshots/gstack/
72
+ sync:
73
+ mode: manual-review
74
+ review_required: true
75
+ compare_against: snapshots
76
+ publish_target: toolkit-and-platform-generation
77
+ - id: andrej-karpathy-skills
78
+ title: Andrej Karpathy Skills
79
+ kind: github-public-repo
80
+ status: active
81
+ owner: codex
82
+ source_url: https://github.com/multica-ai/andrej-karpathy-skills.git
83
+ source_paths:
84
+ - CLAUDE.md
85
+ - README.md
86
+ - EXAMPLES.md
87
+ - skills/karpathy-guidelines
88
+ notes_path: references/notes/andrej-karpathy-skills.md
89
+ snapshots_path: references/snapshots/andrej-karpathy-skills/
90
+ sync:
91
+ mode: manual-review
92
+ review_required: true
93
+ compare_against: snapshots
94
+ publish_target: toolkit-and-platform-generation
@@ -1,3 +0,0 @@
1
- import type { Command } from "commander";
2
- export declare function registerSetupCommand(program: Command): void;
3
- //# sourceMappingURL=setup.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C3D"}
package/dist/cli/setup.js DELETED
@@ -1,41 +0,0 @@
1
- import { discoverSkills, discoverCommands, discoverAgents, } from "../utils/skill-loader.js";
2
- export function registerSetupCommand(program) {
3
- program
4
- .command("setup")
5
- .description("扫描并验证 toolkit 资产")
6
- .option("-r, --root <dir>", "项目根目录")
7
- .action(async (opts) => {
8
- console.log("\n🔍 正在扫描项目资产...\n");
9
- const [skills, commands, agents] = await Promise.all([
10
- discoverSkills(opts.root),
11
- discoverCommands(opts.root),
12
- discoverAgents(opts.root),
13
- ]);
14
- // Skills
15
- console.log(`📦 技能:${skills.length} 个`);
16
- for (const s of skills) {
17
- console.log(` ✅ ${s.name}`);
18
- }
19
- // Commands
20
- console.log(`\n📋 命令:${commands.length} 个`);
21
- for (const c of commands) {
22
- console.log(` ✅ ${c.name}`);
23
- }
24
- // Agents
25
- console.log(`\n🤖 代理:${agents.length} 个`);
26
- for (const a of agents) {
27
- console.log(` ✅ ${a.name}`);
28
- }
29
- // Summary
30
- const total = skills.length + commands.length + agents.length;
31
- console.log(`\n📊 总计:${total} 个资产`);
32
- if (total === 0) {
33
- console.log("\n⚠️ 未发现任何资产,请检查目录结构是否正确");
34
- console.log(" 期望结构:packages/toolkit/src/content/<kind>/<name>/{meta.yaml,body.md,assets/}");
35
- }
36
- else {
37
- console.log("\n✅ 目录结构验证通过");
38
- }
39
- });
40
- }
41
- //# sourceMappingURL=setup.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kBAAkB,CAAC;SAC/B,MAAM,CAAC,kBAAkB,EAAE,OAAO,CAAC;SACnC,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAElC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YACzB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAC;QAEH,SAAS;QACT,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,WAAW;QACX,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,SAAS;QACT,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,UAAU;QACV,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC;QAEpC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;QAChG,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -1,3 +0,0 @@
1
- export declare function isCodexAgentConfigContent(content: string): boolean;
2
- export declare function mergeCodexAgentConfig(existingContent: string | undefined, generatedContent: string): string;
3
- //# sourceMappingURL=codex-config-merge.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"codex-config-merge.d.ts","sourceRoot":"","sources":["../../src/utils/codex-config-merge.ts"],"names":[],"mappings":"AAoCA,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAa3G"}