mcpField
S
subagent-driven-development

subagent-driven-development

github.com/jackspaceAgent 工作流1640 次安装12 周前更新
代码仓库

关于 subagent-driven-development

subagent-driven-development 是按计划逐项派发新 Subagent 执行任务,并在每项后进行代码审查的开发工作流技能。适用于任务大致独立、希望在同一会话中持续推进并设质量关卡的场景。

主要功能

  1. 01按计划逐项派发新 Subagent
  2. 02每项任务后进行代码审查
  3. 03依据审查意见修复问题
  4. 04完成所有任务后进行最终审查
  5. 05要求配合计划、测试与收尾技能

适用场景

  1. 01在同一会话执行多个独立开发任务
  2. 02通过逐项审查及早发现代码问题
  3. 03按既定计划推进实现与测试

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jackspace/claudeskillz --skill subagent-driven-development

安装后在 Claude Code 中输入/subagent-driven-development确认已加载。

附带文件SKILL.json

详细介绍

子 Agent 驱动开发

通过为每项任务派遣一个全新的子 Agent 来执行计划,并在每项任务后进行代码审查。

核心原则: 每项任务使用全新的子 Agent + 任务间进行审查 = 高质量、快速迭代

概览

与执行计划(并行会话)相比:

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

适用场景:

  • 在当前会话中继续
  • 任务大多彼此独立
  • 希望持续推进,同时设置质量关卡

不适用场景:

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

流程

1. 加载计划

读取计划文件,并使用 TodoWrite 创建包含所有任务的待办事项。

2. 使用子 Agent 执行任务

对于每项任务:

派遣全新的子 Agent:

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

子 Agent 返回工作摘要。

3. 审查子 Agent 的工作

派遣代码审查员子 Agent:

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. 处理审查反馈

如果发现问题:

  • 立即修复严重问题
  • 进入下一项任务前修复重要问题
  • 记录轻微问题

必要时派遣后续子 Agent:

"Fix issues from code review: [list issues]"
5. 标记完成,继续下一项任务
  • 在 TodoWrite 中将任务标记为已完成
  • 继续下一项任务
  • 重复步骤 2–5
6. 最终审查

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

  • 审查整个实现
  • 检查是否满足所有计划要求
  • 验证整体架构
7. 完成开发

最终审查通过后:

  • 宣布:“我将使用 finishing-a-development-branch 技能来完成这项工作。”
  • 必需的子技能: 使用 superpowers:finishing-a-development-branch
  • 按照该技能验证测试、提供选项并执行所选方案

工作流示例

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

[Load plan, create TodoWrite]

Task 1: Hook installation script

[Dispatch implementation subagent]
Subagent: Implemented install-hook with tests, 5/5 passing

[Get git SHAs, dispatch code-reviewer]
Reviewer: Strengths: Good test coverage. Issues: None. Ready.

[Mark Task 1 complete]

Task 2: Recovery modes

[Dispatch implementation subagent]
Subagent: Added verify/repair, 8/8 tests passing

[Dispatch code-reviewer]
Reviewer: Strengths: Solid. Issues (Important): Missing progress reporting

[Dispatch fix subagent]
Fix subagent: Added progress every 100 conversations

[Verify fix, mark Task 2 complete]

...

[After all tasks]
[Dispatch final code-reviewer]
Final reviewer: All requirements met, ready to merge

Done!

优势

与手动执行相比:

  • 子 Agent 会自然地遵循 TDD
  • 每项任务都使用全新上下文(避免混淆)
  • 支持并行处理(子 Agent 互不干扰)

与执行计划相比:

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

成本:

  • 调用子 Agent 的次数更多
  • 但能及早发现问题(比之后调试成本更低)

危险信号

切勿:

  • 跳过任务间的代码审查
  • 带着未修复的严重问题继续推进
  • 并行派遣多个实现子 Agent(会产生冲突)
  • 不阅读计划任务就开始实现

如果子 Agent 未能完成任务:

  • 按照具体说明派遣修复子 Agent
  • 不要尝试手动修复(会污染上下文)

集成

必需的工作流技能:

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

子 Agent 必须使用:

  • test-driven-development - 子 Agent 为每项任务遵循 TDD

替代工作流:

  • executing-plans - 使用并行会话,而非在同一会话中执行

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

评论

支持 Markdown