Skills
skills/zhucl1006/ailesuperpowers/subagent-driven-development

subagent-driven-development

SKILL.md

子代理驅動的開發

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

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

何時使用

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"];
}

與。執行計劃（平行會議）：

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

流程

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 - 用於端點會話而不是相同會話執行
Weekly Installs
5
Repository
zhucl1006/ailes…erpowers
First Seen
Feb 25, 2026
Security Audits
Gen Agent Trust HubPass
SocketPass
SnykPass
Installed on
gemini-cli5
antigravity5
github-copilot5
codex5
kimi-cli5
amp5