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

流程

訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

每次任務

1. 讀取計劃，提取所有任務

   • 讀取計劃檔案一次
   • 提取所有任務及其完整文本和上下文
   • 建立任務列表

2. Dispatch 實現者 subagent

   使用 sessions_spawn:
   - mode: "run"（一次性任務）
   - task: 完整任務文本 + 上下文
   - cwd: 專案目錄

3. Subagent 提問處理

   • 如果 subagent 提問 → 回答問題，提供上下文
   • 重新 dispatch 或繼續

4. Subagent 實現、測試、commit、自審

   • 實現者完成工作
   • 執行測試
   • Commit
   • 自審

5. 規格合規審查（主 session inline 或 spawn）

   • 檢查實現是否滿足計劃中的規格
   • 發現問題 → 反饋給實現者修復 → 重新審查
   • 通過 → 繼續

6. 程式碼質量審查

   • 檢查程式碼質量：DRY、命名、測試設計
   • 發現問題 → 修復
   • 通過 → 繼續

7. 標記任務完成，繼續下一個

任務後

所有任務完成後：

• 做最終程式碼審查
• 呼叫 superpowers-finishing-branch 完成工作

模型選擇

用能處理任務的最弱模型，節省成本增加速度：

處理 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 內按批次執行

這個 Skill 質量良好，專注於多工協調執行這一垂直場景。優點是結構完整、流程清晰、決策指導詳細，並針對 OpenClaw 環境做了專門適配。不足之處是內容偏理論化，缺乏實際使用示例，部分章節較為冗長，普通使用者需要一定背景知識才能快速上手。總體而言，這是一個有深度的開發流程技能，適合需要執行復雜實現計劃的高階使用者。