@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.
- package/README.md +430 -430
- package/dist/cli/__tests__/platform.test.js +89 -112
- package/dist/cli/__tests__/platform.test.js.map +1 -1
- package/dist/cli/__tests__/surface.test.js +1 -1
- package/dist/cli/__tests__/surface.test.js.map +1 -1
- package/dist/cli/platform.d.ts.map +1 -1
- package/dist/cli/platform.js +5 -62
- package/dist/cli/platform.js.map +1 -1
- package/dist/node_modules/@zmice/platform-core/dist/index.test.js +3 -5
- package/dist/node_modules/@zmice/platform-core/dist/index.test.js.map +1 -1
- package/dist/runtime/worktree-manager.js +2 -2
- package/dist/runtime/worktree-manager.js.map +1 -1
- package/dist/utils/install-target.test.js +2 -3
- package/dist/utils/install-target.test.js.map +1 -1
- package/dist/utils/qwen-extension-cli.d.ts.map +1 -1
- package/dist/utils/qwen-extension-cli.js +4 -4
- package/dist/utils/qwen-extension-cli.js.map +1 -1
- package/dist/utils/qwen-extension-cli.test.js +6 -9
- package/dist/utils/qwen-extension-cli.test.js.map +1 -1
- package/dist/utils/workspace.js +1 -1
- package/dist/utils/workspace.js.map +1 -1
- package/dist/utils/workspace.test.js +0 -14
- package/dist/utils/workspace.test.js.map +1 -1
- package/package.json +5 -5
- package/vendor/node_modules/@zmice/platform-core/dist/index.test.js +3 -5
- package/vendor/node_modules/@zmice/platform-core/dist/index.test.js.map +1 -1
- package/vendor/packages/platform-claude/dist/index.js +75 -75
- package/vendor/packages/platform-claude/dist/index.test.js +8 -11
- package/vendor/packages/platform-claude/dist/index.test.js.map +1 -1
- package/vendor/packages/platform-codex/dist/index.js +194 -194
- package/vendor/packages/platform-codex/dist/index.test.js +13 -16
- package/vendor/packages/platform-codex/dist/index.test.js.map +1 -1
- package/vendor/packages/platform-opencode/dist/index.js +75 -75
- package/vendor/packages/platform-opencode/dist/index.test.js +15 -19
- package/vendor/packages/platform-opencode/dist/index.test.js.map +1 -1
- package/vendor/packages/platform-qwen/dist/index.js +75 -75
- package/vendor/packages/platform-qwen/dist/index.test.js +7 -9
- package/vendor/packages/platform-qwen/dist/index.test.js.map +1 -1
- package/vendor/packages/toolkit/dist/content-lint.test.js +161 -1
- package/vendor/packages/toolkit/dist/content-lint.test.js.map +1 -1
- package/vendor/packages/toolkit/dist/lint/content-lint.d.ts.map +1 -1
- package/vendor/packages/toolkit/dist/lint/content-lint.js +183 -2
- package/vendor/packages/toolkit/dist/lint/content-lint.js.map +1 -1
- package/vendor/packages/toolkit/dist/manifests.test.js +9 -0
- package/vendor/packages/toolkit/dist/manifests.test.js.map +1 -1
- package/vendor/packages/toolkit/src/content/agents/architect/body.md +42 -42
- package/vendor/packages/toolkit/src/content/agents/code-reviewer/body.md +41 -41
- package/vendor/packages/toolkit/src/content/agents/product-owner/body.md +40 -40
- package/vendor/packages/toolkit/src/content/commands/plan-review/body.md +42 -31
- package/vendor/packages/toolkit/src/content/commands/start/body.md +236 -197
- package/vendor/packages/toolkit/src/content/commands/start/meta.yaml +55 -55
- package/vendor/packages/toolkit/src/content/skills/branch-finish-and-cleanup/body.md +172 -172
- package/vendor/packages/toolkit/src/content/skills/browser-qa-testing/body.md +111 -111
- package/vendor/packages/toolkit/src/content/skills/ci-cd-and-automation/body.md +86 -86
- package/vendor/packages/toolkit/src/content/skills/code-review-and-quality/body.md +140 -140
- package/vendor/packages/toolkit/src/content/skills/code-simplification/body.md +80 -80
- package/vendor/packages/toolkit/src/content/skills/context-engineering/body.md +67 -67
- package/vendor/packages/toolkit/src/content/skills/continuous-learning/body.md +102 -102
- package/vendor/packages/toolkit/src/content/skills/documentation-and-adrs/body.md +8 -6
- package/vendor/packages/toolkit/src/content/skills/engineering-principles/body.md +10 -5
- package/vendor/packages/toolkit/src/content/skills/git-workflow-and-versioning/body.md +9 -9
- package/vendor/packages/toolkit/src/content/skills/multi-perspective-review/body.md +129 -81
- package/vendor/packages/toolkit/src/content/skills/parallel-agent-dispatch/body.md +143 -113
- package/vendor/packages/toolkit/src/content/skills/performance-optimization/body.md +75 -75
- package/vendor/packages/toolkit/src/content/skills/planning-and-task-breakdown/body.md +162 -83
- package/vendor/packages/toolkit/src/content/skills/sdd-tdd-workflow/body.md +130 -95
- package/vendor/packages/toolkit/src/content/skills/sprint-retrospective/body.md +99 -99
- package/vendor/packages/toolkit/src/content/skills/subagent-driven-development/body.md +49 -7
- package/vendor/packages/toolkit/src/content/skills/team-orchestration/body.md +133 -126
- package/vendor/packages/toolkit/src/content/skills/test-driven-development/body.md +78 -78
- package/vendor/packages/toolkit/src/content/skills/using-agent-skills/body.md +193 -193
- package/vendor/references/upstreams.yaml +94 -94
- package/dist/cli/setup.d.ts +0 -3
- package/dist/cli/setup.d.ts.map +0 -1
- package/dist/cli/setup.js +0 -41
- package/dist/cli/setup.js.map +0 -1
- package/dist/utils/codex-config-merge.d.ts +0 -3
- package/dist/utils/codex-config-merge.d.ts.map +0 -1
- package/dist/utils/codex-config-merge.js +0 -43
- package/dist/utils/codex-config-merge.js.map +0 -1
- package/dist/utils/codex-config-merge.test.d.ts +0 -2
- package/dist/utils/codex-config-merge.test.d.ts.map +0 -1
- package/dist/utils/codex-config-merge.test.js +0 -64
- package/dist/utils/codex-config-merge.test.js.map +0 -1
|
@@ -86,144 +86,144 @@ function renderAgentsFile(manifestSource, assets, layout) {
|
|
|
86
86
|
const commandCount = assets.filter((asset) => asset.kind === "command").length;
|
|
87
87
|
const skillCount = assets.filter((asset) => asset.kind === "skill").length;
|
|
88
88
|
const agentCount = assets.filter((asset) => asset.kind === "agent").length;
|
|
89
|
-
return `# Codex 工作流入口
|
|
90
|
-
|
|
91
|
-
这是安装到 Codex 的薄入口文件。
|
|
92
|
-
|
|
93
|
-
它负责三件事:
|
|
94
|
-
|
|
95
|
-
1. 给出统一任务开始方式
|
|
96
|
-
2. 说明固定 workflow 的选路规则
|
|
97
|
-
3. 把 \`zc:*\` 命令语义映射成 Codex 实际可调用的 \`$zc-*\` skill
|
|
98
|
-
|
|
99
|
-
详细方法不写在这里,完整内容都在 \`${layout.displaySkillsDir}/zc-*/SKILL.md\`。
|
|
100
|
-
角色化 custom agents 位于 \`${layout.displayAgentsDir}/zc-*.toml\`。
|
|
101
|
-
Codex agent role 注册位于 \`${layout.displayConfigFile}\` 的 \`[agents.*]\` 配置。
|
|
102
|
-
其中:
|
|
103
|
-
|
|
104
|
-
- \`$zc-start\`、\`$zc-spec\`、\`$zc-build\` 这类是 command-alias skill
|
|
105
|
-
- \`$zc-sdd-tdd-workflow\`、\`$zc-debugging-and-error-recovery\` 这类是专题/流程 skill
|
|
106
|
-
- \`zc_*\` 这类是 Codex custom agent,只在显式要求多 agent / 指定 agent 时使用
|
|
107
|
-
|
|
108
|
-
## 核心规则
|
|
109
|
-
|
|
110
|
-
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
111
|
-
- Codex 侧没有 \`zc:start\` 这类原生命令,请把它们理解为统一语义入口
|
|
112
|
-
- 在 Codex 中,统一命令语义通过 \`$zc-*\` skill 来承接
|
|
113
|
-
- 中文优先,技术契约保持原样
|
|
114
|
-
- 证据先于断言,完成前必须验证
|
|
115
|
-
- 不做超出任务边界的顺手修改
|
|
116
|
-
|
|
117
|
-
## 统一命令语义到 Codex skill 的映射
|
|
118
|
-
|
|
119
|
-
- \`zc:start\` -> \`$zc-start\`
|
|
120
|
-
- \`zc:product-analysis\` -> \`$zc-product-analysis\`
|
|
121
|
-
- \`zc:sdd-tdd\` -> \`$zc-sdd-tdd\`
|
|
122
|
-
- \`zc:spec\` -> \`$zc-spec\`
|
|
123
|
-
- \`zc:task-plan\` -> \`$zc-task-plan\`
|
|
124
|
-
- \`zc:build\` -> \`$zc-build\`
|
|
125
|
-
- \`zc:quality-review\` -> \`$zc-quality-review\`
|
|
126
|
-
- \`zc:verify\` -> \`$zc-verify\`
|
|
127
|
-
- \`zc:debug\` -> \`$zc-debug\`
|
|
128
|
-
- \`zc:doc\` -> \`$zc-doc\`
|
|
129
|
-
- \`zc:ship\` -> \`$zc-ship\`
|
|
130
|
-
- \`zc:onboard\` -> \`$zc-onboard\`
|
|
131
|
-
- \`zc:ctx-health\` -> \`$zc-ctx-health\`
|
|
132
|
-
|
|
133
|
-
## 固定 workflow
|
|
134
|
-
|
|
135
|
-
### 1. product-analysis
|
|
136
|
-
|
|
137
|
-
适用:
|
|
138
|
-
- 需求还模糊
|
|
139
|
-
- 需要先把目标、范围和验收标准收敛清楚
|
|
140
|
-
|
|
141
|
-
默认 skill:
|
|
142
|
-
- \`$zc-product-analysis\`
|
|
143
|
-
- 需要更深的设计或规格时,再接 \`$zc-brainstorming-and-design\` / \`$zc-spec-driven-development\`
|
|
144
|
-
|
|
145
|
-
### 2. full-delivery
|
|
146
|
-
|
|
147
|
-
适用:
|
|
148
|
-
- 新功能、较大改动、完整交付
|
|
149
|
-
|
|
150
|
-
默认 skill:
|
|
151
|
-
- \`$zc-sdd-tdd\`
|
|
152
|
-
- 需要完整主流程时,再接 \`$zc-sdd-tdd-workflow\`
|
|
153
|
-
|
|
154
|
-
### 3. bugfix
|
|
155
|
-
|
|
156
|
-
适用:
|
|
157
|
-
- Bug、失败测试、异常行为
|
|
158
|
-
|
|
159
|
-
默认 skill:
|
|
160
|
-
- \`$zc-debug\`
|
|
161
|
-
- 需要深入根因分析时,再接 \`$zc-debugging-and-error-recovery\`
|
|
162
|
-
|
|
163
|
-
### 4. review-closure
|
|
164
|
-
|
|
165
|
-
适用:
|
|
166
|
-
- 已有改动,当前重点是审查、反馈处理、收尾
|
|
167
|
-
|
|
168
|
-
默认 skill:
|
|
169
|
-
- \`$zc-quality-review\`
|
|
170
|
-
- 必要时接 \`$zc-code-review-and-quality\` / \`$zc-review-response-and-resolution\`
|
|
171
|
-
|
|
172
|
-
### 5. docs-release
|
|
173
|
-
|
|
174
|
-
适用:
|
|
175
|
-
- 文档、ADR、发布说明、发布后同步
|
|
176
|
-
|
|
177
|
-
默认 skill:
|
|
178
|
-
- \`$zc-doc\`
|
|
179
|
-
- 发布收尾时可接 \`$zc-ship\`
|
|
180
|
-
- 必要时接 \`$zc-documentation-and-adrs\` / \`$zc-release-documentation-sync\`
|
|
181
|
-
|
|
182
|
-
### 6. investigation
|
|
183
|
-
|
|
184
|
-
适用:
|
|
185
|
-
- 陌生代码库
|
|
186
|
-
- 上下文失焦
|
|
187
|
-
- 需要先摸清项目或限制
|
|
188
|
-
|
|
189
|
-
默认 skill:
|
|
190
|
-
- \`$zc-onboard\` / \`$zc-ctx-health\`
|
|
191
|
-
- 必要时接 \`$zc-codebase-onboarding\` / \`$zc-context-engineering\`
|
|
192
|
-
|
|
193
|
-
## 推荐开始方式
|
|
194
|
-
|
|
195
|
-
- 不确定从哪开始:直接用 \`$zc-start\`
|
|
196
|
-
- 需求还模糊:先用 \`$zc-product-analysis\`
|
|
197
|
-
- 已确认是完整交付:直接用 \`$zc-sdd-tdd\`
|
|
198
|
-
- 明确是 bug:直接用 \`$zc-debug\`
|
|
199
|
-
- 明确是审查:直接用 \`$zc-quality-review\`
|
|
200
|
-
|
|
201
|
-
## 最常用入口速查
|
|
202
|
-
|
|
203
|
-
- 做新需求但范围还没收敛:\`$zc-product-analysis\`
|
|
204
|
-
- 进入完整交付主流程:\`$zc-sdd-tdd\`
|
|
205
|
-
- 修 bug:\`$zc-debug\`
|
|
206
|
-
- 做代码审查和反馈收敛:\`$zc-quality-review\`
|
|
207
|
-
- 补文档或发布说明:\`$zc-doc\`
|
|
208
|
-
- 陌生项目先摸底:\`$zc-onboard\` 或 \`$zc-ctx-health\`
|
|
209
|
-
|
|
210
|
-
## 详细内容在哪里
|
|
211
|
-
|
|
212
|
-
- command-alias skills:查看 \`${layout.displaySkillsDir}/zc-<command>/SKILL.md\`
|
|
213
|
-
- workflow / 专项 skills:查看 \`${layout.displaySkillsDir}/zc-<skill>/SKILL.md\`
|
|
214
|
-
- 如果入口页不足以判断,就先打开对应 skill 再继续
|
|
215
|
-
|
|
216
|
-
## 已安装能力
|
|
217
|
-
|
|
218
|
-
此安装当前包含:
|
|
219
|
-
|
|
220
|
-
- 清单来源:\`${manifestSource}\`
|
|
221
|
-
- 匹配到的资产:${assets.length}
|
|
222
|
-
- command-alias skills:${commandCount} 个
|
|
223
|
-
- skills:${skillCount} 个
|
|
224
|
-
- custom agents:${agentCount} 个
|
|
225
|
-
|
|
226
|
-
${renderPlatformAssetList(assets)}
|
|
89
|
+
return `# Codex 工作流入口
|
|
90
|
+
|
|
91
|
+
这是安装到 Codex 的薄入口文件。
|
|
92
|
+
|
|
93
|
+
它负责三件事:
|
|
94
|
+
|
|
95
|
+
1. 给出统一任务开始方式
|
|
96
|
+
2. 说明固定 workflow 的选路规则
|
|
97
|
+
3. 把 \`zc:*\` 命令语义映射成 Codex 实际可调用的 \`$zc-*\` skill
|
|
98
|
+
|
|
99
|
+
详细方法不写在这里,完整内容都在 \`${layout.displaySkillsDir}/zc-*/SKILL.md\`。
|
|
100
|
+
角色化 custom agents 位于 \`${layout.displayAgentsDir}/zc-*.toml\`。
|
|
101
|
+
Codex agent role 注册位于 \`${layout.displayConfigFile}\` 的 \`[agents.*]\` 配置。
|
|
102
|
+
其中:
|
|
103
|
+
|
|
104
|
+
- \`$zc-start\`、\`$zc-spec\`、\`$zc-build\` 这类是 command-alias skill
|
|
105
|
+
- \`$zc-sdd-tdd-workflow\`、\`$zc-debugging-and-error-recovery\` 这类是专题/流程 skill
|
|
106
|
+
- \`zc_*\` 这类是 Codex custom agent,只在显式要求多 agent / 指定 agent 时使用
|
|
107
|
+
|
|
108
|
+
## 核心规则
|
|
109
|
+
|
|
110
|
+
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
111
|
+
- Codex 侧没有 \`zc:start\` 这类原生命令,请把它们理解为统一语义入口
|
|
112
|
+
- 在 Codex 中,统一命令语义通过 \`$zc-*\` skill 来承接
|
|
113
|
+
- 中文优先,技术契约保持原样
|
|
114
|
+
- 证据先于断言,完成前必须验证
|
|
115
|
+
- 不做超出任务边界的顺手修改
|
|
116
|
+
|
|
117
|
+
## 统一命令语义到 Codex skill 的映射
|
|
118
|
+
|
|
119
|
+
- \`zc:start\` -> \`$zc-start\`
|
|
120
|
+
- \`zc:product-analysis\` -> \`$zc-product-analysis\`
|
|
121
|
+
- \`zc:sdd-tdd\` -> \`$zc-sdd-tdd\`
|
|
122
|
+
- \`zc:spec\` -> \`$zc-spec\`
|
|
123
|
+
- \`zc:task-plan\` -> \`$zc-task-plan\`
|
|
124
|
+
- \`zc:build\` -> \`$zc-build\`
|
|
125
|
+
- \`zc:quality-review\` -> \`$zc-quality-review\`
|
|
126
|
+
- \`zc:verify\` -> \`$zc-verify\`
|
|
127
|
+
- \`zc:debug\` -> \`$zc-debug\`
|
|
128
|
+
- \`zc:doc\` -> \`$zc-doc\`
|
|
129
|
+
- \`zc:ship\` -> \`$zc-ship\`
|
|
130
|
+
- \`zc:onboard\` -> \`$zc-onboard\`
|
|
131
|
+
- \`zc:ctx-health\` -> \`$zc-ctx-health\`
|
|
132
|
+
|
|
133
|
+
## 固定 workflow
|
|
134
|
+
|
|
135
|
+
### 1. product-analysis
|
|
136
|
+
|
|
137
|
+
适用:
|
|
138
|
+
- 需求还模糊
|
|
139
|
+
- 需要先把目标、范围和验收标准收敛清楚
|
|
140
|
+
|
|
141
|
+
默认 skill:
|
|
142
|
+
- \`$zc-product-analysis\`
|
|
143
|
+
- 需要更深的设计或规格时,再接 \`$zc-brainstorming-and-design\` / \`$zc-spec-driven-development\`
|
|
144
|
+
|
|
145
|
+
### 2. full-delivery
|
|
146
|
+
|
|
147
|
+
适用:
|
|
148
|
+
- 新功能、较大改动、完整交付
|
|
149
|
+
|
|
150
|
+
默认 skill:
|
|
151
|
+
- \`$zc-sdd-tdd\`
|
|
152
|
+
- 需要完整主流程时,再接 \`$zc-sdd-tdd-workflow\`
|
|
153
|
+
|
|
154
|
+
### 3. bugfix
|
|
155
|
+
|
|
156
|
+
适用:
|
|
157
|
+
- Bug、失败测试、异常行为
|
|
158
|
+
|
|
159
|
+
默认 skill:
|
|
160
|
+
- \`$zc-debug\`
|
|
161
|
+
- 需要深入根因分析时,再接 \`$zc-debugging-and-error-recovery\`
|
|
162
|
+
|
|
163
|
+
### 4. review-closure
|
|
164
|
+
|
|
165
|
+
适用:
|
|
166
|
+
- 已有改动,当前重点是审查、反馈处理、收尾
|
|
167
|
+
|
|
168
|
+
默认 skill:
|
|
169
|
+
- \`$zc-quality-review\`
|
|
170
|
+
- 必要时接 \`$zc-code-review-and-quality\` / \`$zc-review-response-and-resolution\`
|
|
171
|
+
|
|
172
|
+
### 5. docs-release
|
|
173
|
+
|
|
174
|
+
适用:
|
|
175
|
+
- 文档、ADR、发布说明、发布后同步
|
|
176
|
+
|
|
177
|
+
默认 skill:
|
|
178
|
+
- \`$zc-doc\`
|
|
179
|
+
- 发布收尾时可接 \`$zc-ship\`
|
|
180
|
+
- 必要时接 \`$zc-documentation-and-adrs\` / \`$zc-release-documentation-sync\`
|
|
181
|
+
|
|
182
|
+
### 6. investigation
|
|
183
|
+
|
|
184
|
+
适用:
|
|
185
|
+
- 陌生代码库
|
|
186
|
+
- 上下文失焦
|
|
187
|
+
- 需要先摸清项目或限制
|
|
188
|
+
|
|
189
|
+
默认 skill:
|
|
190
|
+
- \`$zc-onboard\` / \`$zc-ctx-health\`
|
|
191
|
+
- 必要时接 \`$zc-codebase-onboarding\` / \`$zc-context-engineering\`
|
|
192
|
+
|
|
193
|
+
## 推荐开始方式
|
|
194
|
+
|
|
195
|
+
- 不确定从哪开始:直接用 \`$zc-start\`
|
|
196
|
+
- 需求还模糊:先用 \`$zc-product-analysis\`
|
|
197
|
+
- 已确认是完整交付:直接用 \`$zc-sdd-tdd\`
|
|
198
|
+
- 明确是 bug:直接用 \`$zc-debug\`
|
|
199
|
+
- 明确是审查:直接用 \`$zc-quality-review\`
|
|
200
|
+
|
|
201
|
+
## 最常用入口速查
|
|
202
|
+
|
|
203
|
+
- 做新需求但范围还没收敛:\`$zc-product-analysis\`
|
|
204
|
+
- 进入完整交付主流程:\`$zc-sdd-tdd\`
|
|
205
|
+
- 修 bug:\`$zc-debug\`
|
|
206
|
+
- 做代码审查和反馈收敛:\`$zc-quality-review\`
|
|
207
|
+
- 补文档或发布说明:\`$zc-doc\`
|
|
208
|
+
- 陌生项目先摸底:\`$zc-onboard\` 或 \`$zc-ctx-health\`
|
|
209
|
+
|
|
210
|
+
## 详细内容在哪里
|
|
211
|
+
|
|
212
|
+
- command-alias skills:查看 \`${layout.displaySkillsDir}/zc-<command>/SKILL.md\`
|
|
213
|
+
- workflow / 专项 skills:查看 \`${layout.displaySkillsDir}/zc-<skill>/SKILL.md\`
|
|
214
|
+
- 如果入口页不足以判断,就先打开对应 skill 再继续
|
|
215
|
+
|
|
216
|
+
## 已安装能力
|
|
217
|
+
|
|
218
|
+
此安装当前包含:
|
|
219
|
+
|
|
220
|
+
- 清单来源:\`${manifestSource}\`
|
|
221
|
+
- 匹配到的资产:${assets.length}
|
|
222
|
+
- command-alias skills:${commandCount} 个
|
|
223
|
+
- skills:${skillCount} 个
|
|
224
|
+
- custom agents:${agentCount} 个
|
|
225
|
+
|
|
226
|
+
${renderPlatformAssetList(assets)}
|
|
227
227
|
`;
|
|
228
228
|
}
|
|
229
229
|
function renderPluginCompanionAgentsFile(options) {
|
|
@@ -238,51 +238,51 @@ function renderPluginCompanionAgentsFile(options) {
|
|
|
238
238
|
})
|
|
239
239
|
.join("\n")
|
|
240
240
|
: "- 当前清单未匹配 command-alias skill";
|
|
241
|
-
return `# Codex zc-toolkit 插件入口
|
|
242
|
-
|
|
243
|
-
这是 \`${options.pluginName}\` Codex 插件的薄入口文件。
|
|
244
|
-
|
|
245
|
-
它负责保留插件安装后的全局 / 项目级默认规则,并把统一 \`zc:*\` 语义映射到插件内 skill。详细方法不写在这里,完整内容都在 \`${options.displayPluginSkillsDir}/<skill>/SKILL.md\`。
|
|
246
|
-
|
|
247
|
-
## 全局规则
|
|
248
|
-
|
|
249
|
-
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
250
|
-
- 不确定入口时,先用 \`$start\`
|
|
251
|
-
- 中文优先,命令名、参数名、文件名、JSON 键和平台产物名保持原样
|
|
252
|
-
- 证据先于断言,完成前必须给出实际验证结果
|
|
253
|
-
- 不做超出任务边界的顺手修改
|
|
254
|
-
- 需要多 agent 或指定角色时,再使用 Codex custom agents
|
|
255
|
-
|
|
256
|
-
## 统一命令语义到插件 skill 的映射
|
|
257
|
-
|
|
258
|
-
${commandMappings}
|
|
259
|
-
|
|
260
|
-
## 推荐开始方式
|
|
261
|
-
|
|
262
|
-
- 不确定从哪开始:\`$start\`
|
|
263
|
-
- 需求还模糊:\`$product-analysis\`
|
|
264
|
-
- 完整交付主流程:\`$sdd-tdd\`
|
|
265
|
-
- 修 bug:\`$debug\`
|
|
266
|
-
- 代码审查和反馈收敛:\`$quality-review\`
|
|
267
|
-
- 文档或发布说明:\`$doc\`
|
|
268
|
-
- 陌生项目先摸底:\`$onboard\` 或 \`$ctx-health\`
|
|
269
|
-
|
|
270
|
-
## 详细内容在哪里
|
|
271
|
-
|
|
272
|
-
- 插件 skills:\`${options.displayPluginSkillsDir}/<command-or-skill>/SKILL.md\`
|
|
273
|
-
- custom agents:\`${options.displayAgentsDir}/zc-<agent>.toml\`
|
|
274
|
-
- Codex agent role 注册:\`${options.displayConfigFile}\` 的 \`[agents.*]\` 配置
|
|
275
|
-
- 当前入口文件:\`${options.displayEntryFile}\`
|
|
276
|
-
|
|
277
|
-
## 已安装能力
|
|
278
|
-
|
|
279
|
-
此安装当前包含:
|
|
280
|
-
|
|
281
|
-
- 清单来源:\`${options.manifestSource}\`
|
|
282
|
-
- 匹配到的资产:${options.assets.length}
|
|
283
|
-
- command-alias skills:${commandAssets.length} 个
|
|
284
|
-
- skills:${skillCount} 个
|
|
285
|
-
- custom agents:${agentCount} 个
|
|
241
|
+
return `# Codex zc-toolkit 插件入口
|
|
242
|
+
|
|
243
|
+
这是 \`${options.pluginName}\` Codex 插件的薄入口文件。
|
|
244
|
+
|
|
245
|
+
它负责保留插件安装后的全局 / 项目级默认规则,并把统一 \`zc:*\` 语义映射到插件内 skill。详细方法不写在这里,完整内容都在 \`${options.displayPluginSkillsDir}/<skill>/SKILL.md\`。
|
|
246
|
+
|
|
247
|
+
## 全局规则
|
|
248
|
+
|
|
249
|
+
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
250
|
+
- 不确定入口时,先用 \`$start\`
|
|
251
|
+
- 中文优先,命令名、参数名、文件名、JSON 键和平台产物名保持原样
|
|
252
|
+
- 证据先于断言,完成前必须给出实际验证结果
|
|
253
|
+
- 不做超出任务边界的顺手修改
|
|
254
|
+
- 需要多 agent 或指定角色时,再使用 Codex custom agents
|
|
255
|
+
|
|
256
|
+
## 统一命令语义到插件 skill 的映射
|
|
257
|
+
|
|
258
|
+
${commandMappings}
|
|
259
|
+
|
|
260
|
+
## 推荐开始方式
|
|
261
|
+
|
|
262
|
+
- 不确定从哪开始:\`$start\`
|
|
263
|
+
- 需求还模糊:\`$product-analysis\`
|
|
264
|
+
- 完整交付主流程:\`$sdd-tdd\`
|
|
265
|
+
- 修 bug:\`$debug\`
|
|
266
|
+
- 代码审查和反馈收敛:\`$quality-review\`
|
|
267
|
+
- 文档或发布说明:\`$doc\`
|
|
268
|
+
- 陌生项目先摸底:\`$onboard\` 或 \`$ctx-health\`
|
|
269
|
+
|
|
270
|
+
## 详细内容在哪里
|
|
271
|
+
|
|
272
|
+
- 插件 skills:\`${options.displayPluginSkillsDir}/<command-or-skill>/SKILL.md\`
|
|
273
|
+
- custom agents:\`${options.displayAgentsDir}/zc-<agent>.toml\`
|
|
274
|
+
- Codex agent role 注册:\`${options.displayConfigFile}\` 的 \`[agents.*]\` 配置
|
|
275
|
+
- 当前入口文件:\`${options.displayEntryFile}\`
|
|
276
|
+
|
|
277
|
+
## 已安装能力
|
|
278
|
+
|
|
279
|
+
此安装当前包含:
|
|
280
|
+
|
|
281
|
+
- 清单来源:\`${options.manifestSource}\`
|
|
282
|
+
- 匹配到的资产:${options.assets.length}
|
|
283
|
+
- command-alias skills:${commandAssets.length} 个
|
|
284
|
+
- skills:${skillCount} 个
|
|
285
|
+
- custom agents:${agentCount} 个
|
|
286
286
|
`;
|
|
287
287
|
}
|
|
288
288
|
function renderPluginManifest(options) {
|
|
@@ -356,17 +356,17 @@ function renderTomlScalar(value) {
|
|
|
356
356
|
function renderCodexCommandAliasBody(asset, naming) {
|
|
357
357
|
const commandName = toCodexSkillSlug(asset);
|
|
358
358
|
const invocationName = `${naming.prefix}${commandName}`;
|
|
359
|
-
return `# zc:${commandName}
|
|
360
|
-
|
|
361
|
-
这是 Codex 的 command-alias skill。
|
|
362
|
-
|
|
363
|
-
使用方式:
|
|
364
|
-
|
|
365
|
-
- 在 Codex 中直接调用 \`$${invocationName}\`
|
|
366
|
-
- 它对应统一命令语义 \`zc:${commandName}\`
|
|
367
|
-
- 如果需要更深的方法细节,再继续调用相关专题 skill
|
|
368
|
-
|
|
369
|
-
${(asset.body ?? `# ${describeAsset(asset)}\n`).trim()}
|
|
359
|
+
return `# zc:${commandName}
|
|
360
|
+
|
|
361
|
+
这是 Codex 的 command-alias skill。
|
|
362
|
+
|
|
363
|
+
使用方式:
|
|
364
|
+
|
|
365
|
+
- 在 Codex 中直接调用 \`$${invocationName}\`
|
|
366
|
+
- 它对应统一命令语义 \`zc:${commandName}\`
|
|
367
|
+
- 如果需要更深的方法细节,再继续调用相关专题 skill
|
|
368
|
+
|
|
369
|
+
${(asset.body ?? `# ${describeAsset(asset)}\n`).trim()}
|
|
370
370
|
`;
|
|
371
371
|
}
|
|
372
372
|
function renderCodexSkillArtifacts(assets, layout, naming = namespacedSkillNaming) {
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { describe, it } from "node:test";
|
|
2
2
|
import assert from "node:assert/strict";
|
|
3
|
-
import { join } from "node:path";
|
|
4
3
|
import { capability, createCodexGenerationPlan, createCodexInstallPlan, createCodexMarketplaceGenerationPlan, createCodexPluginGenerationPlan, packageName, platformName, templateFiles, } from "./index.js";
|
|
5
4
|
const manifest = {
|
|
6
5
|
source: "toolkit-manifest",
|
|
@@ -63,35 +62,33 @@ describe("@zmice/platform-codex scaffold", () => {
|
|
|
63
62
|
assert.ok(plan.artifacts[4]?.content.includes("developer_instructions"));
|
|
64
63
|
});
|
|
65
64
|
it("creates a global install plan with AGENTS and skills", () => {
|
|
66
|
-
const destinationRoot = join("tmp", "codex");
|
|
67
65
|
const plan = createCodexInstallPlan(manifest, {
|
|
68
|
-
destinationRoot,
|
|
66
|
+
destinationRoot: "/tmp/codex",
|
|
69
67
|
scope: "global",
|
|
70
68
|
});
|
|
71
|
-
assert.equal(plan.destinationRoot,
|
|
69
|
+
assert.equal(plan.destinationRoot, "/tmp/codex");
|
|
72
70
|
assert.equal(plan.scope, "global");
|
|
73
71
|
assert.equal(plan.overwrite, "error");
|
|
74
72
|
assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
73
|
+
"/tmp/codex/AGENTS.md",
|
|
74
|
+
"/tmp/codex/config.toml",
|
|
75
|
+
"/tmp/codex/skills/zc-start/SKILL.md",
|
|
76
|
+
"/tmp/codex/skills/zc-skill-alpha/SKILL.md",
|
|
77
|
+
"/tmp/codex/agents/zc-code-reviewer.toml",
|
|
80
78
|
]);
|
|
81
79
|
});
|
|
82
80
|
it("installs project AGENTS.md and project-local .codex skills", () => {
|
|
83
|
-
const destinationRoot = join("tmp", "project");
|
|
84
81
|
const plan = createCodexInstallPlan(manifest, {
|
|
85
|
-
destinationRoot,
|
|
82
|
+
destinationRoot: "/tmp/project",
|
|
86
83
|
scope: "project",
|
|
87
84
|
});
|
|
88
85
|
assert.equal(plan.scope, "project");
|
|
89
86
|
assert.deepEqual(plan.artifacts.map((artifact) => artifact.path), [
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
87
|
+
"/tmp/project/AGENTS.md",
|
|
88
|
+
"/tmp/project/.codex/config.toml",
|
|
89
|
+
"/tmp/project/.codex/skills/zc-start/SKILL.md",
|
|
90
|
+
"/tmp/project/.codex/skills/zc-skill-alpha/SKILL.md",
|
|
91
|
+
"/tmp/project/.codex/agents/zc-code-reviewer.toml",
|
|
95
92
|
]);
|
|
96
93
|
assert.deepEqual(plan.capability.skills?.relativeDir, ".codex/skills");
|
|
97
94
|
assert.deepEqual(plan.capability.agents?.relativeDir, ".codex/agents");
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -84,81 +84,81 @@ function renderAgentsFile(manifestSource, assets, layout) {
|
|
|
84
84
|
const commandCount = assets.filter((asset) => asset.kind === "command").length;
|
|
85
85
|
const skillCount = assets.filter((asset) => asset.kind === "skill").length;
|
|
86
86
|
const agentCount = assets.filter((asset) => asset.kind === "agent").length;
|
|
87
|
-
return `# OpenCode 工作流入口
|
|
88
|
-
|
|
89
|
-
这是安装到 OpenCode 的薄入口文件。
|
|
90
|
-
|
|
91
|
-
它负责三件事:
|
|
92
|
-
|
|
93
|
-
1. 给出统一任务开始方式
|
|
94
|
-
2. 说明固定 workflow 的选路规则
|
|
95
|
-
3. 指向 \`${layout.displayCommandsDir}\`、\`${layout.displaySkillsDir}\`、\`${layout.displayAgentsDir}\` 里的详细内容
|
|
96
|
-
|
|
97
|
-
## 核心规则
|
|
98
|
-
|
|
99
|
-
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
100
|
-
- OpenCode 侧通过自定义 \`/zc-*\` command 和按需加载 skills 承接统一语义
|
|
101
|
-
- 中文优先,技术契约保持原样
|
|
102
|
-
- 证据先于断言,完成前必须验证
|
|
103
|
-
|
|
104
|
-
## 固定 workflow
|
|
105
|
-
|
|
106
|
-
### 1. product-analysis
|
|
107
|
-
- 入口:\`/zc-product-analysis\`
|
|
108
|
-
- 适用:需求模糊、范围和验收标准未收敛
|
|
109
|
-
|
|
110
|
-
### 2. full-delivery
|
|
111
|
-
- 入口:\`/zc-sdd-tdd\`
|
|
112
|
-
- 适用:新功能、较大改动、完整交付
|
|
113
|
-
|
|
114
|
-
### 3. bugfix
|
|
115
|
-
- 入口:\`/zc-debug\`
|
|
116
|
-
- 适用:Bug、失败测试、异常行为
|
|
117
|
-
|
|
118
|
-
### 4. review-closure
|
|
119
|
-
- 入口:\`/zc-quality-review\`
|
|
120
|
-
- 适用:已有改动,需要审查与反馈收敛
|
|
121
|
-
|
|
122
|
-
### 5. docs-release
|
|
123
|
-
- 入口:\`/zc-doc\` 或 \`/zc-ship\`
|
|
124
|
-
- 适用:文档、ADR、发布说明、上线准备
|
|
125
|
-
|
|
126
|
-
### 6. investigation
|
|
127
|
-
- 入口:\`/zc-onboard\` 或 \`/zc-ctx-health\`
|
|
128
|
-
- 适用:陌生代码库、上下文失焦、技术摸底
|
|
129
|
-
|
|
130
|
-
## 推荐开始方式
|
|
131
|
-
|
|
132
|
-
- 不确定走哪条线:先用 \`/zc-start\`
|
|
133
|
-
- 需求模糊:进 \`/zc-product-analysis\`
|
|
134
|
-
- 已确认是完整交付:进 \`/zc-sdd-tdd\`
|
|
135
|
-
- 明确是 bug:进 \`/zc-debug\`
|
|
136
|
-
|
|
137
|
-
## 最常用入口速查
|
|
138
|
-
|
|
139
|
-
- 做新需求但范围还没收敛:\`/zc-product-analysis\`
|
|
140
|
-
- 进入完整交付主流程:\`/zc-sdd-tdd\`
|
|
141
|
-
- 修 bug:\`/zc-debug\`
|
|
142
|
-
- 做代码审查和反馈收敛:\`/zc-quality-review\`
|
|
143
|
-
- 补文档或发布说明:\`/zc-doc\`
|
|
144
|
-
- 陌生项目先摸底:\`/zc-onboard\` 或 \`/zc-ctx-health\`
|
|
145
|
-
|
|
146
|
-
## 详细内容在哪里
|
|
147
|
-
|
|
148
|
-
- commands:查看 \`${layout.displayCommandsDir}/zc-*.md\`
|
|
149
|
-
- skills:查看 \`${layout.displaySkillsDir}/zc-*/SKILL.md\`
|
|
150
|
-
- agents:查看 \`${layout.displayAgentsDir}/zc-*.md\`
|
|
151
|
-
- 如果入口页不足以判断,就先打开对应 command、skill 或 agent 再继续
|
|
152
|
-
|
|
153
|
-
## 已安装能力
|
|
154
|
-
|
|
155
|
-
- 清单来源:\`${manifestSource}\`
|
|
156
|
-
- 匹配到的资产:${assets.length}
|
|
157
|
-
- commands:${commandCount} 个
|
|
158
|
-
- skills:${skillCount} 个
|
|
159
|
-
- agents:${agentCount} 个
|
|
160
|
-
|
|
161
|
-
${renderPlatformAssetList(assets)}
|
|
87
|
+
return `# OpenCode 工作流入口
|
|
88
|
+
|
|
89
|
+
这是安装到 OpenCode 的薄入口文件。
|
|
90
|
+
|
|
91
|
+
它负责三件事:
|
|
92
|
+
|
|
93
|
+
1. 给出统一任务开始方式
|
|
94
|
+
2. 说明固定 workflow 的选路规则
|
|
95
|
+
3. 指向 \`${layout.displayCommandsDir}\`、\`${layout.displaySkillsDir}\`、\`${layout.displayAgentsDir}\` 里的详细内容
|
|
96
|
+
|
|
97
|
+
## 核心规则
|
|
98
|
+
|
|
99
|
+
- 默认先判断任务属于哪条 workflow,再决定入口
|
|
100
|
+
- OpenCode 侧通过自定义 \`/zc-*\` command 和按需加载 skills 承接统一语义
|
|
101
|
+
- 中文优先,技术契约保持原样
|
|
102
|
+
- 证据先于断言,完成前必须验证
|
|
103
|
+
|
|
104
|
+
## 固定 workflow
|
|
105
|
+
|
|
106
|
+
### 1. product-analysis
|
|
107
|
+
- 入口:\`/zc-product-analysis\`
|
|
108
|
+
- 适用:需求模糊、范围和验收标准未收敛
|
|
109
|
+
|
|
110
|
+
### 2. full-delivery
|
|
111
|
+
- 入口:\`/zc-sdd-tdd\`
|
|
112
|
+
- 适用:新功能、较大改动、完整交付
|
|
113
|
+
|
|
114
|
+
### 3. bugfix
|
|
115
|
+
- 入口:\`/zc-debug\`
|
|
116
|
+
- 适用:Bug、失败测试、异常行为
|
|
117
|
+
|
|
118
|
+
### 4. review-closure
|
|
119
|
+
- 入口:\`/zc-quality-review\`
|
|
120
|
+
- 适用:已有改动,需要审查与反馈收敛
|
|
121
|
+
|
|
122
|
+
### 5. docs-release
|
|
123
|
+
- 入口:\`/zc-doc\` 或 \`/zc-ship\`
|
|
124
|
+
- 适用:文档、ADR、发布说明、上线准备
|
|
125
|
+
|
|
126
|
+
### 6. investigation
|
|
127
|
+
- 入口:\`/zc-onboard\` 或 \`/zc-ctx-health\`
|
|
128
|
+
- 适用:陌生代码库、上下文失焦、技术摸底
|
|
129
|
+
|
|
130
|
+
## 推荐开始方式
|
|
131
|
+
|
|
132
|
+
- 不确定走哪条线:先用 \`/zc-start\`
|
|
133
|
+
- 需求模糊:进 \`/zc-product-analysis\`
|
|
134
|
+
- 已确认是完整交付:进 \`/zc-sdd-tdd\`
|
|
135
|
+
- 明确是 bug:进 \`/zc-debug\`
|
|
136
|
+
|
|
137
|
+
## 最常用入口速查
|
|
138
|
+
|
|
139
|
+
- 做新需求但范围还没收敛:\`/zc-product-analysis\`
|
|
140
|
+
- 进入完整交付主流程:\`/zc-sdd-tdd\`
|
|
141
|
+
- 修 bug:\`/zc-debug\`
|
|
142
|
+
- 做代码审查和反馈收敛:\`/zc-quality-review\`
|
|
143
|
+
- 补文档或发布说明:\`/zc-doc\`
|
|
144
|
+
- 陌生项目先摸底:\`/zc-onboard\` 或 \`/zc-ctx-health\`
|
|
145
|
+
|
|
146
|
+
## 详细内容在哪里
|
|
147
|
+
|
|
148
|
+
- commands:查看 \`${layout.displayCommandsDir}/zc-*.md\`
|
|
149
|
+
- skills:查看 \`${layout.displaySkillsDir}/zc-*/SKILL.md\`
|
|
150
|
+
- agents:查看 \`${layout.displayAgentsDir}/zc-*.md\`
|
|
151
|
+
- 如果入口页不足以判断,就先打开对应 command、skill 或 agent 再继续
|
|
152
|
+
|
|
153
|
+
## 已安装能力
|
|
154
|
+
|
|
155
|
+
- 清单来源:\`${manifestSource}\`
|
|
156
|
+
- 匹配到的资产:${assets.length}
|
|
157
|
+
- commands:${commandCount} 个
|
|
158
|
+
- skills:${skillCount} 个
|
|
159
|
+
- agents:${agentCount} 个
|
|
160
|
+
|
|
161
|
+
${renderPlatformAssetList(assets)}
|
|
162
162
|
`;
|
|
163
163
|
}
|
|
164
164
|
function toNamespacedSlug(asset) {
|