Skill
Superpowers
完整的 AI 代理軟體開發工作流程,建立在可組合的技能系統之上。
|
前往使用
- 次瀏覽
Skills TDD
為什麼推薦
Superpowers 不只是一個技能包,而是一套完整的軟體開發方法論和工作流程框架,專為 AI 編程代理設計。它改變了 AI 開發程式的方式:不再是直接跳進寫程式碼,而是先理解需求、設計規格、制定計畫,然後才開始實作。這套系統能讓 Claude 等 AI 助手自主工作數小時而不偏離計畫。
核心理念
Superpowers 建立在四個核心原則之上:
- 測試驅動開發(TDD):永遠先寫測試
- 系統化勝於臨時起意:用流程取代猜測
- 降低複雜度:簡單性是首要目標
- 證據勝於宣稱:在宣告成功前先驗證
工作流程
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 會:
- 先問清楚需求:不會直接開始寫程式,而是透過對話理解你真正想做什麼
- 產生規格文件:將需求轉換成清晰的規格,分段呈現讓你能實際閱讀和消化
- 制定實作計畫:建立清楚到「熱情但品味不佳、沒有判斷力、缺乏專案脈絡、厭惡測試的初級工程師」都能遵循的計畫
- 自主執行:在你說「開始」後,AI 可以自主工作數小時而不偏離計畫
系統化除錯
使用 systematic-debugging 技能:
- 4 階段根本原因分析
- 根因追蹤技術
- 深度防禦策略
- 條件式等待機制
- 完成前驗證確保問題真的解決
並行開發
使用 using-git-worktrees 和 dispatching-parallel-agents:
- 在隔離的工作空間中開發
- 多個子代理並行處理不同任務
- 保持主分支穩定
建立新技能
使用 writing-skills 技能:
- 遵循最佳實踐建立新技能
- 包含完整的測試方法論
- 確保技能品質
支援的平台
- Claude Code:透過內建的插件市場安裝
- Codex:需要手動設定
- OpenCode:需要手動設定
安裝方式
Claude Code(推薦)
透過插件市場安裝:
/plugin install superpowers
驗證安裝
/plugin list
更新
技能會在更新插件時自動更新:
/plugin update superpowers
手動安裝(Codex / OpenCode)
- Fork 儲存庫
- 根據平台說明進行設定
- 參考官方文件完成安裝
使用技巧
1. 讓 AI 主導流程
不要急著要求 AI 寫程式碼,讓它先:
- 問清楚需求
- 產生設計文件
- 制定實作計畫
這樣最終的成果會更符合你的需求。
2. 仔細審查設計文件
Superpowers 會將設計分段呈現,每段都短到你能實際閱讀。請認真審查,因為後續的實作都會基於這個設計。
3. 信任 TDD 流程
即使一開始覺得先寫測試很慢,但長期來看會:
- 減少 bug
- 提高程式碼品質
- 讓重構更安全
- 確保功能真的能運作
4. 善用子代理系統
對於大型任務,讓 Superpowers 派遣子代理:
- 每個子代理專注於單一小任務
- 兩階段審查確保品質
- 可以並行處理加速開發
5. 遵循 YAGNI 原則
Superpowers 強調「You Aren’t Gonna Need It」:
- 只實作當前需要的功能
- 避免過度設計
- 保持程式碼簡單
6. 定期程式碼審查
使用 requesting-code-review 技能:
- 在任務之間進行審查
- 及早發現問題
- 嚴重問題會阻擋進度,確保品質
工作原理
- 自動觸發:AI 代理會在適當時機自動檢查並啟動相關技能
- 強制性工作流程:這些不是建議,而是必須遵循的流程
- 可組合性:技能可以組合使用,形成完整的開發工作流程
- 兩階段審查:先檢查規格符合性,再檢查程式碼品質
適合誰使用
- 重視程式碼品質的開發者:想要確保 AI 產生的程式碼有測試、有品質
- 專案管理者:需要清楚的規格文件和實作計畫
- 團隊協作:使用 Git worktrees 和程式碼審查流程的團隊
- TDD 實踐者:相信測試驅動開發價值的開發者
- 系統化思考者:偏好有結構的開發流程而非臨時起意
與其他技能的差異
Superpowers 不只是提供設計建議或程式碼範本,而是:
- 定義完整的開發方法論
- 強制執行最佳實踐(如 TDD)
- 提供端到端的工作流程
- 支援子代理系統進行複雜開發
- 包含系統化的除錯和審查流程
重要提醒
- 這是一套方法論,不只是工具集
- 需要時間適應,但長期效益顯著
- 特別適合需要高品質、可維護程式碼的專案
- 如果 Superpowers 幫助你賺到錢,可以考慮贊助作者的開源工作