用途
execute-plan 用于执行一个已被批准的实现计划,要求严格遵守计划的范围与顺序,并在执行过程中进行验证。它适合 ExecPlan 风格的计划执行、可恢复的阶段清单,以及耗时较长的实现工作。执行期间不重新设计计划;如果出现歧义或阻塞,应停止并询问。
主要能力
该技能将计划作为持续更新的活文档,在执行过程中记录进度、发现、决策和结果。典型输入是:execute-plan docs/.plans/YYMMDD-HHmm-<plan-slug>/SUMMARY.md。它会定位计划路径、加载与任务相关的项目上下文、审查阶段文件、依赖、验收标准、幂等/恢复说明、决策日志和未决问题,并选择执行模式。默认模式为 Batch;当存在高风险变更(认证、支付、迁移、安全关键逻辑)、不可逆操作、验收标准不清晰或用户明确要求检查点时,使用 Interactive 模式。
工作流程
初始化阶段会确认计划路径可读,若提供的是目录则定位其中的 SUMMARY.md;优先阅读 docs/SUMMARY.md(若存在),只加载与任务相关的细节文档和实现约定文档。它会查找下一个待处理阶段(首个 [ ] 阶段,否则首个 [-] 阶段),并进行计划健全性检查,确保每个阶段具有清晰目标、文件目标、验证命令、可观察的验收标准;缺失可观察验收标准但能从明确的阶段验证和退出条件推断时,可补充后再执行;若关键细节缺失或矛盾则停止并请求澄清。
执行阶段按顺序逐阶段处理:跳过状态为 [x] 的阶段;将阶段标记为 [-] 并在 SUMMARY.md 中写入带时间戳的进度条目;仅实现该阶段定义的任务,不擅自扩大范围,编写满足阶段要求的最小代码,不添加推测性功能、不为单次使用代码创建抽象、不为不可能场景编写错误处理;若出现重大意外,记录到 Surprises & Discoveries;若为保持范围需要决策,先记录决策与理由再继续。随后运行阶段专属验证命令和相关测试/检查,将简明证据记录到 SUMMARY.md。验证失败时,先在阶段范围内尝试定向修复并重新验证;若仍失败或根因超出范围,则停止并报告阻塞。验证通过后才将阶段标记为 [x] 并记录带时间戳的进度和变更文件。Interactive 模式报告后等待确认,Batch 模式简要报告后立即继续。
最终验证包括项目级验证(完整 lint/类型检查、相关或全部测试、适用的构建验证)、稳定化(修复执行期间引入的回归并重跑检查直到通过或被阻塞)、以及需要用户/人工 QA 时的显式暂停等待验收或反馈。随后在 SUMMARY.md 中完成 Outcomes & Retrospective,记录最终结果、验证摘要、已批准的偏差和后续事项。
完成产物
若行为、架构或代码库预期发生变化,需要同步更新文档产物。会创建执行报告:docs/.plans/YYMMDD-HHmm-<plan-slug>/EXECUTION-REPORT.md,并使用 references/execution-report-template.md 模板。最终确认门之前不归档。
最终确认门
完成后产物后,使用 input/question 工具向用户请求最终确认,选项为:Confirm: End session 和 Need verify。选择 Confirm: End session 时,将计划文件夹归档到 docs/.plans/archived/,宣布执行完成并给出归档报告路径,结束执行会话。选择 Need verify 时,允许用户提供验证反馈/细节,不归档,继续执行循环处理反馈,并按需重新运行验证和完成步骤。
规则与限制
需遵循项目和 docs/ 标准;严格遵循计划,不静默变更范围;遇到缺失依赖、矛盾指令或无法解释的失败时停止;不确定时询问而非猜测;未通过检查不得标记阶段完成;保持计划活跃,不依赖聊天历史保存重要执行状态;优先使用安全、可重复运行的操作;坚持简单优先,编写满足阶段退出标准的最小代码;进行外科手术式变更,只触碰阶段要求的内容,不改进相邻代码、注释或格式,不重构未损坏的内容,匹配既有风格,仅移除因自身变更而孤立的导入/变量/函数;每一行变更都应能追溯到阶段任务。产物使用与当前会话相同的语言编写。
适用场景
适合已批准计划的精确执行、可恢复的多阶段实施工作、需要持续记录进度和决策的长时间实现任务,以及需要阶段验证和最终项目级验证的工程流程。
限制
本资料未提供该技能的具体实现语言、运行环境、安装方式、依赖要求、收费或价格信息、支持的平台,以及与其他工具的集成细节。