SuperAPI AI 工具集

executing-plans

编程与开发

查看项目

更新于 10-15 09:59

技能介绍

用途

executing-plans 是一个用于执行已编写实施计划的技能。它适用于当你有一份书面实施计划,需要在独立会话中执行,并在批次之间设置审查检查点的场景。其核心原则是:分批执行,并在每批之间设置检查点供架构师审查。

主要能力

  • 加载并批判性审查实施计划。
  • 按批次执行计划中的任务,默认每批执行前 3 个任务。
  • 对每个任务标记状态(进行中、已完成),严格遵循计划中的细粒度步骤,并运行计划指定的验证。
  • 在每批完成后报告实现内容与验证输出,并等待反馈。
  • 根据反馈调整后继续执行下一批,直至全部完成。
  • 全部任务完成并验证后,衔接收尾技能完成开发分支。

使用方式

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

流程分为五步:

  1. 加载并审查计划:读取计划文件,批判性审查,识别疑问或顾虑。若有顾虑,先向人类伙伴提出;若无顾虑,创建 TodoWrite 并继续。
  2. 执行批次:默认执行前 3 个任务。对每个任务,标记为 in_progress,严格按步骤执行,运行指定验证,标记为 completed。
  3. 报告:批次完成后,展示已实现内容与验证输出,并说:“Ready for feedback.”
  4. 继续:根据反馈,必要时应用更改,执行下一批,重复直至完成。
  5. 完成开发:所有任务完成并验证后,声明:“I'm using the finishing-a-development-branch skill to complete this work.” 必须使用 superpowers:finishing-a-development-branch 子技能,按该技能验证测试、呈现选项并执行选择。

适用场景

  • 已有书面实施计划,需要在独立会话中分批执行。
  • 需要在批次之间设置审查检查点,由架构师或人类伙伴提供反馈。
  • 计划包含细粒度步骤和明确的验证方式。

限制与注意事项

遇到以下情况应立即停止执行并求助:批次中途遇到阻塞(缺少依赖、测试失败、指令不清);计划存在关键缺口导致无法开始;不理解某条指令;验证反复失败。应请求澄清而非猜测。

以下情况应返回第 1 步重新审查:伙伴根据反馈更新了计划;根本方法需要重新思考。不要强行突破阻塞,应停止并询问。

其他要点:先批判性审查计划;严格遵循计划步骤;不要跳过验证;计划要求时引用相应技能;批次之间只报告并等待;遇到阻塞时停止,不要猜测;未经用户明确同意,绝不在 main/master 分支上开始实施。

集成

所需工作流技能:

  • superpowers:using-git-worktrees —— 必需:开始前设置隔离工作区。
  • superpowers:writing-plans —— 创建本技能所执行的计划。
  • superpowers:finishing-a-development-branch —— 所有任务完成后完成开发。