@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
@@ -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, 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
- join(destinationRoot, "AGENTS.md"),
76
- join(destinationRoot, "config.toml"),
77
- join(destinationRoot, "skills/zc-start/SKILL.md"),
78
- join(destinationRoot, "skills/zc-skill-alpha/SKILL.md"),
79
- join(destinationRoot, "agents/zc-code-reviewer.toml"),
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
- join(destinationRoot, "AGENTS.md"),
91
- join(destinationRoot, ".codex/config.toml"),
92
- join(destinationRoot, ".codex/skills/zc-start/SKILL.md"),
93
- join(destinationRoot, ".codex/skills/zc-skill-alpha/SKILL.md"),
94
- join(destinationRoot, ".codex/agents/zc-code-reviewer.toml"),
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":"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"}
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;AAExC,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,sBAAsB,EACtB,oCAAoC,EACpC,+BAA+B,EAC/B,WAAW,EACX,YAAY,EACZ,aAAa,GAEd,MAAM,YAAY,CAAC;AAEpB,MAAM,QAAQ,GAAwB;IACpC,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE;QACN;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC5B,KAAK,EAAE,aAAa;SACrB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,UAAU;YACnB,IAAI,EAAE,2BAA2B;SAClC;QACD;YACE,EAAE,EAAE,qBAAqB;YACzB,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,+CAA+C;YACxD,IAAI,EAAE,uGAAuG;SAC9G;KACF;CACF,CAAC;AAEF,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACtD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE;YAC5D,aAAa;YACb,eAAe;YACf,qBAAqB;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC9C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,aAAa,CAAC,MAAM;YACpB,aAAa,CAAC,MAAM;YACpB,0BAA0B;YAC1B,gCAAgC;YAChC,8BAA8B;SAC/B,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAC,CAAC;QAC/F,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAC5D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC;QAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE;YAC5C,eAAe,EAAE,YAAY;YAC7B,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,sBAAsB;YACtB,wBAAwB;YACxB,qCAAqC;YACrC,2CAA2C;YAC3C,yCAAyC;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,EAAE;YAC5C,eAAe,EAAE,cAAc;YAC/B,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,wBAAwB;YACxB,iCAAiC;YACjC,8CAA8C;YAC9C,oDAAoD;YACpD,kDAAkD;SACnD,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACvE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,8CAA8C,CAAC,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,IAAI,GAAG,+BAA+B,CAAC,QAAQ,EAAE;YACrD,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QACzE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACnD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,aAAa,CAAC,cAAc;YAC5B,uBAAuB;YACvB,6BAA6B;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAE7D,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,OAAO,CAM3D,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,aAAa,EAAE;YACvD,uDAAuD;YACvD,kFAAkF;SACnF,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,IAAI,GAAG,oCAAoC,CAAC,QAAQ,EAAE;YAC1D,aAAa,EAAE,OAAO;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,aAAa,CAAC,WAAW;YACzB,aAAa,CAAC,MAAM;YACpB,8CAA8C;YAC9C,0CAA0C;YAC1C,gDAAgD;YAChD,oBAAoB;YACpB,qCAAqC;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QACrG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QACxE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,2BAA2B,CAAC,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,uDAAuD,CAAC,CAAC,CAAC;QAExG,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,OAAO,CAMxD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACzD,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/C,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,sBAAsB;SAC7B,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/C,YAAY,EAAE,WAAW;YACzB,cAAc,EAAE,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,oCAAoC,CAAC,QAAQ,EAAE;YAC1D,aAAa,EAAE,OAAO;YACtB,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;YAChE,aAAa,CAAC,WAAW;YACzB,kBAAkB;YAClB,qDAAqD;YACrD,iDAAiD;YACjD,uDAAuD;YACvD,oBAAoB;YACpB,qCAAqC;SACtC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,kCAAkC,CAAC,CAAC;QACtF,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,gEAAgE,CAAC,CAAC,CAAC;QACjH,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAEvE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,OAAO,CAExD,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE;YAC/C,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,6BAA6B;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -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) {