核心机制
子代理驱动开发(Subagent-Driven Development) 是一种将复杂开发计划拆解为独立任务、通过专用子代理逐一执行的工程管理方法。其核心设计遵循「Fresh Subagent Per Task + Two-Stage Review」原则——每个任务启用全新子代理避免上下文污染,完成后依次经过规格合规审查和代码质量审查两道关卡。
执行流程
1. 前置准备:读取完整计划文件,提取所有任务文本及关联上下文,创建 TodoWrite 追踪表
2. 单任务循环:
3. 收尾阶段:全量任务完成后派遣最终代码审查,转入 superpowers:finishing-a-development-branch 完成合并
- 派遣实现子代理(./implementer-prompt.md),支持前置提问澄清需求
- 实现完成后自测、提交、自审
- 第一阶段:派遣规格审查子代理,确认代码严格匹配需求文档(禁止过度/不足实现)
- 第二阶段:派遣代码质量审查子代理,评估设计、可维护性、测试覆盖
- 任一阶段发现问题即退回修复并重新审查
显著优势
- 质量门禁:双阶段审查确保「做对的事」且「把事情做对」
- 上下文隔离:每任务新子代理消除累积混淆,支持子代理主动提问澄清
- 效率优化:控制器一次性提取完整任务文本,避免子代理重复文件IO
- TDD 内置:子代理天然遵循测试驱动开发
局限与风险
- 成本敏感:每任务触发 3 次子代理调用(实现+2审查),审查循环进一步增加开销
- 串行依赖:禁止并行派遣多个实现子代理(避免冲突),严格顺序执行
- 前置要求:必须配合
superpowers:using-git-worktrees隔离工作区,禁止直接在 main/master 分支操作 - 审查顺序强制:规格审查未通过前严禁进入代码质量审查
适用场景
- 已有详细实施计划且任务间相对独立
- 追求代码质量优先于交付速度
- 单会话内完成(对比
executing-plans的跨会话并行模式) - 开发者愿意承担更高 API 调用成本换取早期缺陷拦截
关键禁忌
计划明确列出 12 条「Never」红线,核心包括:禁止跳过任一审查阶段、禁止审查发现问题后直接推进下一任务、禁止子代理自审替代独立审查、禁止忽视子代理前置提问。