SuperAPI AI 工具集

subagent-driven-development

编程与开发

查看项目

更新于 10-16 02:06

技能介绍

用途

Subagent-Driven Development 用于在当前会话中执行实现计划,适合任务之间大多相互独立的场景。它通过为每个任务派发一个全新的子智能体,并在每个任务之后进行代码审查,来实现高质量、快速迭代。

核心原则:每个任务使用全新子智能体 + 任务之间进行审查 = 高质量、快速迭代。

与并行会话执行计划的对比

  • 同一会话(无需上下文切换)
  • 每个任务使用全新子智能体(无上下文污染)
  • 每个任务后进行代码审查(及早发现问题)
  • 迭代更快(任务之间无需人工介入)

适用场景

  • 希望留在当前会话中
  • 任务大多相互独立
  • 希望持续进展并带有质量关卡

不适用场景

  • 需要先审查计划(改用 executing-plans)
  • 任务紧密耦合(手动执行更好)
  • 计划需要修订(先进行头脑风暴)

流程

1. 加载计划

读取计划文件,使用 TodoWrite 创建包含所有任务的清单。

2. 使用子智能体执行任务

对每个任务派发全新子智能体:

Task tool (general-purpose):
  description: "Implement Task N: [task name]"
  prompt: |
    You are implementing Task N from [plan-file].

    Read that task carefully. Your job is to:
    1. Implement exactly what the task specifies
    2. Write tests (following TDD if task says to)
    3. Verify implementation works
    4. Commit your work
    5. Report back

    Work from: [directory]

    Report: What you implemented, what you tested, test results, files changed, any issues

子智能体返回工作摘要。

3. 审查子智能体的工作

派发代码审查子智能体:

Task tool (superpowers:code-reviewer):
  Use template at requesting-code-review/code-reviewer.md

  WHAT_WAS_IMPLEMENTED: [from subagent's report]
  PLAN_OR_REQUIREMENTS: Task N from [plan-file]
  BASE_SHA: [commit before task]
  HEAD_SHA: [current commit]
  DESCRIPTION: [task summary]

代码审查者返回:优点、问题(严重/重要/次要)、评估。

4. 应用审查反馈

如果发现问题:

  • 立即修复严重问题
  • 在下一个任务前修复重要问题
  • 记录次要问题

如有需要,派发后续子智能体:

"Fix issues from code review: [list issues]"

5. 标记完成,进入下一任务

在 TodoWrite 中将任务标记为已完成,进入下一个任务,重复步骤 2-5。

6. 最终审查

所有任务完成后,派发最终代码审查者:

  • 审查整个实现
  • 检查所有计划要求是否满足
  • 验证整体架构

7. 完成开发

最终审查通过后:

宣布:"I'm using the finishing-a-development-branch skill to complete this work."

必需子技能:使用 superpowers:finishing-a-development-branch

按照该技能验证测试、呈现选项、执行选择。

示例工作流

你:I'm using Subagent-Driven Development to execute this plan.

[加载计划,创建 TodoWrite]

任务 1:Hook 安装脚本

[派发实现子智能体] 子智能体:已实现 install-hook 及测试,5/5 通过

[获取 git SHA,派发代码审查者] 审查者:优点:测试覆盖良好。问题:无。就绪。

[标记任务 1 完成]

任务 2:恢复模式

[派发实现子智能体] 子智能体:添加 verify/repair,8/8 测试通过

[派发代码审查者] 审查者:优点:扎实。问题(重要):缺少进度报告

[派发修复子智能体] 修复子智能体:每 100 次对话添加进度

[验证修复,标记任务 2 完成]

...

[所有任务完成后] [派发最终代码审查者] 最终审查者:所有要求已满足,可以合并

完成!

优势

相对于手动执行:

  • 子智能体自然遵循 TDD
  • 每个任务使用全新上下文(无混淆)
  • 并行安全(子智能体互不干扰)

相对于执行计划(executing-plans):

  • 同一会话(无需交接)
  • 持续进展(无需等待)
  • 审查检查点自动进行

成本:

  • 更多子智能体调用
  • 但能及早发现问题(比之后调试更便宜)

危险信号

绝不:

  • 跳过任务之间的代码审查
  • 在严重问题未修复的情况下继续
  • 并行派发多个实现子智能体(会冲突)
  • 未阅读计划任务就实现

如果子智能体任务失败:

  • 派发带有具体指令的修复子智能体
  • 不要尝试手动修复(会污染上下文)

集成

必需的工作流技能:

  • writing-plans - 必需:创建此技能所执行的计划
  • requesting-code-review - 必需:每个任务后审查(见步骤 3)
  • finishing-a-development-branch - 必需:所有任务后完成开发(见步骤 7)

子智能体必须使用:

  • test-driven-development - 子智能体为每个任务遵循 TDD

替代工作流:

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

参见代码审查者模板:requesting-code-review/code-reviewer.md