Spec Execute
根据 spec/ 目录中的 plan.md 执行新功能开发，严格遵循已批准的设计方案，不添加额外功能。完成后创建 summary.md，归档到 06-已归档。
核心原则
- Spec 优先：只实现 plan.md 中明确定义的功能，不添加、不偏离、不"优化"
- 用户确认必须执行：完成 summary.md 后必须使用
AskUserQuestion工具向用户确认 - 经验反思必须执行：归档前必须调用
/exp-reflect进行经验反思
[!important] v2.0 变更 spec-execute 移除路径 B（agent-teams）和测试步骤（A7/A8）。 测试由 spec-tester 负责，bug 修复由 spec-debugger 负责。 spec-execute 只负责：实现代码 → 产出 summary.md → 归档。
工作流程
步骤 1：读取并理解 plan.md
- 使用
Read工具读取 plan.md - 理解目标、范围、设计方案、数据模型、接口定义
- 记录 Spec 所在的分类目录（用于归档）
步骤 2：验证 plan.md 完整性
检查 plan.md 是否包含：目标和范围、设计方案、数据模型、接口签名、实现步骤。
如果不完整，停止执行并告知用户缺少哪些内容。
步骤 3：确定开发阶段
根据 plan.md 内容判断当前阶段，检查前置依赖是否已完成。如果前置阶段未完成，停止并提醒用户。
步骤 4：检索历史经验
根据 plan.md 的功能关键词，调用 /exp-search <关键词> 检索相关经验，在实现时参考。
步骤 5：创建任务清单
根据 plan.md 的"实现步骤"章节，使用 TaskCreate 创建任务清单并标记依赖关系。
步骤 6：按顺序实现功能
按任务清单顺序逐个实现，严格遵循 plan.md 的设计：
- 使用 plan.md 中定义的类名、方法名、数据结构
- 在代码注释中引用 plan.md 路径和章节
步骤 7：创建 summary.md
在 plan.md 同目录下创建 summary.md。格式模板见 references/summary-template.md。
撰写时直接应用 Obsidian 格式：
- 使用 Callout 标注关键信息（
> [!success]、> [!warning]、> [!note]） - 使用双链建立文档关联：
[[plan|设计方案]] - 添加标签：
#spec/已完成#summary
步骤 8：通知 TeamLead 并等待用户确认
SendMessage(recipient="TeamLead", content="summary.md 已完成，请发起用户确认")
TeamLead 使用 AskUserQuestion 向用户确认。如用户需要修改则根据反馈调整后重新确认。
步骤 9：经验反思与沉淀
调用 /exp-reflect，以 summary.md 中的「遇到的问题」和「解决方案」为反思素材。如有值得沉淀的经验，按 exp-reflect 流程完成写入。
步骤 10：更新 summary.md 添加经验引用
如果步骤 9 沉淀了经验，在 summary.md 的「文档关联」章节添加双链引用：
## 文档关联
- 设计文档: [[plan|设计方案]]
- 沉淀经验: [[context/experience/exp-007-异步任务超时处理|EXP-007 异步任务超时处理]]
步骤 11：归档
将整个 Spec 文件夹从当前分类目录移动到 06-已归档，验证移动成功。
mv "spec/03-功能实现/20251231-HHMM-任务描述" "spec/06-已归档/"
注意：必须等用户确认后才能归档。
分类目录
| 目录 | 用途 |
|---|---|
01-项目规划 | 项目整体规划、PRD |
02-架构设计 | 系统架构、数据模型 |
03-功能实现 | 具体功能实现方案 |
04-问题修复 | Bug 修复方案 |
05-测试文档 | 测试计划、报告 |
06-已归档 | 执行完成后归档 |
与其他角色的协作
spec-writer → plan.md → spec-executor（本 Skill）→ summary.md
→ 通知 TeamLead → TeamLead 用户确认 → spec-tester 执行测试
- 实现完成后不负责测试，通知 TeamLead 触发测试阶段
- 测试阶段发现的 bug 由 spec-debugger 负责，不是 spec-execute 的职责
- 如果目录下已有
summary.md，使用spec-update而非本 Skill
后续动作
完成执行后确认：
- summary.md 已创建并已通知 TeamLead
- 已调用
/exp-reflect进行经验反思 - 如有经验沉淀，已更新 summary.md 添加经验引用
- Spec 文件夹已归档到
06-已归档
常见陷阱
- 添加了 plan.md 中未定义的额外功能
- 在 spec-execute 内直接编写和运行测试（应等待 spec-tester）
- 未等待用户确认就归档
- 归档前忘记调用 exp-reflect