subagent-driven-development

name	subagent-driven-development
description	Use when executing an implementation plan with 3+ independent tasks in the current session

Subagent-Driven Development

Type: Technique | Discipline: Rigid

通过 dispatch 独立 subagent 执行 plan 中的每个任务，每个任务完成后进行两阶段审查（规格合规 → 代码质量）。

核心原则： 每任务一个新鲜 subagent + 两阶段审查（规格 → 质量）= 高质量、快迭代

何时使用

有 plan 文件?
  ├─ NO  → writing-plans 先产出 plan
  └─ YES → 任务数 ≥ 3 且大部分独立?
             ├─ NO  → 手动实施 + sdk-code-review
             └─ YES → 本 skill

流程

读取 plan，提取所有任务全文
  ↓
[Per Task]
  记录 BASE_SHA
  ↓
  Dispatch 实现者 subagent（./implementer-prompt.md）
  ↓
  实现者提问？ ──yes──→ 回答问题 → 重新 dispatch
  │no
  ↓
  实现者实现、测试、提交
  ↓
  记录 HEAD_SHA
  ↓
  Dispatch 规格审查者（./spec-reviewer-prompt.md）
  ↓
  规格合规？ ──no──→ 重新 dispatch 实现者修复 → 重新规格审查
  │yes
  ↓
  Dispatch 质量审查者（./code-quality-reviewer-prompt.md）
  ↓
  质量通过？ ──no──→ 重新 dispatch 实现者修复 → 重新质量审查
  │yes
  ↓
  标记任务完成
[/Per Task]
  ↓
verification-before-completion（全量构建 + 测试）
  ↓
Dispatch 全局 sdk-code-review skill（模式 A: spec-reviewer + code-reviewer）
  ↓
finishing-a-development-branch

模型选择

任务特征	推荐模型
1-2 文件、清晰规格、机械实现	haiku
多文件协调、集成逻辑	sonnet
架构、设计和审查任务	opus

处理实现者状态

• DONE → 进入规格合规审查
• DONE_WITH_CONCERNS → 先读疑虑再决定
• NEEDS_CONTEXT → 补充上下文，重新 dispatch
• BLOCKED → 评估：上下文不足 / 需要更强模型 / 任务太大 / plan 有问题

Prompt 模板

• ./implementer-prompt.md
• ./spec-reviewer-prompt.md
• ./code-quality-reviewer-prompt.md

上下文构造原则

• 粘贴全文：任务描述从 plan 中提取完整文本粘贴进 prompt，不让 subagent 自己读文件
• 提供场景设置：任务在整体 plan 中的位置、前序任务完成了什么、依赖关系

Rationalizations

Excuse	Reality
"这个任务简单，我自己直接改"	控制器不写代码——隔离是防 context 污染，不只是并行
"并行 dispatch 多个实现者更快"	明确禁止，会冲突
"自审过就不用 spec-reviewer"	自审替代不了独立审查
"先质量审，spec 回头再补"	顺序不可颠倒
"上一任务的小问题带到下一任务再修"	带病进下一任务 = 累积漂移
"让 subagent 自己读 plan 省事"	必须粘贴全文，避免上下文不一致

关联 skill

• 上游： writing-plans + plan-document-review
• 完成后： verification-before-completion → sdk-code-review → finishing-a-development-branch