spec-execute

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
• 如果编译失败：
  1. 读取完整的报错信息
  2. 定位到出错文件和行号
  3. 修复错误
  4. 重新执行 npm run build
  5. 重复直到编译通过（最多 3 轮）
• 编译通过后，将 plan.md 中的编译验证步骤标记为 - [x]

4. 状态同步

• 所有步骤执行完毕后，确认 plan.md 中所有 - [ ] 都已变为 - [x]
• 如有步骤未完成，明确标注原因

5. 完成汇报

在回复末尾必须输出以下汇报表格：

| 阶段 | 步骤 | 状态 | 备注 |
|------|------|------|------|
| A | 步骤描述... | ✅/❌ | 如有偏差说明原因 |
| B | npm run build | ✅/❌ | 编译日志摘要 |
| C | UPDATE_LOG.md | ✅/❌ | — |

汇报后提醒用户：

• 在 Cocos Creator 中重新加载插件验证效果
• 下一步运行 /spec:verify 进行视觉与逻辑验证