用途
子智能体驱动开发用于在当前会话中执行一份包含独立任务的实现计划。它通过为每个任务分派一个全新的子智能体来完成实现,从而让每个任务拥有隔离的上下文,避免上下文污染,同时为主会话保留用于协调工作的上下文。
核心原则与主要能力
- 每个任务一个全新子智能体。
- 每个任务完成后进行两阶段审查:先审查规格合规性,再审查代码质量。
- 子智能体不继承主会话上下文或历史记录,由控制者精确构造其所需的一切信息。
- 任务间无需人工介入,迭代更快。
何时使用
根据资料中的判断流程:
- 有实现计划,且任务基本独立,并且留在当前会话 → 使用 subagent-driven-development。
- 无实现计划 → 手动执行或先头脑风暴。
- 任务紧密耦合 → 手动执行或先头脑风暴。
- 任务基本独立但需并行会话 → 使用 executing-plans 替代。
与 Executing Plans(并行会话)的对比:同一会话(无上下文切换)、每个任务全新子智能体(无上下文污染)、每个任务后两阶段审查、更快的迭代(任务间无需人工介入)。
流程
- 读取计划,提取所有任务的完整文本,记录上下文,创建 TodoWrite。
- 对每个任务:
- 分派实现子智能体(./implementer-prompt.md)。
- 若实现子智能体有疑问,回答问题并提供上下文,再重新分派。
- 实现子智能体进行实现、测试、提交、自审。
- 分派规格审查子智能体(./spec-reviewer-prompt.md)。若未匹配规格,由实现子智能体修复规格差距后重新审查。
- 规格通过后,分派代码质量审查子智能体(./code-quality-reviewer-prompt.md)。若未通过,由实现子智能体修复质量问题后重新审查。
- 通过后在 TodoWrite 中标记任务完成。
- 若还有剩余任务,继续下一个任务。
- 所有任务完成后,分派最终代码审查子智能体审查整体实现。
- 使用 superpowers:finishing-a-development-branch 收尾。
模型选择
使用能胜任每个角色的最低成本模型,以节省开支并提高速度。
- 机械性实现任务(隔离的函数、清晰的规格、1-2 个文件):使用快速、便宜的模型。当计划足够详细时,大多数实现任务都是机械性的。
- 集成和判断类任务(多文件协调、模式匹配、调试):使用标准模型。
- 架构、设计和审查类任务:使用最强的可用模型。
任务复杂度信号:
- 涉及 1-2 个文件且有完整规格 → 便宜模型。
- 涉及多个文件且有集成考虑 → 标准模型。
- 需要设计判断或广泛的代码库理解 → 最强模型。
处理实现者状态
实现子智能体报告四种状态之一:
- DONE:进入规格合规性审查。
- DONE_WITH_CONCERNS:实现者完成了工作但标记了疑虑。继续前阅读这些疑虑。若涉及正确性或范围,在审查前解决;若只是观察性说明,记录下来并继续审查。
- NEEDS_CONTEXT:实现者需要未提供的信息。提供缺失的上下文并重新分派。
- BLOCKED:实现者无法完成任务。评估阻塞原因:若为上下文问题,提供更多上下文并用同一模型重新分派;若任务需要更强推理能力,用更强的模型重新分派;若任务太大,拆分为更小的部分;若计划本身有问题,上报给人类。
资料强调:绝不忽略上报或在不做任何更改的情况下让同一模型重试。
提示词模板
- ./implementer-prompt.md - 分派实现子智能体
- ./spec-reviewer-prompt.md - 分派规格合规审查子智能体
- ./code-quality-reviewer-prompt.md - 分派代码质量审查子智能体
适用场景与优势
与手动执行相比:子智能体自然遵循 TDD;每个任务全新上下文(不会混淆);并行安全(子智能体不会互相干扰);子智能体可以提问(工作前和工作中都可以)。
与 Executing Plans 相比:同一会话(无交接);持续进展(无需等待);审查检查点自动化。
效率提升:无文件读取开销(控制者提供完整文本);控制者精确策划所需上下文;子智能体预先获得完整信息;问题在工作开始前就被提出。
质量关卡:自审在交接前发现问题;两阶段审查(规格合规性、代码质量);审查循环确保修复确实有效;规格合规防止过度/不足构建;代码质量确保实现良好。
限制与成本
- 更多子智能体调用(每个任务需要实现者 + 2 个审查者)。
- 控制者需要更多准备工作(预先提取所有任务)。
- 审查循环增加迭代次数。
- 但能及早发现问题(比后期调试更省成本)。
红线
资料列出的禁止事项包括:未经用户明确同意就在 main/master 分支上开始实现;跳过审查(规格合规性或代码质量);带着未修复的问题继续;并行分派多个实现子智能体(会冲突);让子智能体读取计划文件(应提供完整文本);跳过场景铺设上下文;忽视子智能体的问题;在规格合规性上接受“差不多就行”;跳过审查循环;让实现者的自审替代正式审查;在规格合规性审查通过之前开始代码质量审查;在任一审查有未解决问题时就进入下一个任务。
处理原则:如果子智能体提问,清晰完整地回答、必要时提供额外上下文、不要催促它们进入实现阶段;如果审查者发现问题,由同一实现子智能体修复,审查者再次审查,重复直到通过,不要跳过重新审查;如果子智能体失败,分派修复子智能体并提供具体指令,不要尝试手动修复(上下文污染)。
集成
必需的工作流技能:
- superpowers:using-git-worktrees - 必需:在开始前建立隔离工作区
- superpowers:writing-plans - 创建本技能执行的计划
- superpowers:requesting-code-review - 审查子智能体的代码审查模板
- superpowers:finishing-a-development-branch - 所有任务完成后收尾
子智能体应使用:
- superpowers:test-driven-development - 子智能体对每个任务遵循 TDD
替代工作流:
- superpowers:executing-plans - 用于并行会话而非同会话执行
资料未提供的信息
本技能的具体收费、价格、平台支持范围与安装命令,资料中暂未提供。