用途:在规划与编码之间架起桥梁,把一个计划阶段连同其实施计划系统化地执行到底,逐步进行并在每步后做测试验证,同时自动更新计划状态。缺少它会怎样:代理读完计划后“自由发挥”,常跳过步骤、忘记跑测试或不更新状态;本技能强制执行让计划真正有用的纪律。
何时使用:在 resume-plan 已向你简述当前阶段之后;在 analyze-impact 已确认可以安全推进之后;当用户说“实现这个阶段”或“开始编码”时。不适用:探索性编码或快速修复——它面向有计划的、多步骤的工作。
执行模型:始终由主代理直接运行。理由:实现需要完整工具访问(文件编辑、终端、测试)以及用于用户反馈的对话上下文,无法委派。集成:从 plans/<name>/ 读取,写代码,运行测试,通过 update-plan 模式更新计划。
工作流:第一步加载阶段上下文,按顺序读取 plan.md、phases/phase-N.md、implementation/phase-N-impl.md、impact 文件(若存在)、todo.md,并核查前置条件。第二步用 todowrite 创建实现清单:每个实现步骤为一个待办项,每个代码改动步骤后加“运行测试”项,末尾加“验证”项。第三步顺序执行:读取步骤引用的上下文,按 AGENTS.md 约定实现改动,改动后立即跑相关测试,测试失败先修复再继续(不得带着失败测试推进),用 todowrite 标记完成。第四步验证验收标准:读取 phases/phase-N.md 的验收标准逐条核对,运行完整测试套件并检查回归。第五步更新计划状态:禁止用手工编辑,需在同一主代理会话中调用 update-plan 技能,更新 todo.md 为完成、把 phase-N.md 状态设为 completed、在 plan.md changelog 记录完成;若是最后阶段则把计划标记为完成。第六步向用户汇报:已完成步骤、测试通过/失败、变更文件、与计划的偏差及原因,并用 question 工具询问是否进入下一阶段或先审阅改动。
规则:绝不跳过步骤,按顺序执行,若某步似无必要应询问用户而非静默跳过;每处改动后都跑相关测试以尽早发现回归;测试失败必须先修复再继续,不得累积破损状态;全程保持 todo.md 与阶段状态同步,不要批量更新;遵守 AGENTS.md 的项目约定(命名、模式、风格);最小改动,避免范围蔓延;不要使用内置 explore 子代理类型。限制:仅面向已计划的、多步骤的工作,不适用于探索性编码或快速修复;需依赖 plans/<name>/ 目录结构与 update-plan 技能配合。