---
name: subagent-driven-development
description: 在當前會話中執行具有獨立任務的實施計劃時使用
---

# 子代理驅動的開發

通過為每個任務派遣新的子代理來執行計劃，每個任務之後進行兩階段審查：首先進行規範合規性審查，然後進行代碼質量審查。

**核心原則：** 每個任務新鮮的子代理+兩階段審查（規格然後質量）=高質量，快速迭代

## 何時使用

```dot
digraph when_to_use {
    "Have implementation plan?" [shape=diamond];
    "Tasks mostly independent?" [shape=diamond];
    "Stay in this session?" [shape=diamond];
    "subagent-driven-development" [shape=box];
    "executing-plans" [shape=box];
    "Manual execution or brainstorm first" [shape=box];

    "Have implementation plan?" -> "Tasks mostly independent?" [label="yes"];
    "Have implementation plan?" -> "Manual execution or brainstorm first" [label="no"];
    "Tasks mostly independent?" -> "Stay in this session?" [label="yes"];
    "Tasks mostly independent?" -> "Manual execution or brainstorm first" [label="no - tightly coupled"];
    "Stay in this session?" -> "subagent-driven-development" [label="yes"];
    "Stay in this session?" -> "executing-plans" [label="no - parallel session"];
}
```

**與。執行計劃（平行會議）：**
- 同一會話（無上下文切換）
- 每個任務都有新的子代理（無上下文污染）
- 每項任務後進行兩階段審查：首先是規範合規性，然後是程式碼品質
- 更快的迭代（任務之間沒有人在循環）

## 流程

```dot
digraph process {
    rankdir=TB;

    subgraph cluster_per_task {
        label="Per Task";
        "Dispatch implementer subagent (./implementer-prompt.md)" [shape=box];
        "Implementer subagent asks questions?" [shape=diamond];
        "Answer questions, provide context" [shape=box];
        "Implementer subagent implements, tests, commits, self-reviews" [shape=box];
        "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [shape=box];
        "Spec reviewer subagent confirms code matches spec?" [shape=diamond];
        "Implementer subagent fixes spec gaps" [shape=box];
        "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [shape=box];
        "Code quality reviewer subagent approves?" [shape=diamond];
        "Implementer subagent fixes quality issues" [shape=box];
        "Mark task complete in TodoWrite" [shape=box];
    }

    "Read plan, extract all tasks with full text, note context, create TodoWrite" [shape=box];
    "More tasks remain?" [shape=diamond];
    "Dispatch final code reviewer subagent for entire implementation" [shape=box];
    "Use superpowers:finishing-a-development-branch" [shape=box style=filled fillcolor=lightgreen];

    "Read plan, extract all tasks with full text, note context, create TodoWrite" -> "Dispatch implementer subagent (./implementer-prompt.md)";
    "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
    "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
    "Answer questions, provide context" -> "Dispatch implementer subagent (./implementer-prompt.md)";
    "Implementer subagent asks questions?" -> "Implementer subagent implements, tests, commits, self-reviews" [label="no"];
    "Implementer subagent implements, tests, commits, self-reviews" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)";
    "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" -> "Spec reviewer subagent confirms code matches spec?";
    "Spec reviewer subagent confirms code matches spec?" -> "Implementer subagent fixes spec gaps" [label="no"];
    "Implementer subagent fixes spec gaps" -> "Dispatch spec reviewer subagent (./spec-reviewer-prompt.md)" [label="re-review"];
    "Spec reviewer subagent confirms code matches spec?" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="yes"];
    "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" -> "Code quality reviewer subagent approves?";
    "Code quality reviewer subagent approves?" -> "Implementer subagent fixes quality issues" [label="no"];
    "Implementer subagent fixes quality issues" -> "Dispatch code quality reviewer subagent (./code-quality-reviewer-prompt.md)" [label="re-review"];
    "Code quality reviewer subagent approves?" -> "Mark task complete in TodoWrite" [label="yes"];
    "Mark task complete in TodoWrite" -> "More tasks remain?";
    "More tasks remain?" -> "Dispatch implementer subagent (./implementer-prompt.md)" [label="yes"];
    "More tasks remain?" -> "Dispatch final code reviewer subagent for entire implementation" [label="no"];
    "Dispatch final code reviewer subagent for entire implementation" -> "Use superpowers:finishing-a-development-branch";
}
```

## 提示模板

- `./implementer-prompt.md`- 調度實施者子代理
- `./spec-reviewer-prompt.md`- 派遣規範合規審查員子代理
- `./code-quality-reviewer-prompt.md`- 派遣代碼質量審核員子代理

## 示例工作流程

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

[Read plan file once: docs/plans/feature-plan.md]
[Extract all 5 tasks with full text and context]
[Create TodoWrite with all tasks]

Task 1: Hook installation script

[Get Task 1 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]

Implementer: "Before I begin - should the hook be installed at user or system level?"

You: "User level (~/.config/superpowers/hooks/)"

Implementer: "Got it. Implementing now..."
[Later] Implementer:
  - Implemented install-hook command
  - Added tests, 5/5 passing
  - Self-review: Found I missed --force flag, added it
  - Committed

[Dispatch spec compliance reviewer]
Spec reviewer: ✅ Spec compliant - all requirements met, nothing extra

[Get git SHAs, dispatch code quality reviewer]
Code reviewer: Strengths: Good test coverage, clean. Issues: None. Approved.

[Mark Task 1 complete]

Task 2: Recovery modes

[Get Task 2 text and context (already extracted)]
[Dispatch implementation subagent with full task text + context]

Implementer: [No questions, proceeds]
Implementer:
  - Added verify/repair modes
  - 8/8 tests passing
  - Self-review: All good
  - Committed

[Dispatch spec compliance reviewer]
Spec reviewer: ❌ Issues:
  - Missing: Progress reporting (spec says "report every 100 items")
  - Extra: Added --json flag (not requested)

[Implementer fixes issues]
Implementer: Removed --json flag, added progress reporting

[Spec reviewer reviews again]
Spec reviewer: ✅ Spec compliant now

[Dispatch code quality reviewer]
Code reviewer: Strengths: Solid. Issues (Important): Magic number (100)

[Implementer fixes]
Implementer: Extracted PROGRESS_INTERVAL constant

[Code reviewer reviews again]
Code reviewer: ✅ Approved

[Mark Task 2 complete]

...

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

Done!
```

## 優點

**與。手動執行：**
- 子代理自然地遵循TDD
- 每個任務都有新鮮的背景（沒有混淆）
- 並行安全（子代理不幹擾）
- 子代理可以提問（工作之前和工作期間）

**與。執行計劃：**
- 同一會話（無切換）
- 持續進步（無需等待）
- 自動審查檢查點

**效率提升：**
- 無檔案讀取開銷（控制器提供全文）
- 控制器準確地規劃所需的上下文
- 子代理預先取得完整資訊
- 問題在工作開始之前（而不是之後）出現

**質量門：**
- 移交前自我審查發現問題
- 兩階段審查：規範合規性，然後是代碼質量
- 審查循環確保修復確實有效
- 符合規範可防止過度建設/建設不足
- 代碼品質確保實施良好

**成本：**
- 更多子代理呼叫（每個任務的實施者 + 2 個審閱者）
- 控制器做更多的準備工作（預先提取所有任務）
- 審查循環添加迭代
- 但儘早發現問題（比稍後調試便宜）

## 危險信號

**絕不：**
- 在使用者明確同意的情況下開始在 main/master 分支上實施
- 跳過審查（規範合規性或程式碼品質）
- 繼續處理未解決的問題
- 並行調度多個實施子代理（衝突）
- 讓子代理程式讀取計劃檔案（改為提供全文）
- 跳過場景設定上下文（子代理程式需要了解任務適合的位置）
- 忽略子代理問題（在繼續之前回答）
- 接受規範合規性“足夠接近”（規範審核者發現問題=未完成）
- 跳過審核循環（審核者發現問題 = 實施者修復 = 再次審核）
- 讓實施者自我審查取代實際審查（兩者都需要）
- **在規範合規性為✅**之前開始代碼質量審查（順序錯誤）
- 當任一審核有未解決的問題時移至下一個任務

**如果子代理提出問題：**
- 回答清楚、完整
- 如果需要，提供額外的上下文
- 不要急於實施

**如果審閱者發現問題：**
- 實施者（同一子代理）修復它們
- 審稿者再次審稿
- 重複直至獲得批准
- 不要跳過重新審核

**如果子代理任務失敗：**
- 調度帶有特定說明的修復子代理
- 不要嘗試手動修復（上下文污染）

## 一體化

**所需的工作流程技能：**
- **超級能力：使用-git-worktrees** - 必需：在開始之前設置隔離的工作區
- **超級大國：寫作計劃** - 創建該技能執行的計劃
- **superpowers:requesting-code-review** - 審閱者子代理方案的方案碼審閱模板
- **超級大國：完成開發分支** - 在完成所有任務後完成開發

**子代理應使用：**
- **超級能力：測試驅動開發** - 子代理程式遵循TDD執行每項任務

**替代工作流程：**
- **superpowers:executing-plans** - 用於端點會話而不是相同會話執行