Executing Plans 是一个用于执行完整实施计划的工作流技能。核心原则是分批执行,并在批次之间设置供架构师审查的检查点。开始时会宣布:“I'm using the executing-plans skill to implement this plan.”
用途
当合作方提供了一份完整的实施计划,需要在受控批次中执行,并在批次之间进行审查和反馈时使用。
主要能力与流程
第0步:验证隔离上下文
加载计划前检查当前git上下文:
git branch --show-current
git worktree list
如果位于main/master且没有工作树,会询问用户:是“设置工作树”(推荐,先创建隔离工作区,使用workflow:git-worktrees技能),还是“继续在main上执行”(了解风险,继续)。如果已在工作树或功能分支上,则正常继续。
第1步:加载并审阅计划
读取计划文件,批判性地识别问题或疑虑。如有疑虑,先与合作方提出再开始;如无疑虑,创建TodoWrite,包含计划中的所有任务,并强制附加最终待办“Complete development (finish-branch)”,确保所有任务完成后调用finish-branch。
第2步:执行批次
默认首批3个任务。每个任务根据复杂度标签执行:
- TRIVIAL(删除、重命名、拼写、配置):直接执行,用git diff验证,跳过代码审查。目标是2-3次工具调用完成,而非11次。
- SIMPLE(小重构、单文件):若修改生产代码则使用core:tdd技能(先写测试);仅配置/文档可跳过TDD;运行指定验证;通过git diff做轻量审查,无需子代理。
- MODERATE(功能、缺陷修复):使用core:tdd先写失败测试再实现;严格按步骤执行;运行验证;使用core:verification确认测试通过;派发code-reviewer(Sonnet模型)审查。
- COMPLEX(多文件、架构性):使用core:tdd先写失败测试再实现;严格按步骤执行;运行验证;使用core:verification确认测试通过;派发code-reviewer(Opus模型进行彻底审查)。
第3步:批次后代码审查
- 仅含TRIVIAL/SIMPLE的批次:父代理直接查看git diff,验证变更符合计划要求,无需子代理。使用命令:
git diff --stat [BASE_SHA]..[HEAD_SHA]
git diff [BASE_SHA]..[HEAD_SHA]
检查差异是否符合请求、有无意外变更。
- 含MODERATE/COMPLEX的批次:派发code-reviewer子代理,使用模板plugins/methodology/review/templates/code-reviewer-dispatch.md。任务描述为“Review Batch [N] implementation”,提供上下文(实现内容、需求/计划、描述)和git范围(base为批次开始前提交,head为批次后当前提交),先运行git diff --stat,再对照plugins/methodology/review/references/code-review-standards.md审查。审查者返回:优点、问题(Critical/Important/Minor)、评估。
- 混合批次:按批次中最复杂任务级别审查。
- 若发现Critical或Important问题:先解决再继续,修复后重新验证,解决前不进入用户反馈。仅Minor问题:记录后继续第4步。
第4步:报告并请求反馈
代码审查通过后,展示实现内容、验证输出、代码审查摘要(发现并解决的问题)。使用AskUserQuestion工具(不要以纯文本输出)询问:“Batch [N] complete. How should I proceed?”选项:继续下一批、审查变更(显示diff或重新解释)、进行调整。multiSelect为false。等待用户回应后再继续。
第5步:继续
根据反馈应用变更(如需要),执行下一批,重复直到完成。
第6步:完成开发
所有计划任务完成并验证后,将“Complete development (finish-branch)”待办标记为in_progress,宣布使用finish-branch技能,必须调用Skill("workflow:finish-branch"),按该技能验证测试、呈现选项并执行选择,最后标记待办完成。此步骤不可选。
何时停止并求助
立即停止执行的情况:批次中途遇到阻塞(缺少依赖、测试失败、指令不清)、计划存在阻碍开始的关键缺口、不理解某条指令、验证反复失败。应请求澄清而非猜测。
何时回到早期步骤
当合作方根据反馈更新计划,或根本方法需要重新考虑时,回到第1步审阅。不要强行突破阻塞。
集成
任务执行必需技能:tdd(每个任务使用core:tdd先写测试)、verification(标记任务完成前使用core:verification)。必需工作流技能:git-worktrees(在main/master上时用于隔离)、code-review(每批后使用review:code-review)、finish-branch(所有任务后必须使用)。替代工作流:subagent-dev,用于同一会话中为每个任务使用新的子代理执行。
限制
该技能依赖git工作树、子代理派发和特定技能(tdd、verification、git-worktrees、code-review、finish-branch)的可用性。工具与模型名称(如Sonnet、Opus)为资料中指定。具体效果、收费、价格等信息暂未提供。