Superpowers詳細拆解：讓編程Agent從“瞎寫”變“靠譜”的7步工作流
整理版優先睇
Superpowers 透過 7 步工程工作流同技能框架，強制編程 Agent 由亂寫變靠譜，唔係靠 prompt 而係靠流程。
呢篇文章係對 obra 開發嘅 Superpowers 框架嘅詳細拆解。Superpowers 俾編程 Agent 一套「技能框架 + 軟件開發方法論」，核心目標係令 Agent 按工程流程做事，而唔係憑衝動寫代碼。
作者喺公告入面講得好清楚：啟動時強制模型去讀 getting-started 嘅 SKILL.md，灌輸三件事——你有 skills，呢啲 skills 會俾你超能力；你要先揾 skills，揾到就讀，然後照做；如果有 skill 可以做呢件事，就必須用。呢個 bootstrap 機制係令 Agent 由亂寫變靠譜嘅關鍵。
整體結論係：未來 AI 編程比拼嘅重點，會從「模型有幾識寫」轉到「工作流有幾穩定」。你可以換 Claude、GPT、Gemini，甚至換工具鏈，但「先澄清、再計劃、隔離變更、測試驅動、階段複審、標準化收尾」呢套流程，遲早會變成默認。Superpowers 只係將佢做得更早、更系統、更可複製。
- 結論：Superpowers 透過強制工程流程（技能框架 + 7步工作流），解決編程 Agent 亂寫代碼、缺乏工程紀律嘅核心問題。
- 方法：啟動時 bootstrap 機制強制 Agent 讀取 SKILL.md，灌輸「有技能就要用」嘅規矩，將好習慣變成默認行為。
- 差異：有別於一般提示詞隻影響單次回復，Superpowers 嘅流程影響每一回合，令 Agent 每一步都按規則行事。
- 啟發：未來 AI 編程嘅競爭重點將從模型能力轉向工作流穩定性，流程比 prompt 更重要。
- 可行動點：建議先試 brainstorming、worktree 隔離同 TDD 三個步驟，逐步加入子代理執行同 code review。
Superpowers GitHub 倉庫
Superpowers 框架嘅源碼同說明文件
Superpowers README
官方 README，包含安裝同詳細文檔
作者發佈公告
obra 關於 Superpowers 嘅公告文章
編程 Agent 點解成日「亂嚟」？
如果你用過 Claude Code / Cursor / Codex，好大機會都俾同一件事折磨過：你叫佢「修個小 bug」，佢順手重構半個項目；你叫佢「先唔好寫 code，傾方案」，佢口頭應承但轉頭開寫；你叫佢「跑測試」，佢話已驗證但其實咩都冇跑。呢啲問題唔係模型唔夠聰明，而係冇工程流程。
沒有流程的智能，會把工程變成玄學
先計劃、再測試、隔離分支
Superpowers 係咩？點樣改變 Agent 行為？
Superpowers 係一套俾編程 Agent 用嘅「技能框架 + 軟件開發方法論」。你可以理解成：你以前係「對住 Agent 喊話」，而家係「俾 Agent 配咗一套 SOP + 檢查清單 + 強約束流程」。佢唔係只綁定某一個平台，可以覆蓋 Claude Code、Cursor、Codex 等。
技能框架 + 軟件開發方法論
SOP + 檢查清單 + 強約束流程
最關鍵嘅係 bootstrap 機制：一啟動就強制模型去讀 getting-started 嘅 SKILL.md，並且灌輸三件事：你有 skills，呢啲 skills 會俾你超能力；你要先揾 skills，揾到就讀，然後照做；如果有 skill 可以做呢件事，就必須用。呢個機制將好習慣變成默認行為，唔需要靠你每次提醒。
7步工作流：每一步都在堵坑
官方提供嘅 Basic Workflow 一共 7 步，每一步都係為咗堵住 Agent 常見嘅坑。下面係每步嘅核心作用：
7步流程係Superpowers嘅核心
- 1 brainstorming：先問清楚需求，避免 Agent 自作主張。
- 2 using-git-worktrees：用 worktree 隔離改動，防止並行任務互相污染。
- 3 writing-plans：將任務拆成 2-5 分鐘嘅小塊，寫清文件路徑同驗證步驟。
- 4 subagent-driven-development：將實現交俾子代理，然後做兩階段複審（合規 + 質量）。
- 5 test-driven-development：紅→綠→重構，冇測試嘅代碼直接刪除。
- 6 requesting-code-review：每個階段做 code review，Critical 問題必須修。
- 7 finishing-a-development-branch：標準化收尾，包括 PR、merge 或清理。
TDD：紅→綠→重構
冇測試嘅code直接刪除
點樣安裝同開始用？
安裝方法睇你想用邊個平台。Claude Code 可以用 /plugin install superpowers@claude-plugins-official，或者用 Superpowers 自己嘅 marketplace。Cursor 喺 Agent chat 度打 /add-plugin superpowers。詳細安裝命令可以參考下面嘅 code block。
先練3件事：brainstorming、worktree、TDD
流程增強器，唔係更強嘅 prompt
/plugin install superpowers@claude-plugins-official
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace- 先試 brainstorming + plan，唔好俾佢寫 code，純粹練溝通。
- 用 worktree 隔離改動，感受下世界清淨嘅感覺。
- 行一次 TDD，哪怕只係一個好細嘅函數改動。
- 之後再逐步加入子代理執行同 code review。
如果你用過 Claude Code / Cursor / Codex 呢類編程 Agent，十居其九都俾同一件事折磨過：
你叫佢「改個細 bug」，佢順手重組半個項目 你話「唔好寫住，傾方案先」，佢口頭應承，轉頭就開工 你叫佢「行測試」，佢話「已驗證」，其實乜都冇行過 你想同時做兩項需求，佢哋互相覆蓋檔案，最後亂曬籠
obra/superpowers 真正要解決嘅，唔係「個模型夠唔夠聰明」，而係更現實嘅一句：冇流程嘅智能，會將工程變成玄學。
佢俾編程 Agent 套上一套「工程紀律」：先釐清 → 出設計 → 拆計劃 → 用 worktree 隔離 → TDD 紅綠燈 → 子代理執行 + 複審 → 收尾出 PR/合併。 聽落好似「項目管理」，但真正厲害嘅係：呢套流程係用 skills（技能文檔）強制注入俾 Agent 嘅，唔係靠你每日 copy paste 提示詞。
下面我會按「佢到底做咗啲乜 / 點解有效 / 點樣上手 / 點樣用出結果」拆開講清楚。
1、Superpowers 到底係咩？一句講人話
Superpowers 係一套俾編程 Agent 用嘅「技能框架 + 軟件開發方法論」，核心目標得一個：
令 Agent 按工程流程做事，而唔係按佢嘅衝動寫 code。
你可以當佢係：
以前你係「對住 Agent 叫喊」 而家你係「俾 Agent 配咗一套 SOP（標準作業流程）+ 檢查清單 + 強約束流程」
佢唔係淨係綁實某一個平台：同一套理念覆蓋 Claude Code、Cursor、Codex、Gemini CLI、Copilot CLI 等多個「harness」（官方叫法）。
2、點解佢可以令 Agent 變靠譜？關鍵在「將好習慣整成默認行為」
Superpowers 最反直覺嘅一點係：佢唔靠你變強，佢靠「默認流程」變強。
作者喺發佈公告入面將「啟動鈎子（bootstrap）」講得好清楚：一啟動就強制模型去讀 getting-started SKILL.md，而且灌輸三件事（我用大白話翻譯）：
你有 skills，呢樣嘢會俾你超能力 你要先去揾 skills，揾到就讀，然後跟住做 如果有 skill 可以做呢件事，就一定要用
聽落似「規矩」，但對 Agent 特別有效：佢將「先計劃、再測試、隔離分支、階段複審」呢啲工程師自覺，變成了模型嘅默認動作。
3、最核心嘅 7 步工作流：睇落好「流程」，但每一步都幫你堵住啲坑
官方俾嘅 Basic Workflow 總共 7 步，我逐條拆俾你睇佢「堵住咗啲咩坑」。
3.1 brainstorming：先將需求問清楚（唔好急住寫）
佢會喺寫 code 前用問題將目標「逼出嚟」，並將設計逐個細塊展示俾你確認。
佢解決嘅坑：
你只講咗 60 分嘅需求，Agent 用 120 分嘅想像補齊，然後寫出 0 分嘅結果 你想要 A，佢自作主張做成 B
3.2 using-git-worktrees：將改動隔離到 worktree（避免互相污染）
設計確認咗之後，如果喺 git repo 入面，佢會建立 worktree，喺新工作目錄入面做事。
佢解決嘅坑：
並行兩項任務互相覆蓋檔案 試驗性改動污染主分支，返唔到轉頭 「我只係想試試」最後變成「我好似改啱咗但唔敢提交」
3.3 writing-plans：將任務拆成 2-5 分鐘嘅細塊（而且寫清楚檔案路徑）
佢強調：每個任務都要有確實嘅檔案路徑、完整 code、驗證步驟。
佢解決嘅坑：
Agent 寫一個「宏大方案」，你睇完都唔知下一步改邊個檔案 計劃入面得形容詞（「優化」「增強」「重組」），冇可執行嘅動作
3.4 subagent-driven-development / executing-plans：將實現交俾子代理做，然後複審
佢提供兩種執行方式：
傳統方式：你開第二個對話當 PM 新方式：逐個任務派俾子代理實現，並做兩階段 review（合規 + 質量） 佢解決嘅坑： 一個 Agent 由頭做到尾，越寫越興奮，越偏越遠 冇「階段性剎車」，出問題時已經改咗 30 個檔案
3.5 test-driven-development：紅→綠→重構（而且「先寫嘅冇測試就刪咗佢」）
佢強調真 TDD：先寫失敗測試 → 睇佢失敗 → 寫最少實現令佢 pass → 再重構。 甚至寫得幾狠：刪咗嗰啲冇測試就寫咗出嚟嘅 code。 佢解決嘅坑：
Agent 好叻「寫睇落啱嘅 code」，但唔會「寫可證明啱嘅 code」 你以為佢測咗，其實只係「諗測試」
3.6 requesting-code-review：每個階段做 code review，Critical 一定要改
佢將「複審」整成流程，唔俾佢求其過關。
佢解決嘅坑：
功能行到，但安全性、邊界條件、可維護性一塌糊塗 你想做 review，但你冇精力逐行睇
3.7 finishing-a-development-branch：收尾動作標準化（PR / merge / 清理）
做完會驗證測試，並提供：開 PR、將 worktree 合併返來源分支、或者停止。
佢解決嘅坑：
「做曬」其實只係本機行到，冇可交付嘅嘢 worktree 留低一大堆，後面越積越亂
4、真正「有料到」嘅地方：Skills 先係引擎，唔係裝飾
發佈公告入面有句好直接：「Skills are the interesting part.」
點解？因為 skills 令 Agent 嘅行為由「靠記憶同自覺」變成「靠規則同流程」。
作者仲做咗「壓力測試（pressure test）」：用「生產事故每分鐘蝕 5000 美元」嘅場景逼問 Agent：你係直接開始 debug，定係先揾 debugging skill？然後根據失敗情況不斷強化 getting-started 嘅指令，令未來嘅 Claude 更守規矩。
你可以當佢係：
冇 skills 嘅 Agent：聰明但冇受過工程訓練嘅實習生 有 skills 嘅 Agent：聰明 + 有班組長盯流程 + 每一步要打卡嘅工程師
5、點樣安裝？揀你喺用嗰套工具就得
下面指令嚟自官方 README，我只做中文解釋，唔會擅自改指令。
5.1 Claude Code（官方市場）
或者用 Superpowers 自己嘅 marketplace：
5.2 Cursor
喺 Cursor Agent chat 入面：
6、我建議你咁樣用：先用一個細任務試出手感
如果你從未用過「流程化」嘅 Agent，建議第一週只練 3 件事：
淨係俾佢做 brainstorming + plan（你先唔俾佢寫 code） 淨係俾佢用 worktree 做隔離（你會即刻覺得世界清靜曬） 淨係俾佢按 TDD 行一次（就算係一個好細嘅函數改動）
等你發現佢終於「唔會亂改、識問問題、可以驗證復現」之後，先將子代理執行、code review 等環節加上去。
為咗令你快啲上手，我俾你一個可以直接照抄嘅「首次試跑清單」（10 分鐘版本）：
揀一個極細任務：例如「改一個測試」「補一個邊界條件」 先淨係俾佢做 brainstorming：將需求、約束、風險問清楚 俾佢寫 plan：每一步對應到檔案路徑 + 驗證方式 進入 worktree：確保改動唔會污染主分支 行一次真 TDD：先令測試失敗，再令佢變綠 做一次 review：淨係睇 Critical（嚴重問題）係咪清零
7、常見誤區：90% 嘅人會喺呢度瀨嘢
誤區 1：當佢係「提示詞合集」
Superpowers 似「流程增強器」多啲，唔係「更勁嘅 prompt」。prompt 只能影響一個回合；流程可以影響每一個回合。
誤區 2：以為流程會拖慢速度
你而家慢，往往係慢喺返工：寫錯方向 → 改 → 又錯 → 再改。
Superpowers 用「前置釐清 + 細步驗證」換「少走彎路」。
誤區 3：你自己唔願意睇計劃
Superpowers 再勁，都救唔到「你唔睇佢寫嘅計劃就俾佢開工」嘅習慣。你偷一次懶，佢就會學到：原來可以 skip 咗審查。
8、我嘅判斷：呢樣嘢會成為「編程 Agent 嘅默認形態」
我非常肯定：
未來大家比嘅重點，會由「個模型幾識寫」轉到「個工作流幾穩定」。
你可以換 Claude / GPT / Gemini，甚至換工具鏈。
但「先釐清、再計劃、隔離變更、測試驅動、階段複審、標準化收尾」呢套，遲早會變成默認。
Superpowers 只係將佢做得更早、更系統、更可複製。
參考連結
GitHub 倉庫：https://github.com/obra/superpowers README ：https://raw.githubusercontent.com/obra/superpowers/main/README.md 作者公告：https://blog.fsck.com/2025/10/09/superpowers/
-END-
更多關於AI工具、Cursor、Skills、MCP相關嘅教學同資訊請繼續關注之後嘅分享！
本文完整版詳見公眾號：未來的迴響
文章精校版參見知識星球：AI工具實戰派
【限時開放】歡迎加入AI工具實戰派交流羣一齊學習進步～
AI編程、AI運營、工具資料分享請加入知識星球
-推薦閲讀-
【AI編程】
【AI設計】
【AI工具】
如果你用過 Claude Code / Cursor / Codex 這類編程 Agent，大概率都被同一件事折磨過：
你讓它“修個小 bug”，它順手重構半個項目 你說“先別寫代碼，聊方案”，它嘴上答應，轉頭開寫 你讓它“跑測試”，它說“已驗證”，其實什麼都沒跑 你想並行做兩條需求，它倆互相覆蓋文件，最後一地雞毛
obra/superpowers 真正要解決的，不是“模型夠不夠聰明”，而是更現實的那句：沒有流程的智能，會把工程變成玄學。
它給編程 Agent 貼了一套“工程紀律”：先澄清 → 出設計 → 拆計劃 → 用 worktree 隔離 → TDD 紅綠燈 → 子代理執行 + 複審 → 收尾出 PR/合併。 聽起來像“項目管理”，但真正厲害的是：這套流程是用 skills（技能文檔）強制注入給 Agent 的，不是靠你每天覆制粘貼提示詞。
下面我按“它到底做了什麼 / 為什麼有效 / 怎麼上手 / 怎麼用出結果”把它拆開講清楚。
1、Superpowers 到底是什麼？一句話講人話
Superpowers 是一套給編程 Agent 用的“技能框架 + 軟件開發方法論”，核心目標就一個：
讓 Agent 按工程流程做事，而不是按它的衝動寫代碼。
你可以把它理解成：
你以前是“對着 Agent 喊話” 現在是“給 Agent 配了一套 SOP（標準作業流程）+ 檢查清單 + 強約束流程”
它不是隻綁定某一個平台：同一套理念覆蓋 Claude Code、Cursor、Codex、Gemini CLI、Copilot CLI 等多個“harness”（官方叫法）。
2、它為什麼能讓 Agent 變靠譜？關鍵在“把好習慣做成默認行為”
Superpowers 最反直覺的一點是：它不靠你變強，它靠“默認流程”變強。
作者在發佈公告裏把“啓動鈎子（bootstrap）”講得非常明確：一啓動就強制模型去讀 getting-started 的 SKILL.md，並且灌輸三件事（我用大白話翻譯）：
你有 skills，這玩意會給你超能力 你要先去找 skills，找到就讀，然後照做 如果有 skill 能做這件事，就必須用
這聽上去像“規矩”，但對 Agent 特別有效：它把“先計劃、再測試、隔離分支、階段複審”這些工程師自覺，變成了模型的默認動作。
3、最核心的 7 步工作流：看起來很“流程”，但每一步都在替你堵坑
官方給的 Basic Workflow 一共 7 步，我逐條拆給你看它“堵住了什麼坑”。
3.1 brainstorming：先把需求問清楚（別急着寫）
它會在寫代碼前用問題把目標“擠出來”，並把設計按小塊展示給你確認。
它解決的坑：
你只說了 60 分的需求，Agent 用 120 分的想象補齊，然後寫出 0 分的結果 你想要的是 A，它自作主張做成 B
3.2 using-git-worktrees：把改動隔離到 worktree（避免互相污染）
設計確認後，如果在 git repo 裏，它會創建 worktree，在新工作目錄裏做事。
它解決的坑：
並行兩條任務互相覆蓋文件 試驗性改動污染主分支，回不去 “我只是想試試”最後變成“我好像改對了但不敢提交”
3.3 writing-plans：把任務拆成 2-5 分鐘的小塊（而且寫清文件路徑）
它強調：每個任務都要有確切文件路徑、完整代碼、驗證步驟。
它解決的坑：
Agent 寫一個“宏大方案”，你看完仍然不知道下一步改哪個文件 計劃裏全是形容詞（“優化”“增強”“重構”），沒有可執行動作
3.4 subagent-driven-development / executing-plans：把實現丟給子代理做，再複審
它提供兩種執行方式：
傳統方式：你開第二個會話當 PM 新方式：逐個任務派發給子代理實現，並做兩階段 review（合規 + 質量） 它解決的坑： 一個 Agent 從頭做到尾，越寫越嗨，越偏越遠 沒有“階段性剎車”，出問題時已經改了 30 個文件
3.5 test-driven-development：紅→綠→重構（而且“先寫的沒測試就刪掉”）
它強調真 TDD：先寫失敗測試 → 看它失敗 → 寫最小實現讓它過 → 再重構。 甚至寫得很狠：刪掉那些沒測試就先寫出來的代碼。 它解決的坑：
Agent 很會“寫看起來對的代碼”，但不會“寫可證明對的代碼” 你以為它測了，其實只是“腦測”
3.6 requesting-code-review：每個階段做 code review，Critical 必須修
它把“複審”做成流程，不讓它糊弄過去。
它解決的坑：
功能能跑，但安全性、邊界條件、可維護性一塌糊塗 你想 review，但你沒精力每行都看
3.7 finishing-a-development-branch：收尾動作標準化（PR / merge / 清理）
做完會驗證測試，並提供：提 PR、把 worktree 合併回源分支、或停止。
它解決的坑：
“做完了”其實只是跑通本機，沒有可交付物 worktree 留一堆，後面越積越亂
4、真正“有貨”的地方：Skills 才是發動機，不是裝飾
發佈公告裏有一句話很直白：“Skills are the interesting part.”
為什麼？因為 skills 讓 Agent 的行為從“靠記憶和自覺”變成“靠規則和流程”。
作者還做了“壓力測試（pressure test）”：用“生產事故每分鐘虧 5000 美元”的場景逼問 Agent：你是直接開始 debug，還是先去找 debugging skill？然後根據失敗情況不斷強化 getting-started 的指令，讓未來的 Claude 更守規矩。
你可以把它類比成：
沒有 skills 的 Agent：聰明但沒受過工程訓練的實習生 有 skills 的 Agent：聰明 + 有班組長盯流程 + 每一步要打卡的工程師
5、怎麼安裝？選你正在用的那套工具就行
下面命令來自官方 README，我只做中文解釋，不擅自改命令。
5.1 Claude Code（官方市場）
或使用 Superpowers 自己的 marketplace：
5.2 Cursor
在 Cursor Agent chat 裏：
6、我建議你這樣用：先拿一個小任務試出手感
如果你從沒用過“流程化”的 Agent，建議第一週只練 3 件事：
只讓它做 brainstorming + plan（你先不讓它寫代碼） 只讓它用 worktree 做隔離（你會立刻感覺世界清淨了） 只讓它按 TDD 走一遍（哪怕是一個很小的函數改動）
等你發現它終於“不亂改、會問問題、能驗證復現”之後，再把子代理執行、code review 等環節加上去。
為了讓你更快上手，我給你一個可直接照抄的“首次試跑清單”（10 分鐘版本）：
選一個極小任務：比如“修一個測試”“補一個邊界條件” 先讓它只做 brainstorming：把需求、約束、風險問清楚 讓它寫 plan：每步對應到文件路徑 + 驗證方式 進入 worktree：確保改動不污染主分支 跑一遍真 TDD：先讓測試失敗，再讓它變綠 做一次 review：只看 Critical（嚴重問題）是否清零
7、常見誤區：90% 的人會在這裏翻車
誤區 1：把它當“提示詞合集”
Superpowers 更像“流程增強器”，不是“更強的 prompt”。prompt 只能影響一回合；流程能影響每一回合。
誤區 2：以為流程會拖慢速度
你現在慢，往往慢在返工：寫錯方向 → 改 → 又錯 → 再改。
Superpowers 用“前置澄清 + 小步驗證”換“少走彎路”。
誤區 3：你自己不願意看計劃
Superpowers 再強，也救不了“你不看它寫的計劃就讓它開寫”的習慣。你偷一次懶，它就會學到：原來可以跳過審查。
8、我的判斷：這東西會成為“編程 Agent 的默認形態”
我非常確定：
未來大家比的重點，會從“模型多會寫”轉到“工作流多穩定”。
你可以換 Claude / GPT / Gemini，甚至換工具鏈。
但“先澄清、再計劃、隔離變更、測試驅動、階段複審、標準化收尾”這一套，遲早會變成默認。
Superpowers 只是把它做得更早、更系統、更可複製。
參考連結
GitHub 倉庫：https://github.com/obra/superpowers README ：https://raw.githubusercontent.com/obra/superpowers/main/README.md 作者公告：https://blog.fsck.com/2025/10/09/superpowers/
-END-
更多關於AI工具、Cursor、Skills、MCP相關的教程和資訊請持續關注後續分享！
本文完整版詳見公眾號：未來的迴響
文章精校版參見知識星球：AI工具實戰派
【限時開放】歡迎加入AI工具實戰派交流羣一起學習進步～
AI編程、AI運營、工具資料分享請加入知識星球
-推薦閲讀-
【AI編程】
【AI設計】
【AI工具】