SuperAPI AI 工具集

subagent-driven-development

智能体与模型

查看项目

更新于 10-15 12:11

技能介绍

用途

Subagent-Driven Development 用于在当前会话中执行实现计划,前提是计划中的任务基本相互独立。它的核心原则是:每个任务派发一个全新的子代理,并在每个任务后执行两阶段审查(先规格、后质量),从而实现高质量、快速迭代。

何时使用

根据技能给出的判断流程:

  • 是否已有实现计划?没有则先手动执行或头脑风暴。
  • 任务是否基本独立?若任务紧密耦合,则先手动执行或头脑风暴。
  • 是否留在当前会话?是则使用 subagent-driven-development;若需并行会话,则使用 executing-plans。

与 Executing Plans(并行会话)相比,本技能的特点包括:同一会话(无上下文切换)、每个任务使用全新子代理(无上下文污染)、每个任务后两阶段审查(先规格符合性、后代码质量)、迭代更快(任务之间无需人工介入)。

主要能力与流程

整体流程如下:

  1. 读取计划,提取所有任务的完整文本,记录上下文,创建 TodoWrite。
  2. 对每个任务:
    • 派发实施者子代理(./implementer-prompt.md)。
    • 若实施者子代理提问,则回答问题并提供上下文,然后重新派发。
    • 实施者子代理实施、测试、提交、自审。
    • 派发规格审查者子代理(./spec-reviewer-prompt.md)。
    • 若规格审查者确认代码符合规格,则进入下一步;否则实施者子代理修复规格缺口,并重新审查。
    • 派发代码质量审查者子代理(./code-quality-reviewer-prompt.md)。
    • 若代码质量审查者批准,则在 TodoWrite 中标记任务完成;否则实施者子代理修复质量问题,并重新审查。
  3. 若还有任务,继续下一个任务。
  4. 全部任务完成后,派发最终代码审查者子代理审查整个实现。
  5. 使用 superpowers:finishing-a-development-branch 收尾。

提示词模板

技能提供三个提示词模板:

  • ./implementer-prompt.md - 派发实施者子代理
  • ./spec-reviewer-prompt.md - 派发规格符合性审查者子代理
  • ./code-quality-reviewer-prompt.md - 派发代码质量审查者子代理

使用方式示例

示例工作流中,使用者先读取计划文件(如 docs/plans/feature-plan.md),提取全部 5 个任务及其上下文,创建 TodoWrite。随后逐任务派发实施者子代理,实施者可能先提问(例如钩子应安装在用户级还是系统级),使用者回答后实施者实施、测试、提交并自审。接着派发规格审查者,若发现缺失或多余内容(例如缺少进度报告、多加了未要求的 --json 标志),实施者修复后重新审查。规格通过后派发代码质量审查者,若发现问题(例如魔法数字 100),实施者修复后重新审查,直至批准。所有任务完成后派发最终代码审查者。

优势

相对于手动执行:子代理自然遵循 TDD;每个任务使用全新上下文(避免混淆);可并行安全(子代理互不干扰);子代理可以提问(工作前和工作期间均可)。

相对于 Executing Plans:同一会话(无需交接);持续进展(无需等待);审查检查点自动化。

效率收益:无需读取文件的开销(控制器提供完整文本);控制器精确筛选所需上下文;子代理预先获得完整信息;问题在工作开始前浮现(而非之后)。

质量门禁:自审在交接前发现问题;两阶段审查(先规格符合性、后代码质量);审查循环确保修复真正生效;规格符合性防止过度或不足构建;代码质量确保实现质量良好。

成本:更多子代理调用(每个任务一个实施者加两个审查者);控制器需要更多准备工作(预先提取所有任务);审查循环增加迭代次数;但能尽早发现问题(比后期调试更便宜)。

限制与红线

技能明确列出不应做的事项:

  • 绝不跳过审查(规格符合性或代码质量)。
  • 绝不带着未修复的问题继续。
  • 绝不并行派发多个实施者子代理(会冲突)。
  • 绝不让子代理读取计划文件(应提供完整文本)。
  • 绝不跳过场景设定上下文(子代理需要理解任务所处位置)。
  • 绝不忽略子代理的提问(先回答再让其继续)。
  • 绝不接受规格符合性上的“差不多”(规格审查者发现问题即视为未完成)。
  • 绝不跳过审查循环(审查者发现问题 = 实施者修复 = 再次审查)。
  • 绝不让实施者自审替代实际审查(两者都需要)。
  • 绝不在规格符合性通过前开始代码质量审查(顺序错误)。
  • 绝不在任一审查存在未解决问题时进入下一个任务。

若子代理提问:清晰完整地回答,必要时提供额外上下文,不要催促其进入实施。

若审查者发现问题:由同一实施者子代理修复,审查者再次审查,重复直至批准,不要跳过复审。

若子代理任务失败:派发修复子代理并给出具体指令,不要尝试手动修复(会造成上下文污染)。

集成

必需的工作流技能:

  • superpowers:writing-plans - 创建本技能所执行的计划
  • superpowers:requesting-code-review - 供审查者子代理使用的代码审查模板
  • superpowers:finishing-a-development-branch - 所有任务完成后完成开发

子代理应使用:

  • superpowers:test-driven-development - 子代理对每个任务遵循 TDD

替代工作流:

  • superpowers:executing-plans - 用于并行会话而非同一会话执行

其他限制

仅当任务明确符合上述范围时才使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必需输入、权限、安全边界或成功标准,应停止并请求澄清。