Theme / v6.3.0

Superpowers

AI 開發方法論

基礎觀念

v6.2.0 與 v6.3.0:新 Harness 與自適應儀式

掌握 v6.2.0 與 v6.3.0 的重點變更:Devin CLI、Hermes Agent、Grok Build CLI 三個新 Harness、Brainstorming 依任務規模縮放,以及 Subagent-Driven Development 的六大改進

概述

Superpowers 在 v6.2.0(2026-07-24)與 v6.3.0(2026-08-12)兩個版本中,把重點放在三件事:讓更多平台能跑(三個新 Harness)、讓儀式量隨任務規模縮放(Brainstorming 分級)、讓 Subagent-Driven Development(子代理驅動開發,SDD)更穩定且更省 token。這篇 lesson 帶你看懂每一項變更,以及它對日常工作流的實際影響。

三個新 Harness(v6.3.0)

Harness(平台整合層)是指 Superpowers 的 skills 與工作流綁定的 AI 開發環境。v6.3.0 新增三個:

Harness 安裝方式 特點
Devin CLI devin plugins install obra/superpowers session 起始時自動觸發 skills(#1995)
Hermes Agent git clone 安裝 原生 loader 註冊 skills、首回合載入 bootstrap(#1922/#2025)
Grok Build CLI 依官方安裝文件設定 加入安裝文件支援(#1919)

Devin CLI 走的是 plugin 路線:安裝一次,之後每次 session 開始 skills 就會自動可用,不需要手動觸發。Hermes Agent 則是從原始碼 clone 後,由其原生 loader 完成註冊,兩條路線都讓「skills 開箱即用」的範圍再往外推了一步。

Brainstorming 依任務規模縮放(v6.3.0)

過去 Brainstorming 的雙文件儀式(design doc + plan doc)對所有請求一視同仁,寫個小工具也要走完整流程。v6.3.0 改為先分類任務規模(#2063):

  • spike:探索性驗證,快速試錯為主,儀式最輕
  • bounded:範圍明確的中小型任務,走標準流程
  • architectural:影響架構的大改動,完整雙文件儀式

關鍵原則不變:所有路徑在實作前仍會停下等你核准。變的只是前置文件量,不是控制權。小任務跳過雙文件儀式後,你可以把時間花在真正需要設計討論的大事上。

SDD 的六大改進(v6.2.0 + v6.3.0)

Subagent-Driven Development 是這兩版著墨最深的部分,共六項變更:

1. Controller 不再因非災難性衝突卡死(v6.3.0)

controller 遇到計畫衝突時,過去一律暫停等人裁決。曾有捐贈 session 因為一個 controller 自己就能決定的問題卡了近 9 小時(#2077)。現在改為:非災難性衝突記錄裁決後繼續,只有破壞性或不可逆動作才暫停。

2. Pre-dispatch 衝突掃描寫入 ledger(v6.3.0)

派發前的衝突檢查結果不再只是口頭報告,而是寫入 ledger(帳本記錄,#2080),事後可追溯當時的裁決依據。

3. Workspace 改為 plan-scoped(v6.2.0)

SDD workspace 從共用目錄改為每個計畫獨立:.superpowers/sdd/<plan-basename>/,避免跨計畫互相污染。workspace 在最終 review 通過後刪除,git log 才是持久記錄。

4. 小且同形任務批次 dispatch(v6.3.0)

結構相同的小任務(例如十個檔案做同一種重新命名)批次為單一 dispatch(#2078),大幅降低 subagent 啟動成本。

5. Implementer/Reviewer 不得自行 spawn subagent(v6.3.0)

implementer 與 reviewer 不准再自己開 subagent(#2059),消除重複審查與職責外溢。開 subagent 是 controller 的專屬職責。

6. 規格驅動與證據處理的細節修正(v6.3.0)

計畫可帶 Spec: 指標,setup 時讀取對應規格(#2086);reviewer 遇到無法判讀的證據時改為重讀而非重跑測試(#2089),circuit-breaker 裁決也會顯示在 Finish 報告中。

v6.2.0 回顧

除了上述 SDD 改動,v6.2.0 還有幾項值得記住:

  • fix loop 改為 resume-the-implementer:失敗修復不再重啟新 implementer,而是喚回原 implementer 繼續,並加入 five-round circuit breaker 防止無限迴圈。
  • testing-anti-patterns.md 重寫為 writing-good-tests.md:從「別做什麼」翻轉為正面測試 catalog,並加入 falsifiability(可否證性)紀律,關閉 string-presence trap 與 change-detector trap 兩個常見漏洞。
  • finishing-a-development-branch 移除「Discard this work」:改為 explicit-request-only,需使用者明確要求並輸入確認文字;PR 建立改為 forge-agnostic(不綁特定 Git 平台)。
  • 11 個 SKILL 壓縮:移除 recap/persuasion 性質的冗長 prose,每個刪減都經 subagent probe micro-test 驗證不影響觸發。
  • Windows 支援修正:SessionStart hook 改經 Git Bash dispatch,修掉 PowerShell parser error 與 cmd.exe 路徑截斷;恢復 v6.1.0 誤刪的 Gemini CLI 支援(#1959)。

實務影響

對日常使用者而言,這兩版的三個訊號:

  1. 平台選擇更自由:Devin CLI、Hermes Agent、Grok Build CLI 加入了原本的 Claude Code、Codex CLI、Cursor 等陣容。
  2. 小任務更省事:Brainstorming 分級 + SDD 批次 dispatch,讓小改動的儀式成本顯著下降。
  3. 危險動作更收斂:worktree remove 不再 --force、Discard 需 typed confirmation,破壞性操作的防呆全面升級。

來源