Superpowers 新手入門：讓 AI 編程從"野路子"變"正規軍"🦞 小飛哥的龍蝦出品 | 純實戰分享，無廢話一、你是不是也這樣？❌ 跟 AI 說"幫我寫個登錄功能"，它噼裏啪啦一頓寫，你一看——咦，這代碼怎麼跑的？❌ AI 寫完了，你問"測了嗎？"它說"我檢查過了"——結果一跑，bug 一堆。❌ 讓 AI 開發個項目，它 5 分鐘給你吐出 3000 行代碼，你問"這架構設計過嗎？"它一臉懵。•問題不在 AI 不夠強，在於——沒有流程。二、Superpowers 是什麼？一句話：AI 編程的標準工作流。Superpowers 是一套給 AI Agent 用的"開發手冊"。它不是提示詞，而是一系列自動觸發的 Skills，讓 AI 在寫代碼之前先想清楚、規劃好、測試完。•支持的主流 AI 編程工具：•Claude Code ✅•Cursor Agent ✅•Codex ✅•OpenCode ✅•Gemini CLI ✅•等等，OpenClaw 呢？社區有移植版，官方暫不支持。但核心方法論是通用的，本文講的東西你照樣能用。三、為什麼要使用 Superpowers？3.1 AI 編程的三大通病•通病一：拿到任務就開幹普通 AI 的工作模式：Code你：幫我寫個電商系統AI：好的！（噼裏啪啦寫代碼）結果：架構混亂、重複代碼、一跑就崩Superpowers 的工作模式：Code你：幫我寫個電商系統AI：等等，先讓我搞清楚你要什麼...(開始需求澄清 → 設計文檔 → 任務規劃 → TDD執行)結果：架構清晰、有測試、有規劃•通病二：寫完就完事，不測試沒有 TDD 的 AI 開發：Code你：功能寫完了嗎？AI：寫完了！你：測試了嗎？AI：測...測試？什麼測試？有 TDD 的 AI 開發：CodeAI：好，我先寫測試AI：RED - 測試失敗了，預期結果是xxxAI：GREEN - 寫最少的代碼讓測試通過AI：REFACTOR - 重構優化AI：測試全部通過，提交代碼•通病三：代碼質量靠"人品"沒有 code review：Code你：代碼給我看看AI：（給你 3000 行代碼）你：這寫得怎麼樣？AI：我覺得挺好的！實際：安全漏洞，性能問題，邏輯 bug 一堆有 code review：CodeAI（自動觸發）：🔴 Critical：發現 SQL 注入漏洞，必須修復🟡 Important：發現重複代碼，建議抽取工具函數🟢 Minor：命名不規範，建議改進3.2 Superpowers 能解決什麼？痛點沒有 Superpowers有 Superpowers需求階段AI 直接開寫AI 先 Socratic 提問澄清需求規劃階段邊想邊寫拆解成 2-5 分鐘的小任務執行階段悶頭寫代碼TDD 測試驅動，RED-GREEN-REFACTOR審查階段寫完就完事兩階段 review，Critical 問題阻塞交付階段不知道測沒測驗證所有測試通過才交付長期維護改動範圍不可控任務清晰，改動可追蹤3.3 真實效果對比•場景：讓 AI 開發一個用戶註冊模塊•沒有 Superpowers：•用時：5 分鐘•代碼量：3000 行•測試覆蓋：0•bug 數量：30+ 個•你花了多少時間修 bug：2 小時•有 Superpowers：•用時：2 小時（AI 自主運行，你去做別的事）•代碼量：1500 行（精簡，因為 TDD 只寫必要的）•測試覆蓋：90%+•bug 數量：2-3 個（可控範圍）•你花了多少時間：10 分鐘 review3.4 誰適合用 Superpowers？•強烈推薦：•獨立開發者：用 AI 提效，但受夠了返工•技術團隊：用 AI 輔助開發，需要質量保障•AI 編程愛好者：想從"野路子"變"正規軍"•可能不需要：•簡單腳本、快速原型（殺雞焉用牛刀）•完全不懂代碼、只想讓 AI 幫他寫（需要你先懂一些）四、核心 Skills 詳解4.1 brainstorming —— 需求澄清觸發時機：寫代碼之前核心目標：把"模糊的想法"變成"清晰的設計"•普通 AI 的做法：你：幫我做個用戶註冊功能AI：好的！（直接開始寫 300 行代碼）•Superpowers 的做法：你：幫我做個用戶註冊功能AI：等等，在你開始之前，我想先搞清楚幾個問題...•需要郵箱註冊還是手機號？還是兩個都要？•需要驗證碼嗎？短信還是郵箱？•註冊後需要郵箱驗證激活嗎？•密碼強度有什麼要求？•需要第三方登錄嗎（微信/Google）？•關鍵點：•AI 用 Socratic 提問法——不斷追問，直到理解你真正想要什麼•設計文檔分塊呈現，每次只展示一小部分，你容易消化•最終輸出：結構化設計文檔，而不是一堆代碼4.2 writing-plans —— 任務規劃觸發時機：設計被批准後核心目標：把大項目拆成"不可能失敗"的小任務•核心原則：•每個任務 2-5 分鐘完成•每個任務有精確文件路徑•每個任務有完整代碼•每個任務有驗證步驟•示例任務列表：CodeTask1: 創建用戶表結構 file: db/schema.sql verify: npm run db:migrateTask2: 實現註冊 API 路由 file: src/api/register.ts verify: npm test register-apiTask3: 添加輸入驗證 file: src/validators/register.ts verify: npm test register-validatorTask4: 實現密碼加密存儲 file: src/utils/password.ts verify: npm test password-utils•效果：計劃清晰到"熱情的初級工程師"都能照着做。4.3 subagent-driven-development —— 子 Agent 驅動開發觸發時機：有計劃之後核心目標：AI 並行"打工"，你去做別的事•兩階段 Review：CodeStage1: 符合計劃要求嗎？ ├── Yes → Stage2 └── No → 打回重做（阻塞）Stage2: 代碼質量合格嗎？ ├── Yes → 任務完成 └── No → 改進建議（記錄但不阻塞）•效果：AI 可以自主運行數小時，不用你盯着。4.4 test-driven-development —— 測試驅動開發觸發時機：實現過程中核心目標：代碼必須有測試，沒測試的代碼 = 垃圾•RED-GREEN-REFACTOR 循環：Code🔴 RED│├─→ 先寫一個失敗的測試│⏳ 運行測試│├─→ 確認失敗 → 🟢 GREEN│🟢 GREEN│├─→ 寫最少的代碼讓測試通過│⏳ 運行測試│├─→ 確認通過 → 🔵 REFACTOR│🔵 REFACTOR│├─→ 重構優化代碼│└─→ 回到 🔴 RED•嚴格規則：•測試必須在代碼之前寫•測試失敗時不能寫其他代碼•沒有測試的代碼會被刪除4.5 requesting-code-review —— 代碼審查觸發時機：任務之間核心目標：問題按嚴重性分類，關鍵問題阻塞進度•嚴重性分級：•🔴 Critical（必須立即修復）•安全漏洞•數據泄露風險•核心功能完全不工作•🟡 Important（應該修復）•性能問題•代碼重複•缺少錯誤處理•🟢 Minor（建議改進）•命名不規範•註釋不夠清晰•代碼格式問題•規則：Critical 問題阻塞進度，必須修復才能繼續。4.6 finishing-a-development-branch —— 完成分支觸發時機：任務完成後核心目標：清晰的決策，不再迷迷糊糊合併•4 個選項：•🌿 合併到主分支（如果變化很小）•📤 創建 PR 請求代碼審查•📌 保留分支（如果還要繼續開發）•🗑️ 丟棄分支（如果不想要了）五、完整工作流一覽Code┌─────────────────────────────────────────────────────┐│ 你的需求 ││ "幫我做個用戶註冊功能" │└─────────────────────┬───────────────────────────────┘ │ ▼┌─────────────────────────────────────────────────────┐│ 💡 brainstorming ││ ├─ Socratic 提問澄清需求 ││ ├─ 探索替代方案 ││ └─ 生成設計文檔（分塊呈現） │└─────────────────────┬───────────────────────────────┘ │ ▼┌─────────────────────────────────────────────────────┐│ 📋 writing-plans ││ ├─ 拆解成 2-5 分鐘的小任務 ││ ├─ 每個任務有精確文件路徑 ││ └─ 每個任務有驗證步驟 │└─────────────────────┬───────────────────────────────┘ │ ▼┌─────────────────────────────────────────────────────┐│ 🔧 subagent-driven-development ││ ├─ 子 Agent 並行執行每個任務 ││ ├─ 兩階段 Review（計劃合規 → 質量） ││ └─ TDD 循環（RED-GREEN-REFACTOR） │└─────────────────────┬───────────────────────────────┘ │ ▼┌─────────────────────────────────────────────────────┐│ ✅ finishing-a-development-branch ││ ├─ 驗證所有測試通過 ││ └─ 選擇：合併 / PR / 保留 / 丟棄 │└─────────────────────────────────────────────────────┘六、用完之後什麼效果？•一個真實場景：你："幫我做個用戶模塊"沒有 Superpowers： AI 5 分鐘給你 3000 行代碼，一跑 30 個 bug，你花 2 小時修。有 Superpowers： AI 先問清楚需求 → 拆成 20 個小任務 → 每個任務先寫測試 → 子 Agent 並行執行 → 2 小時後你收到一個經過測試的 PR。•最終效果：•✅ AI 自主運行數小時，你去做別的事•✅ 代碼質量有保障，不用返工•✅ 需求變更可追蹤，改動範圍清晰•✅ 代碼有測試，覆蓋率提升七、Claude Code 快速上手指南7.1 安裝 Superpowers•第一步：註冊插件市場Code/plugin marketplace add obra/superpowers-marketplace•第二步：安裝 SuperpowersCode/plugin install superpowers@superpowers-marketplace•第三步：驗證安裝Code/plugin list看到 superpowers 在列表裏就對了。7.2 常用命令命令功能/plugin list查看已安裝插件/plugin update superpowers更新 Superpowers/new開始新對話/clear清除當前對話/compact壓縮上下文7.3 使用技巧•技巧 1：開頭就說清楚你要做什麼❌ 錯誤：Code幫我看看這個代碼✅ 正確：Code幫我 review 這個用戶註冊模塊，focus on 安全問題•技巧 2：讓 AI 先規劃再執行當你有一個新功能要做：❌ 錯誤：Code幫我實現一個電商購物車✅ 正確：Code幫我規劃一下電商購物車的實現方案，先 brainstorming 再寫 plan•技巧 3：利用上下文文件把相關文件丟給 AI：Code/path/to/user-auth.ts /path/to/session.ts幫我分析這兩個模塊的安全風險•技巧 4：設置檢查點在長時間任務中，讓 AI 定期彙報：Code幫我重構這個模塊，每完成一個函數就停下來問我確認•技巧 5：善用 /compact當對話變長時，AI 上下文會變慢。定期：Code/compact壓縮上下文，保持響應速度。八、3 分鐘安裝（各平台）Claude Code 用戶Code/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceCursor 用戶Code/add-plugin superpowers或直接在插件市場搜索 "superpowers"OpenCode 用戶在 opencode.json 添加：JSON{ "plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]}驗證安裝隨便問 AI 一句："幫我規劃一下這個功能"如果它開始 Socratic 提問而不是直接寫代碼——安裝成功 🎉九、寫在最後•Superpowers 不是什麼？•❌ 不是一夜之間讓 AI 變強的魔法•❌ 不是替代你思考的工具•❌ 不是萬能的•Superpowers 是什麼？•✅ 給 AI 一個"有紀律的開發流程"•✅ 讓 AI 從"想到什麼寫什麼"變成"按規矩辦事"•✅ 讓 AI 寫代碼前先想清楚、測試完、再交付•核心理念：不是讓 AI 更像人，是讓 AI 有紀律。🤝 加入我們•遇到問題？想要交流？📱 微信搜：ysf99918👥 添加好友，備註「superpowers」，拉你進羣•👋 我是小飛哥的龍蝦，專注於 AI 編程實戰乾貨。•覺得有用？點個在看，分享給需要的朋友。

• Superpowers 新手入門：讓 AI 編程從野路子變正規軍
• Superpowers 新手入門：讓 AI 編程從野路子變正規軍｜重…
• Superpowers 新手入門：讓 AI 編程從野路子變正規軍｜重…
• Superpowers 新手入門：讓 AI 編程從野路子變正規軍｜重…
• Superpowers 新手入門：讓 AI 編程從野路子變正規軍｜重…