SuperAPI AI 工具集

executing-plans

编程与开发

查看项目

更新于 10-15 09:52

技能介绍

用途

executing-plans 用于执行一份已经存在的实现计划,按任务逐项推进,并在每一步进行验证。它适合在已有明确计划文件的前提下,把计划落地为实际代码改动。

主要能力

  • 加载计划文件并对其进行批判性审查,识别其中的疑问或顾虑。
  • 在开始前向协作者提出顾虑;若无顾虑则创建 TodoWrite 并继续。
  • 逐项执行任务:将任务标记为 in_progress,严格按计划中的细粒度步骤操作,按计划指定的方式运行验证,完成后标记为 completed。
  • 全部任务完成并验证后,确认所有测试通过。
  • 根据改动检查项目的 CLAUDE.md 是否需要更新(如新增文件、约定变化、依赖更新);若已过时,在最终确定前提出具体更新建议。
  • 呈现构建内容摘要,并提供后续选项:合并到 main、创建 PR,或清理分支(压缩提交、更新文档)。

使用方式

开始时需声明:“I'm using the executing-plans skill to implement this plan.”

流程分为三步:

  1. 加载并审查计划:读取计划文件,批判性审查,若有顾虑先与协作者沟通,无顾虑则创建 TodoWrite 并继续。
  2. 执行任务:对每个任务标记 in_progress,严格遵循计划步骤,运行指定验证,标记 completed。
  3. 完成开发:验证所有测试通过,检查 CLAUDE.md 是否需要更新,呈现摘要,并提供合并、创建 PR 或清理分支的选项。

该技能在支持子代理的平台上效果最佳(如 Claude Code 或 Codex)。当子代理可用时,建议为每个任务派发一个新的子代理,以获得更高质量的结果。

适用场景

  • 已有一份明确的实现计划,需要按步骤执行。
  • 希望在每个任务后都进行验证,确保质量。
  • 使用支持子代理的平台,并希望按任务派发子代理。

限制与注意事项

遇到以下情况应立即停止执行并求助:

  • 遇到阻塞(缺少依赖、测试失败、指令不清)。
  • 计划存在关键缺口,无法开始。
  • 不理解某条指令。
  • 验证反复失败。

应请求澄清,而不是猜测。

在以下情况应回到第 1 步(审查):

  • 协作者根据反馈更新了计划。
  • 基本方法需要重新思考。

不要强行突破阻塞,应停止并询问。

其他要点:

  • 先批判性审查计划。
  • 严格遵循计划步骤。
  • 不要跳过验证。
  • 当计划要求时引用相关技能。
  • 遇到阻塞时停止,不要猜测。
  • 未经用户明确同意,绝不在 main/master 分支上开始实现。

集成

相关技能与实践:

  • ai-tooling:writing-plans —— 创建本技能所执行的计划。
  • 开始前使用 git worktree 或专用分支隔离工作。
  • 完成后:验证测试通过,然后合并、创建 PR 或清理分支。