Subagent Development

🤖 子代理执行+双阶段审查,高质量交付

通过为每个任务派遣独立子代理,并严格执行规格审查+代码质量双阶段评审,实现高质量、快速迭代的开发执行。

收藏
7.7k
安装
1.5k
版本
1.0.0
CLS 安全性认证2026-08-03
点击查看完整报告 >

使用说明

核心用法

Subagent-Driven Development 是一种在同一会话内执行独立任务的开发工作流。其核心机制为:每个任务派遣全新子代理 + 双阶段审查(规格合规优先,代码质量次之)

操作流程分为三个阶段:

1. 准备阶段:一次性读取计划文件,提取所有任务完整文本与上下文,创建 TodoWrite 清单
2. 单任务循环

3. 收尾阶段:所有任务完成后,派遣最终代码审查子代理,通过后使用 finishing-a-development-branch 技能完成

  • 派遣实现子代理(./implementer-prompt.md),支持前置问答环节
  • 子代理完成实现、测试、提交、自评
  • 阶段一:派遣规格审查子代理,确认代码完全符合需求规格
  • 阶段二:派遣代码质量审查子代理,评估代码质量与最佳实践
  • 任一阶段发现问题,由原实现子代理修复后重新审查

显著优点

  • 上下文纯净:每个子代理独立启动,避免任务间上下文污染
  • 缺陷早发现:双阶段审查机制在任务级别拦截规格偏差与代码质量问题
  • 并行安全:串行执行设计避免多实现子代理冲突
  • 成本可控:问题在任务级解决,远早于集成后调试的修复成本
  • 流程标准化:强制审查节点消除"差不多就行"的主观判断

潜在局限

  • 子代理调用成本高:每个任务需 3 次子代理调用(实现+双审查),复杂任务可能因审查循环进一步增加
  • 前置工作量大:控制器需一次性提取所有任务文本与上下文
  • 串行效率瓶颈:禁止并行派遣实现子代理,大规模任务集执行时间较长
  • 依赖计划质量:计划本身缺陷无法通过此技能弥补
  • 学习曲线陡峭:双阶段审查顺序、循环机制等规则需严格遵守

适合人群

  • 需要高质量交付的中大型功能开发
  • 已有清晰计划文档的独立任务集
  • 追求代码可维护性的团队场景
  • 愿意权衡成本换质量的关键路径功能

不适合:快速原型验证、计划模糊、成本敏感或追求极致速度的场景。

常规风险

| 风险点 | 说明 |
|--------|------|
| 审查顺序错误 | 必须先规格后质量,颠倒会导致无效返工 |
| 跳过重新审查 | 修复后必须让原审查子代理再审,不可直接通过 |
| 子代理自评替代 | 子代理自评与独立审查缺一不可 |
| 并行派遣实现 | 会导致代码冲突,必须严格串行 |
| 未回答子代理问题 | 强行推进将引入理解偏差 |
| 忽视"close enough" | 规格审查发现问题即视为未完成 |

安全提示:本技能为流程编排型技能,本身不直接执行代码,但子代理可能生成并执行代码,需确保执行环境可信。

安全解读

核心用法

Subagent-Driven Development 是一种结构化的 Agent 工作流方法论,用于在当前会话内执行独立的实现计划。其核心操作模式为:主 Agent 读取完整计划后,为每个任务创建全新的子代理(Implementer Subagent),任务完成后立即触发双阶段审查——先进行规范合规审查(Spec Compliance Review),通过后进入代码质量审查(Code Quality Review),两项审查均通过方可标记任务完成。

该 Skill 提供三个关键提示词模板:implementer-prompt.md 用于调度实现者子代理,spec-reviewer-prompt.md 用于规范审查,code-quality-reviewer-prompt.md 用于质量审查。主控制器需一次性提取所有任务文本和上下文,避免子代理重复读取文件,确保信息完整传递。子代理在执行前可提出问题,主控制器需澄清后再继续,防止方向偏差。

显著优点

质量保障机制完善:双阶段审查形成双重质量关卡,规范审查防止过度开发或遗漏需求,质量审查确保代码可维护性,审查循环机制保证问题真正修复。

上下文隔离优化:每个任务使用全新子代理,避免上下文污染和记忆累积导致的混淆,特别适合复杂多模块项目。主控制器精准筛选上下文,减少子代理的认知负荷。

开发效率提升:相比人工执行,子代理天然遵循 TDD 流程;相比并行会话方案(Executing Plans),无需上下文切换,迭代速度更快,无需人工介入等待。

风险前置识别:子代理提问环节将潜在问题暴露在工作开始前,降低返工成本;自我审查+独立审查的双重机制,减少缺陷逃逸。

潜在缺点与局限性

成本开销显著:每个任务需调用 1 个实现子代理 + 2 个审查子代理,若审查不通过还需额外迭代,Token 消耗和 API 调用成本高于简单方案。

前置准备繁重:主控制器需预先提取所有任务文本、整理上下文、创建 TodoWrite,初期准备工作量较大。

适用场景受限:仅适合任务相对独立的计划,强耦合模块需人工拆解或改用其他方案;不适用于需要跨任务并行开发的场景。

学习曲线陡峭:需理解子代理调度逻辑、审查顺序约束、提示词模板定制等概念,对初次使用者不够友好。

适合的目标群体

  • 需要执行复杂、多阶段开发计划的资深开发者
  • 追求代码质量优先于开发速度的严谨型团队
  • 已掌握 superpowers:writing-planssuperpowers:requesting-code-review 等前置 Skill 的用户
  • 使用 OpenClaw / Moltbot / Clawbot 等支持子代理调度的 Agent 平台的开发者

使用风险

性能风险:多轮子代理调用和审查迭代可能导致响应延迟,在高并发场景下需关注 API 速率限制。

依赖风险:该 Skill 依赖特定 Agent 平台的子代理功能,迁移成本较高;需配合其他 Superpowers 系列 Skill 使用,存在版本兼容性问题。

流程僵化风险:严格的双阶段审查顺序(必须先规范后质量)若被违反,可能导致审查遗漏;跳过审查环节将完全丧失质量保障。

上下文管理风险:若主控制器未能完整提取任务文本或提供充足上下文,子代理可能误解需求,导致实现偏差。

Subagent Development 内容

手动下载zip · 7.9 kB
code-quality-reviewer-prompt.mdtext/markdown
请选择文件