subagent-driven-development
面向 Claude Code 的「子代理驱动开发」方法论：把实现计划拆成任务，每个任务派一个全新上下文的 implementer 子代理实现，再派独立 reviewer 做规格合规与代码质量双门审查，最多 5 轮修复循环后做整分支终审，全程用文件交接、用 ledger 记账，让 agent 高质量执行长计划且不怕会话压缩。
仓库：obra/superpowers
热度证据：所属仓库 obra/superpowers 271402 star，Claude Code 官方插件市场可装，社区最火开发方法论
五维评分
热度5/5
质量5/5
创新5/5
易用3/5
文档5/5
优秀点拆解
- 上下文隔离第一性：每个任务派全新子代理，一切交接走文件（task-brief 提取任务原文、review-package 打包 diff），主会话上下文永远干净，实测防住 42k 字符的 dispatch 灾难
- 双门独立审查：reviewer 对 diff 说话、不信 implementer 报告，spec compliance（missing/extra/misunderstood）+ code quality 分 Critical/Important/Minor 三级并强制 file:line 证据
- 修复循环带硬止损：最多 5 轮，1-3 轮 resume 原 implementer、4-5 轮换新子代理并升级模型，第 5 轮仍不过触发 breaker 由 controller 逐条裁决并写 ruling，杜绝无限重试
- 防会话压缩的 ledger 协议：每个完成/修复轮次/裁决都记入 plan 级 git-ignored 工作区，恢复时以 ledger+git log 为准，根治「压缩后重派整个已完成任务序列」这一最贵故障
- 反模式清单+决策图：Common Rationalizations 表把 9 个偷懒借口预先审判，When to Use 决策图防误用，是方法论文档的天花板写法
可复用的设计模式
- 文件即接口的 artifacts 流水线：中间产物落盘到 plan 级 git-ignored 目录，子代理只读文件、只回短状态行，同时解决上下文污染与会话压缩丢失
- 上限+断路器+升级路径的循环控制：任何 agent 循环设硬上限、上限前有升级路径（resume→换人换模型）、到顶由有全局视野的一方裁决
- 角色 prompt 模板固化分工契约：implementer/reviewer/re-reviewer 各自独立模板+占位符接口+no-subagents 边界声明
- 预审+记账双层质量网：开工前 plan 冲突扫描写成表格（不是一句话结论），执行中所有例外决策必须落账并在收尾全量上报用户
适用场景
多任务实现计划的批量执行：任务间基本独立、需要质量兜底的功能开发，如按 plan 文件实现整条 feature 分支需要独立代码审查把关的 agent 工作流：不想人工逐任务审查，但要保证规格合规与代码质量的自动化执行长会话/跨天执行的大工程：利用 ledger+git 恢复机制应对上下文压缩，多轮接力完成大计划
边界与注意：依赖支持子代理派发/resume、git worktree 和按任务选模型的 harness（如 Claude Code），且深度依赖 superpowers 全家桶（worktrees/review/finishing 等兄弟 skill），单独抽取需补齐前置；任务高度耦合的探索型工作不适合（SKILL.md 决策图明确指向手工执行）；术语多、流程复杂，上手门槛偏高
完整拆解分析文档
本页为摘要版，完整精读分析（核心机制、逐条优秀点拆解、写作过程）见本地 Markdown 文档：
analysis/superpowers-subagent-driven-development.md