【保姆級】Superpowers 插件：給 Claude Code 裝上"工程大腦"，小白也能寫出專業代碼
整理版優先睇
Superpowers 插件將 Claude Code 由亂寫代碼變成按工程規範推進，14 個技能覆蓋開發全流程。
呢篇文章係由 H 先生撰寫，佢係一個專注 AI 工具同效率提升嘅博主。文章背景係 Claude Code 雖然好強大，但成日亂寫代碼，你需要自己收拾爛攤子。作者想解決嘅問題係點樣令 Claude Code 有系統地做工程，而唔係隨意寫代碼。整體結論係 Superpowers 插件可以將資深工程師嘅工作習慣固化為 AI 必須遵守嘅流程，顯著提升代碼質量同開發效率。
Superpowers 提供 14 個可組合嘅技能（Skills），覆蓋軟件開發全生命週期，由需求討論、方案規劃、TDD 編碼、並行調度到 Git 分支管理同文檔生成。作者透過一個實戰演示展示咗由 brainstorming 到 finishing-a-development-branch 嘅完整流程，證明咗呢個插件點樣防止 AI「自作主張」同「提前交卷」。
插件適合編程新手、獨立開發者同項目負責人，但快速原型驗證或者 AI 老手可能會覺得流程太囉嗦。安裝好簡單，一條命令就得。總括來講，流程大過提示詞，Superpowers 係將工程規範直接交俾 AI 執行。
- Superpowers 將 Claude Code 從隨意編程變為按工程規範推進，避免 AI 亂寫代碼。
- 14 個技能覆蓋需求分析、計劃制定、TDD、並行開發、調試、Git 操作、文檔等。
- 強制 TDD（先寫測試再寫代碼）同代碼審查，顯著提升代碼質量同可維護性。
- 並行代理調度可以將大任務拆細同時開發，大幅縮短開發時間。
- 適合想養成良好開發習慣嘅新手同需要保證團隊標準嘅項目負責人，但快速原型可能唔太啱。
Superpowers GitHub 倉庫
開源項目（MIT協議），包含全部14個技能源碼。
Superpowers 係咩？點解你需要佢？
想像你請咗個好聰明嘅實習生：未裝 Superpowers 之前，你叫佢做個登錄功能，佢即刻寫 Code，結果密碼明文存儲、冇輸入校驗、冇測試，你要執手尾。裝咗之後，佢會先問清楚需求，寫方案俾你確認，然後先寫測試再寫 Code，最後仲幫你更新埋文檔。呢個就係 Superpowers 嘅核心：流程大於提示詞，將資深工程師嘅工作習慣固化做 AI 必須遵守嘅流程。
- 傳統 AI 編程：直接寫代碼 -> 寫到邊算邊 -> 完成標準模糊 -> 質量靠運氣
- Superpowers 加持：先討論方案 -> 按計劃推進 -> 明確完成標準 -> 強制 TDD + 代碼審查
14 個核心 Skills 分類速覽
Superpowers 提供 14 個可組合技能，覆蓋軟件開發全生命週期。下面按功能分類介紹：
- 🧠 需求與規劃：brainstorming（頭腦風暴）、writing-plans（編寫執行計劃）、executing-plans（執行計劃）
- 🔧 開發與編碼：writing-code（編寫代碼）、using-tdd（測試驅動開發）、using-integration-tests（集成測試）
- 🚀 並行與效率：dispatching-parallel-agents（並行代理調度）、debugging（調試專家）
- 📦 Git 與分支管理：finishing-a-development-branch（完成開發分支）、working-with-git-history（Git 歷史操作）
- 📚 文檔與溝通：writing-specifications（編寫規格說明）、writing-feedback（編寫反饋報告）
- 🛡️ 質量保證：acceptance-testing（驗收測試）、writing-tests（編寫測試）
實戰：用 Superpowers 開發用戶註冊功能
任務係開發一個「用戶註冊」功能，我哋睇下 Superpowers 點樣逐步推進。
- 1 用 brainstorming 討論方案：Claude 會問清楚字段、驗證碼、密碼要求等，再輸出技術方案。
- 2 用 writing-plans 制定執行計劃：將任務拆成 Phase 1 數據庫、Phase 2 後端 API、Phase 3 測試、Phase 4 文檔。
- 3 用 executing-plans + using-tdd 執行：按計劃一步步推進，先寫測試再寫 Code，確保每個環節有質素。
- 4 用 finishing-a-development-branch 準備提交：自動檢查測試、lint、文檔、commit message，生成 PR 描述。
Phase 1: 數據庫準備
- 1.1 檢查現有 users 表結構
- 1.2 添加短信驗證碼相關字段
- 1.3 創建 migrations 文件
Phase 2: 後端 API
- 2.1 實現 POST /api/sms/send
- 2.2 實現 POST /api/register
- 2.3 添加參數校驗和錯誤處理
Phase 3: 測試
- 3.1 編寫單元測試
- 3.2 編寫集成測試
Phase 4: 文檔
- 4.1 更新 API 文檔
- 4.2 更新 README呢個示範清楚展示咗 TDD 模式點樣保證代碼質量，最終所有測試通過、覆蓋率 87.5%。
結論：流程比提示詞更重要
呢個插件適合編程新手、獨立開發者同項目負責人。新手可以學到規範開發流程，獨立開發者可以當佢係技術主管，項目負責人可以確保團隊標準一致。但如果你只係想 10 分鐘整個 demo，或者你已經好熟 Claude Code，可能會覺得流程太囉嗦。
總括嚟講，流程大過提示詞，Superpowers 將工程規範直接交俾 AI 執行，令 Claude Code 由「亂寫代碼」變成「按部就班做工程」。如果你成日要同 AI 執手尾，不妨試下裝個 Superpowers。
你有冇呢種感覺：Claude Code 好強大，但有時候好似一匹甩咗韁嘅馬——你叫佢寫個功能，佢「刷刷刷」寫咗一堆，一執行就發現呢樣冇考慮、嗰樣有 bug，最後要你嚟執返手尾。
今日要介紹嘅 Superpowers，就係幫呢匹馬套返個韁繩嘅「訓練師」。裝咗佢之後，Claude Code 會由「隨心所欲寫 code」變成「按部就班做工程」。
一、先搞清：Superpowers 究竟係咩？
打個比喻你就明
想像你請咗個好聰明嘅實習生：
未裝 Superpowers 之前：
你：「幫我做個用戶登入功能」 實習生：立刻開始寫 code，30 秒後話「搞掂！」 你檢查咗一下：密碼明文儲存、冇做輸入校驗、冇處理異常、冇寫測試…… 你：「咁唔得㗎，要改」 實習生：「哦，咁我再加啲……」 （循環 N 次，最後你都係自己重寫曬）
裝咗 Superpowers 之後：
你：「幫我做個用戶登入功能」 實習生：先問你 ——「登入方式係咩？JWT 定 Session？密碼要加密嗎？需唔需要記住我功能？有冇現成嘅用戶表結構？」 你答完之後，實習生先寫方案文件，俾你睇過，確認咗先鬱手 鬱手時：先寫測試 → 再寫 code → 行測試 → 通過咗先提交 最後仲幫你寫埋 README 同 Git commit message
呢個就係 Superpowers 嘅核心：將資深工程師嘅工作習慣，固化做 AI 一定要跟嘅流程。
二、點解需要 Superpowers？
問題1：AI 太「心急」
普通嘅 Claude Code 對話：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：幫我做一個電商購物車功能
Claude：好的！（立刻開始寫代碼）
10秒後：搞定！我創建了 Cart.js，包含 addItem、removeItem、getTotal 三個方法。
你：等等，你沒考慮庫存校驗、沒做價格計算、沒處理併發……
Claude：哦對，那我再改改……
（又是一通改，最後還是得你自己 review）問題2：AI 唔知「幾時算做完」
你叫 AI 做個功能，佢成日「提早交卷」——寫咗一半就覺得差唔多，但其實：
冇寫測試 冇處理邊界情況 冇更新文件 冇行 lint 檢查
Superpowers 嘅解決方案
通過 14 個可組合嘅技能（Skills），將軟件開發嘅標準流程（SOP）教俾 AI：
三、安裝 Superpowers（3 分鐘搞掂）
方式一：一條指令安裝（推薦）
打開終端，執行：
ounter(line
claude plugin install superpowers裝完之後重啟 Claude Code（輸入 /quit 離開，再重新執行 claude），你會見到提示：
ounter(line
✓ Superpowers skills loaded: 14 skills available方式二：手動安裝（適合冇網絡嘅環境）
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
# 1. 克隆倉庫
git clone https://github.com/obra/superpowers.git ~/.config/claude/superpowers
# 2. 在 Claude Code 中註冊插件
# 啓動 claude，然後輸入：
> /plugin add ~/.config/claude/superpowers
# 3. 驗證安裝
> /skills list
# 應該能看到 brainstorming、executing-plans 等技能點樣確認裝好咗？
喺 Claude Code 入面輸入：
ounter(line
> 用 brainstorming 幫我規劃一個待辦事項應用如果 Claude 開始問你需求細節（而唔係直接寫 code），即係裝好咗！
四、14 個核心 Skills 詳解（附帶使用場景）
Superpowers 提供咗 14 個可組合技能，覆蓋軟件開發全生命週期。下面按使用頻率同功能分類介紹：
🧠 第一類：需求與規劃（寫 code 之前嘅必備步驟）
1. brainstorming — 頭腦風暴
一句話解釋： 等 Claude 先同你傾方案，再鬱手寫 code。
適用場景：
收到個新需求，唔知從邊度開始 有多個技術方案，揀唔定主意 想將需求拆分做可執行嘅任務
使用示例：
ounter(line
> 用 brainstorming 模式，幫我規劃一個在線聊天室的功能模塊Claude 會做啲咩：
問你：用戶量預期？需唔需要歷史訊息？要唔要表情包功能？ 幫你列出功能清單 俾出技術揀型建議（WebSocket vs 輪詢？Redis vs 數據庫？） 輸出一份結構化嘅方案文件
效果： 避免 AI 「自作主張」揀咗個唔適合你場景嘅方案。
2. writing-plans — 編寫執行計劃
一句話解釋： 將籠統嘅需求，拆成一步步嘅執行計劃。
適用場景：
需求已經明確，需要拆分做開發任務 想等 Claude 按步驟推進，而唔係一次過搞 需要留低書面計劃，方便追蹤進度
使用示例：
ounter(line
> 用 writing-plans 模式，給"用戶登錄模塊"制定開發計劃Claude 會輸出：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
## 用戶登錄模塊 - 執行計劃
### Phase 1: 數據庫設計
- [ ] 1.1 設計 users 表結構
- [ ] 1.2 創建 migrations 文件
### Phase 2: 後端 API
- [ ] 2.1 實現 POST /api/login
- [ ] 2.2 實現 POST /api/register
- [ ] 2.3 添加輸入校驗和錯誤處理
### Phase 3: 測試
- [ ] 3.1 編寫單元測試
- [ ] 3.2 編寫集成測試
### Phase 4: 文檔
- [ ] 4.1 更新 API 文檔
- [ ] 4.2 更新 README3. executing-plans — 執行計劃
一句話解釋： 按上面寫嘅計劃，一步步推進開發。
適用場景：
已經有咗計劃文件 想等 Claude 自動按節點推進，你只需要喺關鍵節點確認
使用示例：
ounter(line
> 用 executing-plans 模式，執行上面的計劃（引用上一條消息）Claude 會做啲咩：
讀取計劃文件 由第一個任務開始，完成一個先推進下一個 每完成一個階段，向你匯報進度 遇到問題會自動調整計劃並徵求你同意
🔧 第二類：開發與編碼（核心工作流程）
4. writing-code — 編寫代碼
一句話解釋： 喺明確嘅規格說明之下，按規範寫 code。
適用場景：
已經有咗詳細嘅需求文件或接口定義 需要 Claude 按照現有 code 風格繼續開發 需要保證 code 質素同一致性
注意： 呢個 skill 通常配合 executing-plans 使用，而唔係單獨調用。
5. using-tdd — 測試驅動開發（TDD）
一句話解釋： 先寫測試，再寫 code，確保每一行 code 都有測試覆蓋。
適用場景：
寫核心業務邏輯（例如支付、訂單處理） 重構舊 code，需要保證唔改壞原有功能 你想養成 TDD 習慣，但成日偷懶
使用示例：
ounter(line
> 用 using-tdd 模式，實現購物車的價格計算功能Claude 嘅工作流程：
先寫測試 —— 定義「咩叫正確」 再寫 code —— 令測試通過 重構優化 —— 喺測試保護下改善 code 輸出覆蓋率報告 —— 話你知測到幾多
效果： code 質素顯著提升，重構唔再心驚膽跳。
6. using-integration-tests — 集成測試
一句話解釋： 唔止測單個函數，仲要測模塊之間嘅協作。
適用場景：
寫完一個完整功能（例如「用戶落單」涉及用戶模塊 + 商品模塊 + 訂單模塊） 需要驗證 API 接口係咪正常運作 數據庫連接、第三方 API 調用等需要真實環境測試
🚀 第三類：並行與效率（高級技巧）
7. dispatching-parallel-agents — 並行代理調度
一句話解釋： 將一個大任務拆成多個小任務，同時交俾多個 Claude 「分身」去完成。
適用場景：
需要同時開發多個獨立模塊（例如同時做用戶模塊、商品模塊、訂單模塊） 需要同時行多個測試套件 有大量重複性工作（例如幫 20 個 API 補返齊文件）
使用示例：
ounter(line
> 用 dispatching-parallel-agents 模式，同時開發用戶、商品、訂單三個模塊Claude 會做啲咩：
分析任務依賴關係 啟動多個「子 Claude」同時工作 匯總結果，解決衝突 輸出合併後嘅 code
效果： 原本需要 3 小時嘅順序開發，可能 1 個鐘就搞掂。
8. debugging — 調試專家
一句話解釋： 遇到 bug 時，等 Claude 系統化咁定位同修復問題。
適用場景：
code 報錯，但睇唔明錯誤訊息 有個 bug 一時時出現，揾唔到規律 效能有問題，唔知瓶頸喺邊
使用示例：
ounter(line
> 用 debugging 模式，幫我排查為什麼用戶登錄總是失敗Claude 嘅排查流程：
收集錯誤訊息、日誌、重現步驟 提出假設（可能係密碼加密方式唔啱？可能係 Session 過期太快？） 逐一驗證假設 俾出修復方案並鬱手改
📦 第四類：Git 與分支管理
9. finishing-a-development-branch — 完成開發分支
一句話解釋： 喺合併 code 之前，幫你做一次完整嘅檢查清單。
適用場景：
功能開發完，準備提 PR 想確保冇遺漏任何步驟 需要規範 Git commit message
Claude 會幫你檢查：
✅ 所有測試都通過咗未？ ✅ code 有冇 lint 錯誤？ ✅ README 同文件更新咗未？ ✅ 有冇遺留嘅 console.log 或調試 code？ ✅ Git commit message 是否規範？
最後： 自動生成一個規範嘅 PR 描述。
10. working-with-git-history — Git 歷史操作
一句話解釋： 安全咁操作 Git 歷史（rebase、cherry-pick、reset 等）。
適用場景：
需要整理 commit 歷史（多個細 commit 合併成一個） 需要將某個 commit 應用到其他分支 誤操作咗，需要回退
注意： 呢個 skill 會喺操作前反覆確認，避免你誤操作遺失 code。
📚 第五類：文件與溝通
11. writing-specifications — 編寫規格說明
一句話解釋： 將模糊嘅需求，轉化成精確、可執行嘅規格文件。
適用場景：
需要寫 API 接口文件 需要定義模塊之間嘅合約 需要留低書面規格，方便其他人接手
12. writing-feedback — 編寫反饋報告
一句話解釋： code 審查之後，生成結構化嘅反饋報告。
適用場景：
審查同事嘅 code，需要俾出詳細反饋 俾人 code review 咗，需要理解所有問題點 需要留低審查記錄
🛡️ 第六類：質量保證
13. acceptance-testing — 驗收測試
一句話解釋： 由用戶角度驗證功能係咪真係用得。
適用場景：
功能開發完咗，需要模擬用戶操作驗證 需要編寫 E2E（端到端）測試 需要確保邊界情況同異常流程都處理咗
14. writing-tests — 編寫測試（通用）
一句話解釋： 幫現有 code 補充測試用例。
適用場景：
接手咗一個冇測試嘅舊項目 需要快速提升測試覆蓋率 重構前先補測試，保證安全
五、實戰演示：用 Superpowers 開發一個完整功能
等我哋用一個完整嘅例子，睇下 Superpowers 係點樣運作。
任務：開發一個「用戶註冊」功能
第 1 步：用 brainstorming 討論方案
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：用 brainstorming 模式，幫我規劃用戶註冊功能
Claude：
好的，在動手之前我需要了解幾個問題：
1. 註冊需要哪些字段？只要手機號+密碼，還是需要郵箱、用戶名？
2. 需要短信/郵箱驗證碼嗎？
3. 密碼有什麼要求？（長度、複雜度）
4. 需不需要郵箱/手機驗證激活？
5. 有沒有現有的用戶表結構可以參考？
你：只要手機號+密碼，需要短信驗證碼，密碼至少8位含大小寫字母和數字，需要短信驗證激活，參考現有的 users 表。
Claude：
明白了，我給你出一份方案文檔...
（輸出詳細的技術方案，包括數據庫表設計、API 接口定義、流程圖等）第 2 步：用 writing-plans 制定計劃
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：方案沒問題，用 writing-plans 制定執行計劃
Claude：
好的，這是執行計劃：
Phase 1: 數據庫準備
- 1.1 檢查現有 users 表結構
- 1.2 添加短信驗證碼相關字段（sms_code, sms_expires_at）
- 1.3 創建 migrations 文件
Phase 2: 後端 API
- 2.1 實現 POST /api/sms/send（發送短信驗證碼）
- 2.2 實現 POST /api/register（註冊接口）
- 2.3 添加參數校驗和錯誤處理
Phase 3: 測試
- 3.1 編寫單元測試（mock 短信服務）
- 3.2 編寫集成測試（真實數據庫）
Phase 4: 文檔
- 4.1 更新 API 文檔
- 4.2 更新 README
確認後我就開始執行。第 3 步：用 executing-plans + using-tdd 執行
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：確認，用 executing-plans 和 using-tdd 模式執行
Claude：
✓ 開始執行 Phase 1...
- 1.1 檢查 users 表：發現缺少 sms_code 字段
- 1.2 編寫 migration 文件...
- 1.3 執行 migration... 完成！
✓ 開始執行 Phase 2...
- 使用 TDD 模式：先寫測試，再寫代碼
- 2.1 編寫 /api/sms/send 的測試用例（5個場景）
- 2.2 實現 /api/sms/send，讓測試通過
- 2.3 編寫 /api/register 的測試用例（8個場景）
- 2.4 實現 /api/register，讓測試通過
- 完成！
✓ 開始執行 Phase 3...
- 運行所有測試：32 個測試全部通過 ✅
- 覆蓋率報告：87.5%
✓ 開始執行 Phase 4...
- 更新 API 文檔（添加兩個新接口說明）
- 更新 README（添加註冊功能使用說明）
所有任務完成！🎉第 4 步：用 finishing-a-development-branch 準備提交
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：用 finishing-a-development-branch 檢查一遍
Claude：
正在執行檢查清單...
✅ 所有測試通過（32/32）
✅ 無 lint 錯誤
✅ 代碼覆蓋率 87.5%（達標）
✅ README 已更新
✅ API 文檔已更新
✅ 無遺留的調試代碼
✅ Git commit message 規範
準備提 PR，這是 PR 描述：
---
**功能：** 用戶註冊（手機號+短信驗證）
**變更：**
- 新增 POST /api/sms/send 接口
- 新增 POST /api/register 接口
- users 表新增 sms_code, sms_expires_at 字段
**測試：**
- 新增 13 個測試用例
- 覆蓋率 87.5%
**檢查清單：**
- [x] 測試全部通過
- [x] 代碼審查完成
- [x] 文檔已更新
---
要我幫你提交嗎？對比一下：有 vs 冇 Superpowers
六、Superpowers 適合你嗎？
✅ 適合以下人羣：
編程新手 —— 佢可以教你規範嘅開發流程，幫你養成好習慣 獨立開發者 —— 冇人幫你 code review，等 Superpowers 做你嘅「技術主管」 項目負責人 —— 確保團隊成員（包括 AI）都按統一標準開發 接手舊項目嘅 —— 用佢嘅測試、文件 skills 快速補返啲短板
⚠️ 可能唔適合：
快速原型驗證 —— 如果你諗住 10 分鐘整個 demo，Superpowers 嘅規範流程可能會顯得「長氣」 AI 老手 —— 如果你已經好識「調教」Claude Code，可能會覺得佢限制太多 非軟件開發場景 —— 佢係專門為軟件工程設計嘅，寫文章、做數據分析就用唔著
七、常見問題 FAQ
Q1：Superpowers 會唔會影響 Claude Code 嘅回應速度？
A：會有少少影響，因為 AI 需要做多啲「思考」同「規劃」。但係相比返工同 debug 嘅時間，呢啲等待係值得嘅。
Q2：可唔可以只激活部分 Skills？
A：可以。喺 Claude Code 入面用 /skills deactivate <skill-name> 關閉唔用嘅 skill。
Q3：Superpowers 係免費嘅嗎？
A：係，佢係開源項目（MIT 授權），完全免費。你喺 GitHub 上搜 obra/superpowers 就揾到源碼。
Q4：如果 AI 按照 Skills 流程做出嚟嘅嘢我仲係唔滿意點算？
A：Skills 只係流程框架，具體嘅 code 質素仲係取決於你嘅需求描述同反饋。唔滿意就繼續迭代，AI 會按照你嘅反饋調整。
Q5：Superpowers 同 Anthropic 官方 Skills 市場有咩關係？
A：Superpowers 係社區開源項目，唔係 Anthropic 官方出品。但佢跟足 Anthropic 嘅插件規範，可以無縫整合到 Claude Code 入面。
Q6：裝咗 Superpowers 之後，仲可以用其他 Skills 嗎？
A：可以，Skills 之間一般唔衝突。你可以同時激活 Superpowers + API Doc Generator + Security Scan 等。
八、總結：點解我推薦 Superpowers？
流程大過提示詞 —— 佢唔係教你「點寫提示詞」，而係直接將工程規範固化做流程 開箱即用 —— 一條指令安裝，14 個 skills 覆蓋全流程 質量有保障 —— TDD + code 審查 + 驗收測試，三重保障 適合小白 —— 跟住流程行，就算唔識軟件工程，都可以做出似模似樣嘅 code 社區活躍 —— GitHub 12k+ star，持續更新，遇到問題容易揾到答案
快速上手三步走
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
# 1. 安裝
claude plugin install superpowers
# 2. 重啓 Claude Code
/quit
claude
# 3. 試試第一個 skill
> 用 brainstorming 模式，幫我規劃一個 XXX 功能👨💻 H先生出品 | 專注 AI 工具與效率提升 關注公眾號，回覆「Superpowers」獲取本文嘅完整 Skills 清單 PDF
下期預告：《Claude Code + Superpowers 實戰：從零開發一個完整項目》
你有沒有這種感覺：Claude Code 很強大，但有時候像一匹脱繮的野馬——你讓它寫個功能，它"刷刷刷"寫了一堆，跑起來發現這個沒考慮、那個有 bug，還得你回來收拾爛攤子。
今天要介紹的 Superpowers，就是給這匹野馬套上繮繩的"訓練師"。裝了它，Claude Code 會從"隨心所欲寫代碼"變成"按部就班做工程"。
一、先搞懂：Superpowers 到底是什麼？
打個比方你就懂了
想象你請了一個很聰明的實習生：
沒裝 Superpowers 之前：
你："幫我做個用戶登錄功能" 實習生：立刻開始寫代碼，30 秒後說"搞定！" 你檢查了一下：密碼明文存儲、沒做輸入校驗、沒處理異常、沒寫測試…… 你："這不對啊，得改" 實習生："哦，那我再加點……" （循環 N 次，最後你乾脆自己重寫了）
裝了 Superpowers 之後：
你："幫我做個用戶登錄功能" 實習生：先問你 —— "登錄方式是什麼？JWT 還是 Session？密碼要加密嗎？需要記住我功能嗎？有沒有現有的用戶表結構？" 你回答完，實習生先寫方案文檔，給你看，確認了再動手 動手時：先寫測試 → 再寫代碼 → 跑測試 → 通過了才提交 最後還幫你寫了 README 和 Git commit message
這就是 Superpowers 的核心：把資深工程師的工作習慣，固化成 AI 必須遵守的流程。
二、為什麼需要 Superpowers？
問題1：AI 太"着急"了
普通的 Claude Code 對話：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：幫我做一個電商購物車功能
Claude：好的！（立刻開始寫代碼）
10秒後：搞定！我創建了 Cart.js，包含 addItem、removeItem、getTotal 三個方法。
你：等等，你沒考慮庫存校驗、沒做價格計算、沒處理併發……
Claude：哦對，那我再改改……
（又是一通改，最後還是得你自己 review）問題2：AI 不知道"什麼時候算做完"
你讓 AI 做個功能，它經常"提前交卷"——寫了一半就覺得差不多了，但實際上：
沒寫測試 沒處理邊界情況 沒更新文檔 沒跑 lint 檢查
Superpowers 的解決方案
通過 14 個可組合的技能（Skills），把軟件開發的標準流程（SOP）教給 AI：
三、安裝 Superpowers（3 分鐘搞定）
方式一：一條命令安裝（推薦）
打開終端，運行：
ounter(line
claude plugin install superpowers裝完後重啓 Claude Code（輸入 /quit 退出，再重新運行 claude），你會看到提示：
ounter(line
✓ Superpowers skills loaded: 14 skills available方式二：手動安裝（適合無法聯網的環境）
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
# 1. 克隆倉庫
git clone https://github.com/obra/superpowers.git ~/.config/claude/superpowers
# 2. 在 Claude Code 中註冊插件
# 啓動 claude，然後輸入：
> /plugin add ~/.config/claude/superpowers
# 3. 驗證安裝
> /skills list
# 應該能看到 brainstorming、executing-plans 等技能怎麼確認裝好了？
在 Claude Code 裏輸入：
ounter(line
> 用 brainstorming 幫我規劃一個待辦事項應用如果 Claude 開始問你需求細節（而不是直接寫代碼），說明裝好了！
四、14 個核心 Skills 詳解（附帶使用場景）
Superpowers 提供了 14 個可組合技能，覆蓋軟件開發全生命週期。下面按使用頻率和功能分類介紹：
🧠 第一類：需求與規劃（寫代碼之前的必備步驟）
1. brainstorming — 頭腦風暴
一句話解釋： 讓 Claude 先跟你討論方案，再動手寫代碼。
適用場景：
拿到一個新需求，不知道從哪開始 有多個技術方案，拿不定主意 想把需求拆分成可執行的任務
使用示例：
ounter(line
> 用 brainstorming 模式，幫我規劃一個在線聊天室的功能模塊Claude 會做什麼：
問你：用戶量預期？需要歷史消息嗎？要不要表情包功能？ 幫你列出功能清單 給出技術選型建議（WebSocket vs 輪詢？Redis vs 數據庫？） 輸出一份結構化的方案文檔
效果： 避免 AI "自作主張"選了一個不適合你場景的方案。
2. writing-plans — 編寫執行計劃
一句話解釋： 把籠統的需求，拆成一步步的執行計劃。
適用場景：
需求已經明確，需要拆分成開發任務 想讓 Claude 按步驟推進，而不是一鍋端 需要留下書面計劃，方便跟蹤進度
使用示例：
ounter(line
> 用 writing-plans 模式，給"用戶登錄模塊"制定開發計劃Claude 會輸出：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
## 用戶登錄模塊 - 執行計劃
### Phase 1: 數據庫設計
- [ ] 1.1 設計 users 表結構
- [ ] 1.2 創建 migrations 文件
### Phase 2: 後端 API
- [ ] 2.1 實現 POST /api/login
- [ ] 2.2 實現 POST /api/register
- [ ] 2.3 添加輸入校驗和錯誤處理
### Phase 3: 測試
- [ ] 3.1 編寫單元測試
- [ ] 3.2 編寫集成測試
### Phase 4: 文檔
- [ ] 4.1 更新 API 文檔
- [ ] 4.2 更新 README3. executing-plans — 執行計劃
一句話解釋： 按上面寫的計劃，一步步推進開發。
適用場景：
已經有了計劃文檔 想讓 Claude 自動按節點推進，你只需要在關鍵節點確認
使用示例：
ounter(line
> 用 executing-plans 模式，執行上面的計劃（引用上一條消息）Claude 會做什麼：
讀取計劃文檔 從第一個任務開始，完成一個再推進下一個 每完成一個階段，向你彙報進度 遇到問題會自動調整計劃並徵求你的同意
🔧 第二類：開發與編碼（核心工作流）
4. writing-code — 編寫代碼
一句話解釋： 在明確的規格說明下，按規範寫代碼。
適用場景：
已經有了詳細的需求文檔或接口定義 需要 Claude 按照既有代碼風格繼續開發 需要保證代碼質量和一致性
注意： 這個 skill 通常配合 executing-plans 使用，而不是單獨調用。
5. using-tdd — 測試驅動開發（TDD）
一句話解釋： 先寫測試，再寫代碼，確保每一行代碼都有測試覆蓋。
適用場景：
寫核心業務邏輯（比如支付、訂單處理） 重構老代碼，需要保證不改壞原有功能 你想養成 TDD 習慣，但總是偷懶
使用示例：
ounter(line
> 用 using-tdd 模式，實現購物車的價格計算功能Claude 的工作流：
先寫測試 —— 定義"什麼算正確" 再寫代碼 —— 讓測試通過 重構優化 —— 在測試保護下改進代碼 輸出覆蓋率報告 —— 告訴你測到了多少
效果： 代碼質量顯著提升，重構不再心驚膽戰。
6. using-integration-tests — 集成測試
一句話解釋： 不只測單個函數，還要測模塊之間的協作。
適用場景：
寫完一個完整功能（比如"用戶下單"涉及用戶模塊 + 商品模塊 + 訂單模塊） 需要驗證 API 接口是否正常工作 數據庫連接、第三方 API 調用等需要真實環境測試
🚀 第三類：並行與效率（高級技巧）
7. dispatching-parallel-agents — 並行代理調度
一句話解釋： 把一個大任務拆成多個小任務，同時交給多個 Claude "分身"去完成。
適用場景：
需要同時開發多個獨立模塊（比如同時做用戶模塊、商品模塊、訂單模塊） 需要同時跑多個測試套件 有大量重複性工作（比如給 20 個 API 補全文檔）
使用示例：
ounter(line
> 用 dispatching-parallel-agents 模式，同時開發用戶、商品、訂單三個模塊Claude 會做什麼：
分析任務依賴關係 啓動多個"子 Claude"同時工作 彙總結果，解決衝突 輸出合併後的代碼
效果： 原本需要 3 小時的順序開發，可能 1 小時就搞定。
8. debugging — 調試專家
一句話解釋： 遇到 bug 時，讓 Claude 系統化地定位和修復問題。
適用場景：
代碼報錯了，但看不懂錯誤信息 有個 bug 時隱時現，找不到規律 性能有問題，不知道瓶頸在哪
使用示例：
ounter(line
> 用 debugging 模式，幫我排查為什麼用戶登錄總是失敗Claude 的排查流程：
收集錯誤信息、日誌、復現步驟 提出假設（可能是密碼加密方式不對？可能是 Session 過期太快？） 逐一驗證假設 給出修復方案並動手改
📦 第四類：Git 與分支管理
9. finishing-a-development-branch — 完成開發分支
一句話解釋： 在合併代碼之前，幫你做一遍完整的檢查清單。
適用場景：
功能開發完了，準備提 PR 想確保沒有遺漏任何步驟 需要規範 Git commit message
Claude 會幫你檢查：
✅ 所有測試都通過了嗎？ ✅ 代碼有沒有 lint 錯誤？ ✅ README 和文檔更新了嗎？ ✅ 有沒有遺留的 console.log 或調試代碼？ ✅ Git commit message 是否規範？
最後： 自動生成一個規範的 PR 描述。
10. working-with-git-history — Git 歷史操作
一句話解釋： 安全地操作 Git 歷史（rebase、cherry-pick、reset 等）。
適用場景：
需要整理 commit 歷史（多個小 commit 合併成一個） 需要把某個 commit 應用到其他分支 誤操作了，需要回退
注意： 這個 skill 會在操作前反覆確認，避免你誤操作丟失代碼。
📚 第五類：文檔與溝通
11. writing-specifications — 編寫規格說明
一句話解釋： 把模糊的需求，轉化成精確的、可執行的規格文檔。
適用場景：
需要寫 API 接口文檔 需要定義模塊之間的契約 需要留下書面規格，方便其他人接手
12. writing-feedback — 編寫反饋報告
一句話解釋： 代碼審查後，生成結構化的反饋報告。
適用場景：
審查同事的代碼，需要給出詳細反饋 被 code review 了，需要理解所有問題點 需要留下審查記錄
🛡️ 第六類：質量保證
13. acceptance-testing — 驗收測試
一句話解釋： 從用戶角度驗證功能是否真的可用。
適用場景：
功能開發完了，需要模擬用戶操作驗證 需要編寫 E2E（端到端）測試 需要確保邊界情況和異常流程也處理了
14. writing-tests — 編寫測試（通用）
一句話解釋： 給現有代碼補充測試用例。
適用場景：
接手了一個沒有測試的老項目 需要快速提升測試覆蓋率 重構前先補測試，保證安全
五、實戰演示：用 Superpowers 開發一個完整功能
讓我們用一個完整的例子，看看 Superpowers 是怎麼工作的。
任務：開發一個"用戶註冊"功能
第 1 步：用 brainstorming 討論方案
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：用 brainstorming 模式，幫我規劃用戶註冊功能
Claude：
好的，在動手之前我需要了解幾個問題：
1. 註冊需要哪些字段？只要手機號+密碼，還是需要郵箱、用戶名？
2. 需要短信/郵箱驗證碼嗎？
3. 密碼有什麼要求？（長度、複雜度）
4. 需不需要郵箱/手機驗證激活？
5. 有沒有現有的用戶表結構可以參考？
你：只要手機號+密碼，需要短信驗證碼，密碼至少8位含大小寫字母和數字，需要短信驗證激活，參考現有的 users 表。
Claude：
明白了，我給你出一份方案文檔...
（輸出詳細的技術方案，包括數據庫表設計、API 接口定義、流程圖等）第 2 步：用 writing-plans 制定計劃
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：方案沒問題，用 writing-plans 制定執行計劃
Claude：
好的，這是執行計劃：
Phase 1: 數據庫準備
- 1.1 檢查現有 users 表結構
- 1.2 添加短信驗證碼相關字段（sms_code, sms_expires_at）
- 1.3 創建 migrations 文件
Phase 2: 後端 API
- 2.1 實現 POST /api/sms/send（發送短信驗證碼）
- 2.2 實現 POST /api/register（註冊接口）
- 2.3 添加參數校驗和錯誤處理
Phase 3: 測試
- 3.1 編寫單元測試（mock 短信服務）
- 3.2 編寫集成測試（真實數據庫）
Phase 4: 文檔
- 4.1 更新 API 文檔
- 4.2 更新 README
確認後我就開始執行。第 3 步：用 executing-plans + using-tdd 執行
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：確認，用 executing-plans 和 using-tdd 模式執行
Claude：
✓ 開始執行 Phase 1...
- 1.1 檢查 users 表：發現缺少 sms_code 字段
- 1.2 編寫 migration 文件...
- 1.3 執行 migration... 完成！
✓ 開始執行 Phase 2...
- 使用 TDD 模式：先寫測試，再寫代碼
- 2.1 編寫 /api/sms/send 的測試用例（5個場景）
- 2.2 實現 /api/sms/send，讓測試通過
- 2.3 編寫 /api/register 的測試用例（8個場景）
- 2.4 實現 /api/register，讓測試通過
- 完成！
✓ 開始執行 Phase 3...
- 運行所有測試：32 個測試全部通過 ✅
- 覆蓋率報告：87.5%
✓ 開始執行 Phase 4...
- 更新 API 文檔（添加兩個新接口說明）
- 更新 README（添加註冊功能使用說明）
所有任務完成！🎉第 4 步：用 finishing-a-development-branch 準備提交
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
你：用 finishing-a-development-branch 檢查一遍
Claude：
正在執行檢查清單...
✅ 所有測試通過（32/32）
✅ 無 lint 錯誤
✅ 代碼覆蓋率 87.5%（達標）
✅ README 已更新
✅ API 文檔已更新
✅ 無遺留的調試代碼
✅ Git commit message 規範
準備提 PR，這是 PR 描述：
---
**功能：** 用戶註冊（手機號+短信驗證）
**變更：**
- 新增 POST /api/sms/send 接口
- 新增 POST /api/register 接口
- users 表新增 sms_code, sms_expires_at 字段
**測試：**
- 新增 13 個測試用例
- 覆蓋率 87.5%
**檢查清單：**
- [x] 測試全部通過
- [x] 代碼審查完成
- [x] 文檔已更新
---
要我幫你提交嗎？對比一下：有 vs 沒有 Superpowers
六、Superpowers 適合你嗎？
✅ 適合以下人羣：
編程新手 —— 它能教你規範的開發流程，幫你養成好習慣 獨立開發者 —— 沒有人 code review，讓 Superpowers 當你的"技術主管" 項目負責人 —— 確保團隊成員（包括 AI）都按統一標準開發 接手老項目的 —— 用它的測試、文檔 skills 快速補齊短板
⚠️ 可能不適合：
快速原型驗證 —— 如果你想 10 分鐘搞個 demo，Superpowers 的規範流程可能顯得"囉嗦" AI 老手 —— 如果你已經很會"調教" Claude Code，可能覺得它限制太多 非軟件開發場景 —— 它是專門為軟件工程設計的，寫文章、做數據分析用不上
七、常見問題 FAQ
Q1：Superpowers 會影響 Claude Code 的響應速度嗎？
A：會有一定影響，因為 AI 需要做更多"思考"和"規劃"。但相比返工和 debug 的時間，這點等待是值得的。
Q2：可以只激活部分 Skills 嗎？
A：可以。在 Claude Code 裏用 /skills deactivate <skill-name> 關閉不用的 skill。
Q3：Superpowers 是免費的嗎？
A：是的，它是開源項目（MIT 協議），完全免費。你在 GitHub 上搜索 obra/superpowers 就能找到源碼。
Q4：如果 AI 按照 Skills 流程做出來的東西我還是不滿意怎麼辦？
A：Skills 只是流程框架，具體的代碼質量還是取決於你的需求描述和反饋。不滿意就繼續迭代，AI 會按照你的反饋調整。
Q5：Superpowers 和 Anthropic 官方 Skills 市場是什麼關係？
A：Superpowers 是社區開源項目，不是 Anthropic 官方出品。但它遵循 Anthropic 的插件規範，可以無縫集成到 Claude Code 中。
Q6：裝了 Superpowers 之後，還能用其他 Skills 嗎？
A：可以，Skills 之間一般不衝突。你可以同時激活 Superpowers + API Doc Generator + Security Scan 等。
八、總結：為什麼我推薦 Superpowers？
流程大於提示詞 —— 它不是教你"怎麼寫提示詞"，而是直接把工程規範固化成流程 開箱即用 —— 一條命令安裝，14 個 skills 覆蓋全流程 質量有保障 —— TDD + 代碼審查 + 驗收測試，三重保障 適合小白 —— 跟着流程走，就算不懂軟件工程，也能做出像模像樣的代碼 社區活躍 —— GitHub 12k+ star，持續更新，遇到問題容易找到答案
快速上手三步走
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line
# 1. 安裝
claude plugin install superpowers
# 2. 重啓 Claude Code
/quit
claude
# 3. 試試第一個 skill
> 用 brainstorming 模式，幫我規劃一個 XXX 功能👨💻 H先生出品 | 專注 AI 工具與效率提升 關注公眾號，回覆「Superpowers」獲取本文的完整 Skills 清單 PDF
下期預告：《Claude Code + Superpowers 實戰：從零開發一個完整項目》