Subagent Dev
📖 技能介紹
name: superpowers-subagent-dev description: Use when executing implementation plans with independent tasks - coordinates task execution by dispatching subagents per task with verification checkpoints, adapted for OpenClaw's isolated session model
Superpowers Subagent 開發（OpenClaw 適配版）
概述
通過為每個任務 dispatch 獨立 subagent 來執行計劃，每個任務後進行兩階段審查：先審查規格合規，再審查程式碼質量。
為什麼用 subagent： 將任務委託給專門 agent，隔離上下文。通過精確構造指令和上下文，確保它們專注併成功完成。Subagent 不應繼承 session 歷史——精確構造它們需要的上下文。
核心原則： 每個任務新鮮 subagent + 兩階段審查（規格合規 → 程式碼質量）
OpenClaw 適配說明
Superpowers 原版設計基於 Claude Code 的 Task/subagent 級聯模型。OpenClaw 使用 sessions_spawn 建立獨立 session，無法做到原生級聯。
OpenClaw 適配方案：
- 主 agent 作為 controller，協調所有工作
- 用 sessions_spawn(mode="run") dispatch 一次性任務 subagent
- Subagent 結果通過 session 歷史或檔案系統傳遞
- 審查在主 session 內 inline 執行（或 spawn 獨立審查 session）
- 複雜審查任務用 sessions_spawn
使用條件
有實現計劃？
→ 任務大多獨立？
→ 在本 session 內工作？
→ 用 subagent-dev（這個技能）
→ 並行獨立 session？
→ 用 sessions_spawn 並行 dispatch
→ 手動執行或先 brainstorming
流程
每次任務
- 讀取計劃，提取所有任務
- 讀取計劃檔案一次
- 提取所有任務及其完整文本和上下文
-
建立任務列表
-
Dispatch 實現者 subagent ``` 使用 sessions_spawn:
- mode: "run"（一次性任務）
- task: 完整任務文本 + 上下文
-
cwd: 專案目錄 ```
-
Subagent 提問處理
- 如果 subagent 提問 → 回答問題，提供上下文
-
重新 dispatch 或繼續
-
Subagent 實現、測試、commit、自審
- 實現者完成工作
- 執行測試
- Commit
-
自審
-
規格合規審查（主 session inline 或 spawn）
- 檢查實現是否滿足計劃中的規格
- 發現問題 → 反饋給實現者修復 → 重新審查
-
通過 → 繼續
-
程式碼質量審查
- 檢查程式碼質量：DRY、命名、測試設計
- 發現問題 → 修復
-
通過 → 繼續
-
標記任務完成，繼續下一個
任務後
小蔥技能站7w4.net發現了升級外掛。
所有任務完成後：
- 做最終程式碼審查
- 呼叫 superpowers-finishing-branch 完成工作
模型選擇
用能處理任務的最弱模型，節省成本增加速度：
| 任務型別 | 示例 | 模型 |
|---|---|---|
| 機械實現任務 | 孤立函式、清晰規格、1-2 檔案 | 快速便宜模型 |
| 整合和判斷任務 | 多檔案協調、模式匹配、除錯 | 標準模型 |
| 架構設計和審查任務 | 需要設計判斷或廣泛程式碼庫理解 | 最強模型 |
處理 Subagent 狀態
Subagent 報告四種狀態之一。適當處理：
DONE： 繼續規格合規審查。
DONE_WITH_CONCERNS： 實現者完成但標記了疑慮。先讀關注點再繼續。如果關注點涉及正確性或範圍，先解決再審查。
NEEDS_CONTEXT： 實現者需要未提供的資訊。提供缺失上下文並重新 dispatch。
BLOCKED： 實現者無法完成任務。評估阻塞： 1. 如果是上下文問題，提供更多上下文並用相同模型重新 dispatch 2. 如果任務需要更多推理，用更強模型重新 dispatch 3. 如果任務太大，拆成更小的塊 4. 如果計劃本身有問題，上報給主人
永遠不要忽略升級或強制相同模型重試而不做變更。
Red Flags
永遠不要： - 在 main/master 分支上開始實現（沒有主人明確同意） - 跳過審查（規格合規或程式碼質量） - 有未修復問題時繼續 - 同時 dispatch 多個實現 subagent（衝突） - 讓 subagent 讀計劃檔案（直接提供完整文本） - 跳過場景設定上下文（subagent 需要理解任務在哪裡_fit） - 忽略 subagent 的提問（先回答再讓他們繼續） - 接受"差不多"的規格合規（審查發現問題 = 沒完成） - 跳過審查迴圈（審查發現問題 = 實現者修復 = 重新審查） - 讓實現者自審替代實際審查（兩者都需要） - 在規格合規通過前開始程式碼質量審查（順序錯誤） - 有公開問題時繼續下一個任務
整合
必需的工作流技能：
- superpowers-writing-plans — 建立這個技能執行的計劃
- superpowers-finishing-branch — 所有任務完成後的收尾
- superpowers-tdd — Subagent 每個任務遵循 TDD
替代工作流：
- sessions_spawn 並行 dispatch — 用於獨立問題的並行調查
- 順序執行 — 在主 session 內按批次執行
🤖 AI 評測
這個 Skill 質量良好，專注於多工協調執行這一垂直場景。優點是結構完整、流程清晰、決策指導詳細，並針對 OpenClaw 環境做了專門適配。不足之處是內容偏理論化，缺乏實際使用示例，部分章節較為冗長，普通使用者需要一定背景知識才能快速上手。總體而言，這是一個有深度的開發流程技能，適合需要執行復雜實現計劃的高階使用者。
