SuperAPI AI 工具集

executing-plans

编程与开发

查看项目

更新于 11-13 20:56

技能介绍

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)为资料中指定。具体效果、收费、价格等信息暂未提供。