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