| name | spec:execute |
| description | Use when executing an implementation plan step by step with enforced compilation verification and status sync - triggers on /spec:execute, 执行计划, 实施, 开始改代码 |
计划执行工作流 (Execute)
按照 plan.md 中的复选框顺序逐步执行代码修改,强制编译验证,完成后同步状态。
前置: 必须先有 specs/[feature_name]/plan.md(由 /spec:architect 生成)
⚠️ 执行铁律(开始前必读)
| # | 规则 | 说明 |
|---|
| 1 | 逐步执行 | 按 plan.md 中复选框的顺序逐个执行,不能跳步 |
| 2 | 编译必过 | 所有代码修改完成后,必须执行 npm run build 且编译通过 |
| 3 | 状态同步 | 每完成一个步骤,立即将 plan.md 中对应项标记为 - [x] |
| 4 | 失败即停 | 编译失败或执行出错,立即修复并重试,不能跳过继续。最多重试 3 次,超过则输出错误摘要请求用户介入 |
| 5 | 禁止偏离 | 严禁执行 plan.md 中没有列出的改动。发现遗漏应报告用户,不能自行补充 |
执行指令
1. 阅读计划
- 打开
specs/[feature_name]/plan.md
- 定位到包含复选框的 分步实施 章节
- 通读所有步骤,理解整体改动范围和依赖关系
- 如 plan.md 不存在,提示用户先运行
/spec:architect
2. 逐步执行
- 按顺序执行所有未选中项目
- [ ]
- 语言要求: 执行过程中给出的任何解释、日志或反馈必须使用简体中文
- 并行优化: 如果多个步骤之间无依赖关系(如修改不同文件),可同时执行提高效率
- 代码修改规范:
- 每次修改后,简要说明改动理由(1-2 句话)
- 如果 plan.md 中的代码片段与实际文件内容存在冲突(如行号偏移),以实际文件为准进行调整,并报告偏差
3. 编译验证(强制,不可跳过)
- 所有代码修改步骤完成后,必须执行
npm run build
- 如果编译失败:
- 读取完整的报错信息
- 定位到出错文件和行号
- 修复错误
- 重新执行
npm run build
- 重复直到编译通过(最多 3 轮)
- 编译通过后,将 plan.md 中的编译验证步骤标记为
- [x]
4. 状态同步
- 所有步骤执行完毕后,确认 plan.md 中所有
- [ ] 都已变为 - [x]
- 如有步骤未完成,明确标注原因
5. 完成汇报
在回复末尾必须输出以下汇报表格:
| 阶段 | 步骤 | 状态 | 备注 |
|------|------|------|------|
| A | 步骤描述... | ✅/❌ | 如有偏差说明原因 |
| B | npm run build | ✅/❌ | 编译日志摘要 |
| C | UPDATE_LOG.md | ✅/❌ | — |
汇报后提醒用户:
- 在 Cocos Creator 中重新加载插件验证效果
- 下一步运行
/spec:verify 进行视觉与逻辑验证