LeeScot's Web
Skill

Superpowers

完整的 AI 代理軟體開發工作流程,建立在可組合的技能系統之上。

|
- 次瀏覽
Skills TDD
前往使用

為什麼推薦

Superpowers 不只是一個技能包,而是一套完整的軟體開發方法論和工作流程框架,專為 AI 編程代理設計。它改變了 AI 開發程式的方式:不再是直接跳進寫程式碼,而是先理解需求、設計規格、制定計畫,然後才開始實作。這套系統能讓 Claude 等 AI 助手自主工作數小時而不偏離計畫。

核心理念

Superpowers 建立在四個核心原則之上:

  1. 測試驅動開發(TDD):永遠先寫測試
  2. 系統化勝於臨時起意:用流程取代猜測
  3. 降低複雜度:簡單性是首要目標
  4. 證據勝於宣稱:在宣告成功前先驗證

工作流程

Superpowers 定義了一套完整的開發流程,每個階段都有對應的技能自動啟動:

1. 腦力激盪(brainstorming)

  • 啟動時機:在寫程式碼之前
  • 功能
    • 透過蘇格拉底式提問精煉粗略的想法
    • 探索替代方案
    • 分段呈現設計供你驗證
    • 儲存設計文件

2. 使用 Git Worktrees(using-git-worktrees)

  • 啟動時機:設計獲得批准後
  • 功能
    • 在新分支上建立隔離的工作空間
    • 執行專案設定
    • 驗證測試基準線乾淨無誤

3. 撰寫計畫(writing-plans)

  • 啟動時機:有了批准的設計後
  • 功能
    • 將工作拆解成小任務(每個 2-5 分鐘)
    • 每個任務包含確切的檔案路徑、完整程式碼、驗證步驟

4. 子代理驅動開發(subagent-driven-development)

  • 啟動時機:有了計畫後
  • 功能
    • 為每個任務派遣全新的子代理
    • 兩階段審查:先檢查規格符合性,再檢查程式碼品質
    • 快速迭代開發

5. 測試驅動開發(test-driven-development)

  • 啟動時機:實作期間
  • 功能
    • 強制執行 RED-GREEN-REFACTOR 循環
    • 寫失敗的測試 → 看它失敗 → 寫最少的程式碼 → 看它通過 → 提交
    • 刪除在測試之前寫的程式碼

6. 請求程式碼審查(requesting-code-review)

  • 啟動時機:任務之間
  • 功能
    • 根據計畫審查程式碼
    • 按嚴重性報告問題
    • 嚴重問題會阻擋進度

7. 完成開發分支(finishing-a-development-branch)

  • 啟動時機:任務完成時
  • 功能
    • 驗證測試
    • 提供選項(合併/PR/保留/捨棄)
    • 清理 worktree

技能庫

Superpowers 包含豐富的技能庫,涵蓋開發的各個面向:

測試相關

  • test-driven-development:RED-GREEN-REFACTOR 循環(包含測試反模式參考)

除錯相關

  • systematic-debugging:4 階段根本原因分析流程(包含根因追蹤、深度防禦、條件式等待技術)
  • verification-before-completion:確保問題真的被修復

協作相關

  • brainstorming:蘇格拉底式設計精煉
  • writing-plans:詳細的實作計畫
  • executing-plans:批次執行與檢查點
  • dispatching-parallel-agents:並行子代理工作流程
  • requesting-code-review:審查前檢查清單
  • receiving-code-review:回應反饋
  • using-git-worktrees:並行開發分支
  • finishing-a-development-branch:合併/PR 決策流程
  • subagent-driven-development:快速迭代與兩階段審查

元技能

  • writing-skills:遵循最佳實踐建立新技能(包含測試方法論)
  • using-superpowers:技能系統介紹

使用情境

開發新功能

當你要開發一個新功能時,Superpowers 會:

  1. 先問清楚需求:不會直接開始寫程式,而是透過對話理解你真正想做什麼
  2. 產生規格文件:將需求轉換成清晰的規格,分段呈現讓你能實際閱讀和消化
  3. 制定實作計畫:建立清楚到「熱情但品味不佳、沒有判斷力、缺乏專案脈絡、厭惡測試的初級工程師」都能遵循的計畫
  4. 自主執行:在你說「開始」後,AI 可以自主工作數小時而不偏離計畫

系統化除錯

使用 systematic-debugging 技能:

  • 4 階段根本原因分析
  • 根因追蹤技術
  • 深度防禦策略
  • 條件式等待機制
  • 完成前驗證確保問題真的解決

並行開發

使用 using-git-worktreesdispatching-parallel-agents

  • 在隔離的工作空間中開發
  • 多個子代理並行處理不同任務
  • 保持主分支穩定

建立新技能

使用 writing-skills 技能:

  • 遵循最佳實踐建立新技能
  • 包含完整的測試方法論
  • 確保技能品質

支援的平台

  • Claude Code:透過內建的插件市場安裝
  • Codex:需要手動設定
  • OpenCode:需要手動設定

安裝方式

Claude Code(推薦)

透過插件市場安裝:

/plugin install superpowers

驗證安裝

/plugin list

更新

技能會在更新插件時自動更新:

/plugin update superpowers

手動安裝(Codex / OpenCode)

  1. Fork 儲存庫
  2. 根據平台說明進行設定
  3. 參考官方文件完成安裝

使用技巧

1. 讓 AI 主導流程

不要急著要求 AI 寫程式碼,讓它先:

  • 問清楚需求
  • 產生設計文件
  • 制定實作計畫

這樣最終的成果會更符合你的需求。

2. 仔細審查設計文件

Superpowers 會將設計分段呈現,每段都短到你能實際閱讀。請認真審查,因為後續的實作都會基於這個設計。

3. 信任 TDD 流程

即使一開始覺得先寫測試很慢,但長期來看會:

  • 減少 bug
  • 提高程式碼品質
  • 讓重構更安全
  • 確保功能真的能運作

4. 善用子代理系統

對於大型任務,讓 Superpowers 派遣子代理:

  • 每個子代理專注於單一小任務
  • 兩階段審查確保品質
  • 可以並行處理加速開發

5. 遵循 YAGNI 原則

Superpowers 強調「You Aren’t Gonna Need It」:

  • 只實作當前需要的功能
  • 避免過度設計
  • 保持程式碼簡單

6. 定期程式碼審查

使用 requesting-code-review 技能:

  • 在任務之間進行審查
  • 及早發現問題
  • 嚴重問題會阻擋進度,確保品質

工作原理

  1. 自動觸發:AI 代理會在適當時機自動檢查並啟動相關技能
  2. 強制性工作流程:這些不是建議,而是必須遵循的流程
  3. 可組合性:技能可以組合使用,形成完整的開發工作流程
  4. 兩階段審查:先檢查規格符合性,再檢查程式碼品質

適合誰使用

  • 重視程式碼品質的開發者:想要確保 AI 產生的程式碼有測試、有品質
  • 專案管理者:需要清楚的規格文件和實作計畫
  • 團隊協作:使用 Git worktrees 和程式碼審查流程的團隊
  • TDD 實踐者:相信測試驅動開發價值的開發者
  • 系統化思考者:偏好有結構的開發流程而非臨時起意

與其他技能的差異

Superpowers 不只是提供設計建議或程式碼範本,而是:

  • 定義完整的開發方法論
  • 強制執行最佳實踐(如 TDD)
  • 提供端到端的工作流程
  • 支援子代理系統進行複雜開發
  • 包含系統化的除錯和審查流程

重要提醒

  • 這是一套方法論,不只是工具集
  • 需要時間適應,但長期效益顯著
  • 特別適合需要高品質、可維護程式碼的專案
  • 如果 Superpowers 幫助你賺到錢,可以考慮贊助作者的開源工作

更多資源