subagent-driven-development

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

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "subagent-driven-development" with this command: npx skills add zhucl1006/ailesuperpowers/zhucl1006-ailesuperpowers-subagent-driven-development

子代理驅動的開發

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

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

何時使用

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 - 用於端點會話而不是相同會話執行

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

aile-subagent-dev

No summary provided by upstream source.

Repository SourceNeeds Review
18-zhucl1006
Coding

aile-code-review

No summary provided by upstream source.

Repository SourceNeeds Review
12-zhucl1006
Coding

requesting-code-review

No summary provided by upstream source.

Repository SourceNeeds Review
6-zhucl1006
Coding

receiving-code-review

No summary provided by upstream source.

Repository SourceNeeds Review
5-zhucl1006