superpowers 憑什么讓 AI 編碼助手工程化obra/superpowers單周新增30k stars直接拿下雙榜冠軍目前總 Star 突破27.6 萬。但很多人誤以為它又是一個提示詞模板。錯了。superpowers 不是更好的 prompt而是一套把軟件工程紀(jì)律變成 AI 編碼代理默認(rèn)行為的技能框架。這篇我們從架構(gòu)設(shè)計、技能激活機(jī)制、TDD 強(qiáng)制、subagent 協(xié)作、worktree 隔離五個技術(shù)維度把它拆開看。版本說明以下基于官方倉庫 v5.1.0約 203k Stars、18.1k Forks結(jié)構(gòu)分析。作者 Jesse VincentGitHub: obra2025 年 10 月首發(fā)。01 核心洞察AI 編碼助手缺的不是能力是紀(jì)律superpowers 解決的根本問題不是模型不夠聰明而是AI 編碼代理的三大失控點(diǎn)失控點(diǎn)表現(xiàn)后果搶跑需求沒澄清就寫代碼做了一堆錯的事漏測寫完但沒測試驗證假的完成早宣告成功沒驗證就報好了集成時才爆雷superpowers 的設(shè)計哲學(xué)一句話把靠自覺完成的工程動作改成 agent 的默認(rèn)強(qiáng)制路徑。它不提升模型上限但把模型的下限拉到像樣的高級工程師。02 倉庫結(jié)構(gòu)分發(fā)面與強(qiáng)制面分離先看清 superpowers 的物理結(jié)構(gòu)才能理解它怎么生效obra/superpowers/ ├── .claude-plugin/ # Claude Code 插件定義 ├── .codex-plugin/ # Codex 插件定義 ├── .cursor-plugin/ # Cursor 插件定義 ├── .opencode/ # opencode 配置 ├── gemini-extension.json # Gemini CLI 擴(kuò)展 ├── skills/ # 核心可調(diào)用技能目錄 │ ├── workflow/ # 工作流類brainstorming/planning │ ├── debugging/ # 調(diào)試類systematic-debugging │ ├── testing/ # 測試類test-driven-development │ └── meta/ # 元技能writing-skills ├── hooks/ # 檢查技能是否被遵守 ├── tests/ # 跨 harness 驗證流程 ├── AGENTS.md # 強(qiáng)制面入口通用 ├── CLAUDE.md # 強(qiáng)制面入口Claude └── GEMINI.md # 強(qiáng)制面入口Gemini關(guān)鍵設(shè)計分發(fā)面 ≠ 強(qiáng)制面安裝插件只是分發(fā)技能文件到本地真正的約束靠AGENTS.md/CLAUDE.md等強(qiáng)制面入口文件——它們在會話開始時注入有技能就必須用技能先查技能再行動的強(qiáng)制提示hooks/和tests/負(fù)責(zé)驗證這些技能在真實(shí)會話里有沒有被跳過這就是為什么 superpowers 能在 Claude Code、Cursor、Codex、Gemini、Copilot、Kimi、Hermes 等 9 平臺上通用——它不強(qiáng)依賴某個模型的特性而是用入口文件 技能目錄這套通用范式掛鉤。03 技能如何自動激活不是建議是強(qiáng)制普通提示詞框架是建議你用 TDDsuperpowers 是每個任務(wù)前必須檢查相關(guān)技能。激活機(jī)制三層① 強(qiáng)制面入口文件AGENTS.md在會話啟動時注入核心約束“遇到開發(fā)任務(wù)先查 skills 目錄里有沒有對應(yīng)技能有就必須用不要憑直覺?！雹?觸發(fā)時機(jī)README 明確agent 會在每個任務(wù)前檢查相關(guān) skills。skill 是入口不是補(bǔ)充材料。③ 驗證面hooks/testshooks/檢查技能是否在真實(shí)代理會話里被遵守tests/專門驗證時間壓力大 / 沉沒成本高的場景下agent 有沒有偷懶跳過技能。常見不生效原因根據(jù)官方說明三種情況會導(dǎo)致技能沒激活沒重啟會話加載入口文件觸發(fā)的不是開始任務(wù)信號比如在閑聊中當(dāng)前目錄不是 Git 干凈基線worktree 信號不顯04 TDD 強(qiáng)制RED → GREEN → REFACTORtest-driven-development技能把測試驅(qū)動開發(fā)變成不可繞過的流程強(qiáng)制順序RED紅 → 先寫測試看到它失敗 GREEN綠 → 寫最小實(shí)現(xiàn)讓測試通過 REFACTOR重構(gòu)→ 在測試保護(hù)下重構(gòu)官方表述很硬“測試之前寫出來的代碼該刪就刪?！睘槭裁催@個設(shè)計有效普通 AI 編碼是先寫一大坨再補(bǔ)測試糊弄一下。superpowers 反向操作——先讓測試失敗再寫實(shí)現(xiàn)。這強(qiáng)制 agent先想清楚什么叫對測試即規(guī)格不寫無法驗證的代碼重構(gòu)時有安全網(wǎng)這直接解決了AI 寫完的代碼其實(shí)沒跑過的行業(yè)頑疾。05 Subagent 兩階段審查先查偏題再查風(fēng)格subagent-driven-development或executing-plans是 superpowers 放大量吞吐的核心。但它不是簡單地開 N 個 agent 并行而是有兩階段審查紀(jì)律審查順序階段一Spec compliance規(guī)格符合性先判斷有沒有做對有沒有偏題這是優(yōu)先級最高的檢查階段二Code quality代碼質(zhì)量再判斷寫得好不好風(fēng)格對不對設(shè)計邏輯為什么要分兩階段因為如果 agent 已經(jīng)做偏了spec 不對再去糾結(jié)代碼風(fēng)格毫無意義。先糾偏再提質(zhì)——避免一個上下文越做越歪。這也是 superpowers 解決長任務(wù)偏航的關(guān)鍵把大任務(wù)拆成小任務(wù)派給 subagent每個小任務(wù)完成后先過 spec 再過質(zhì)量。06 Git Worktree 隔離在什么時候建工作區(qū)using-git-worktrees技能的觸發(fā)時機(jī)很講究——不是一開始建工作區(qū)而是 brainstorming 設(shè)計獲批之后、寫計劃之前。隔離原理創(chuàng)建隔離工作區(qū)worktree切到新分支驗證干凈基線沒有未提交改動為什么必須在這一步“沒有隔離你很難判斷修改是否帶入問題?！痹O(shè)計獲批前就建 worktree等于在需求還模糊時占坑設(shè)計獲批后建才能保證主分支不被半成品污染出問題容易回滾多個任務(wù)并行時不互相踩前置依賴當(dāng)前目錄必須是 Git 倉庫且基線干凈。否則 worktree 信號不顯技能不觸發(fā)。07 Writing-plans把 spec 變成傻瓜可執(zhí)行清單writing-plans是 superpowers 里最容易被低估、卻最關(guān)鍵的技能。它定義了計劃拆解的粒度標(biāo)準(zhǔn)粒度標(biāo)準(zhǔn)每個步驟2 到 5 分鐘能完成文檔要清楚到一個熱情但品味不佳、沒有判斷力、沒有項目上下文、不愛測試的初級工程師也能執(zhí)行每個步驟含確切文件路徑 代碼草圖為什么這個標(biāo)準(zhǔn)厲害AI agent 在長流程里偏航往往是因為計劃太粗——實(shí)現(xiàn)登錄功能這種粒度agent 會自由發(fā)揮。拆成在auth.ts第 12 行加 token 校驗參考utils/jwt.ts的sign()這種粒度agent 就沒多少自由發(fā)揮空間了。writing-plans 是 spec 變可執(zhí)行清單的橋梁直接決定了后續(xù) subagent 執(zhí)行的成功率。08 Brainstorming寫代碼前先問清楚brainstorming在所有技能里最靠前——開始寫代碼之前必須觸發(fā)。蘇格拉底式提問agent 通過提問澄清單人用還是協(xié)作需要持久化嗎要登錄嗎移動端支持嗎設(shè)計哲學(xué)“不澄清需求和邊界后面計劃再細(xì)也只是把錯事做工整。”brainstorming 解決的是搶跑失控點(diǎn)——先確認(rèn)做什么、不做什么再談怎么做。09 完整實(shí)戰(zhàn)用 superpowers 寫一個 React Todo List輸入“Let’s make a React todo list”Step 1 — Brainstormingagent 先問單人還是協(xié)作要持久化嗎localStorage要登錄嗎要移動端適配嗎你答單人、localStorage 持久化、不要登錄、桌面優(yōu)先。Step 2 — Using Git Worktrees設(shè)計確認(rèn)后agent 建隔離工作區(qū)、切新分支、驗證干凈基線。Step 3 — Writing Plans拆成① 項目骨架 ② 列表渲染與交互 ③ localStorage 存儲 ④ 測試 review。Step 4 — Subagent Dispatch你說go后agent 派發(fā) subagent 并行推進(jìn)各步驟。Step 5 — TDD 每步每步先寫測試看到 RED再寫實(shí)現(xiàn)到 GREEN最后 REFACTOR。Step 6 — Code Review任務(wù)之間requesting-code-review攔截關(guān)鍵缺陷不是所有問題都攔但嚴(yán)重問題必須解決。Step 7 — Finishing Branch完成finishing-a-development-branch統(tǒng)一驗證給你選項 merge / PR / keep / discard。怎么判斷 superpowers 真生效了盯三個信號? 先問清需求brainstorming 觸發(fā)? 拆細(xì)計劃writing-plans 輸出 2-5 分鐘粒度? TDD 真見失敗測試不是我寫好了而是測試先紅了三個都滿足說明框架在起作用缺一個說明技能被跳過了。10 安裝與配置superpowers 通過各編碼工具的插件市場安裝# Claude Code/plugininstallsuperpowersclaude-plugins-official# Cursor/add-plugin superpowers# Codex# 插件市場搜索安裝# Gemini CLIgemini extensionsinstallhttps://github.com/obra/superpowers# Kimi Code/pluginsinstallhttps://github.com/obra/superpowers# Hermes Agenthermes pluginsinstallobra/superpowers--enable安裝后無需手動操作——代理在會話啟動首條消息即自動激活 superpowers技能按場景自動觸發(fā)。關(guān)閉遙測export SUPERPOWERS_DISABLE_TELEMETRY111 亮點(diǎn)與邊界亮點(diǎn)本周雙榜冠軍27.6 萬 Star社區(qū)強(qiáng)驗證解決失控點(diǎn)搶跑 / 漏測 / 早宣告成功三個都堵上了跨工具通用9 編碼助手全支持不綁定模型可擴(kuò)展writing-skills讓你把團(tuán)隊規(guī)范寫成技能越用越貼合MIT 協(xié)議商用友好邊界必須說清楚它不提升模型上限——只會讓模型的下限更穩(wěn)。模型本身弱裝了也白搭小修小改顯啰嗦改個 typo 也走完整流程有時效率不如直接手寫依賴干凈 Git 基線臟工作區(qū)會導(dǎo)致部分技能不觸發(fā)中文文檔仍少社區(qū)以英文為主寫在最后superpowers 的爆火揭示了一個被很多人忽略的事實(shí)2026 年的 AI 編程瓶頸不在模型聰不聰明而在工程紀(jì)律有沒有被強(qiáng)制執(zhí)行。一個高級工程師的價值不是他懂多少語法而是他先想清楚、先寫測試、隔離改動、主動 review的紀(jì)律。superpowers 把這些紀(jì)律從人靠自覺變成了agent 靠框架強(qiáng)制。裝上它你的編碼助手就從熱心但毛躁的實(shí)習(xí)生變成了有流程、有標(biāo)準(zhǔn)、有交付意識的搭檔。如果你天天用 Claude Code / Cursor / Codex 寫代碼這個本周冠軍值得裝——畢竟能逼著 AI 不偷懶的框架才是好框架。GitHubhttps://github.com/obra/superpowers superpowers 憑什么讓 AI 編碼助手“工程化“？
superpowers 憑什么讓 AI 編碼助手工程化obra/superpowers單周新增30k stars直接拿下雙榜冠軍目前總 Star 突破27.6 萬。但很多人誤以為它又是一個提示詞模板。錯了。superpowers 不是更好的 prompt而是一套把軟件工程紀(jì)律變成 AI 編碼代理默認(rèn)行為的技能框架。這篇我們從架構(gòu)設(shè)計、技能激活機(jī)制、TDD 強(qiáng)制、subagent 協(xié)作、worktree 隔離五個技術(shù)維度把它拆開看。版本說明以下基于官方倉庫 v5.1.0約 203k Stars、18.1k Forks結(jié)構(gòu)分析。作者 Jesse VincentGitHub: obra2025 年 10 月首發(fā)。01 核心洞察AI 編碼助手缺的不是能力是紀(jì)律superpowers 解決的根本問題不是模型不夠聰明而是AI 編碼代理的三大失控點(diǎn)失控點(diǎn)表現(xiàn)后果搶跑需求沒澄清就寫代碼做了一堆錯的事漏測寫完但沒測試驗證假的完成早宣告成功沒驗證就報好了集成時才爆雷superpowers 的設(shè)計哲學(xué)一句話把靠自覺完成的工程動作改成 agent 的默認(rèn)強(qiáng)制路徑。它不提升模型上限但把模型的下限拉到像樣的高級工程師。02 倉庫結(jié)構(gòu)分發(fā)面與強(qiáng)制面分離先看清 superpowers 的物理結(jié)構(gòu)才能理解它怎么生效obra/superpowers/ ├── .claude-plugin/ # Claude Code 插件定義 ├── .codex-plugin/ # Codex 插件定義 ├── .cursor-plugin/ # Cursor 插件定義 ├── .opencode/ # opencode 配置 ├── gemini-extension.json # Gemini CLI 擴(kuò)展 ├── skills/ # 核心可調(diào)用技能目錄 │ ├── workflow/ # 工作流類brainstorming/planning │ ├── debugging/ # 調(diào)試類systematic-debugging │ ├── testing/ # 測試類test-driven-development │ └── meta/ # 元技能writing-skills ├── hooks/ # 檢查技能是否被遵守 ├── tests/ # 跨 harness 驗證流程 ├── AGENTS.md # 強(qiáng)制面入口通用 ├── CLAUDE.md # 強(qiáng)制面入口Claude └── GEMINI.md # 強(qiáng)制面入口Gemini關(guān)鍵設(shè)計分發(fā)面 ≠ 強(qiáng)制面安裝插件只是分發(fā)技能文件到本地真正的約束靠AGENTS.md/CLAUDE.md等強(qiáng)制面入口文件——它們在會話開始時注入有技能就必須用技能先查技能再行動的強(qiáng)制提示hooks/和tests/負(fù)責(zé)驗證這些技能在真實(shí)會話里有沒有被跳過這就是為什么 superpowers 能在 Claude Code、Cursor、Codex、Gemini、Copilot、Kimi、Hermes 等 9 平臺上通用——它不強(qiáng)依賴某個模型的特性而是用入口文件 技能目錄這套通用范式掛鉤。03 技能如何自動激活不是建議是強(qiáng)制普通提示詞框架是建議你用 TDDsuperpowers 是每個任務(wù)前必須檢查相關(guān)技能。激活機(jī)制三層① 強(qiáng)制面入口文件AGENTS.md在會話啟動時注入核心約束“遇到開發(fā)任務(wù)先查 skills 目錄里有沒有對應(yīng)技能有就必須用不要憑直覺?！雹?觸發(fā)時機(jī)README 明確agent 會在每個任務(wù)前檢查相關(guān) skills。skill 是入口不是補(bǔ)充材料。③ 驗證面hooks/testshooks/檢查技能是否在真實(shí)代理會話里被遵守tests/專門驗證時間壓力大 / 沉沒成本高的場景下agent 有沒有偷懶跳過技能。常見不生效原因根據(jù)官方說明三種情況會導(dǎo)致技能沒激活沒重啟會話加載入口文件觸發(fā)的不是開始任務(wù)信號比如在閑聊中當(dāng)前目錄不是 Git 干凈基線worktree 信號不顯04 TDD 強(qiáng)制RED → GREEN → REFACTORtest-driven-development技能把測試驅(qū)動開發(fā)變成不可繞過的流程強(qiáng)制順序RED紅 → 先寫測試看到它失敗 GREEN綠 → 寫最小實(shí)現(xiàn)讓測試通過 REFACTOR重構(gòu)→ 在測試保護(hù)下重構(gòu)官方表述很硬“測試之前寫出來的代碼該刪就刪?！睘槭裁催@個設(shè)計有效普通 AI 編碼是先寫一大坨再補(bǔ)測試糊弄一下。superpowers 反向操作——先讓測試失敗再寫實(shí)現(xiàn)。這強(qiáng)制 agent先想清楚什么叫對測試即規(guī)格不寫無法驗證的代碼重構(gòu)時有安全網(wǎng)這直接解決了AI 寫完的代碼其實(shí)沒跑過的行業(yè)頑疾。05 Subagent 兩階段審查先查偏題再查風(fēng)格subagent-driven-development或executing-plans是 superpowers 放大量吞吐的核心。但它不是簡單地開 N 個 agent 并行而是有兩階段審查紀(jì)律審查順序階段一Spec compliance規(guī)格符合性先判斷有沒有做對有沒有偏題這是優(yōu)先級最高的檢查階段二Code quality代碼質(zhì)量再判斷寫得好不好風(fēng)格對不對設(shè)計邏輯為什么要分兩階段因為如果 agent 已經(jīng)做偏了spec 不對再去糾結(jié)代碼風(fēng)格毫無意義。先糾偏再提質(zhì)——避免一個上下文越做越歪。這也是 superpowers 解決長任務(wù)偏航的關(guān)鍵把大任務(wù)拆成小任務(wù)派給 subagent每個小任務(wù)完成后先過 spec 再過質(zhì)量。06 Git Worktree 隔離在什么時候建工作區(qū)using-git-worktrees技能的觸發(fā)時機(jī)很講究——不是一開始建工作區(qū)而是 brainstorming 設(shè)計獲批之后、寫計劃之前。隔離原理創(chuàng)建隔離工作區(qū)worktree切到新分支驗證干凈基線沒有未提交改動為什么必須在這一步“沒有隔離你很難判斷修改是否帶入問題?！痹O(shè)計獲批前就建 worktree等于在需求還模糊時占坑設(shè)計獲批后建才能保證主分支不被半成品污染出問題容易回滾多個任務(wù)并行時不互相踩前置依賴當(dāng)前目錄必須是 Git 倉庫且基線干凈。否則 worktree 信號不顯技能不觸發(fā)。07 Writing-plans把 spec 變成傻瓜可執(zhí)行清單writing-plans是 superpowers 里最容易被低估、卻最關(guān)鍵的技能。它定義了計劃拆解的粒度標(biāo)準(zhǔn)粒度標(biāo)準(zhǔn)每個步驟2 到 5 分鐘能完成文檔要清楚到一個熱情但品味不佳、沒有判斷力、沒有項目上下文、不愛測試的初級工程師也能執(zhí)行每個步驟含確切文件路徑 代碼草圖為什么這個標(biāo)準(zhǔn)厲害AI agent 在長流程里偏航往往是因為計劃太粗——實(shí)現(xiàn)登錄功能這種粒度agent 會自由發(fā)揮。拆成在auth.ts第 12 行加 token 校驗參考utils/jwt.ts的sign()這種粒度agent 就沒多少自由發(fā)揮空間了。writing-plans 是 spec 變可執(zhí)行清單的橋梁直接決定了后續(xù) subagent 執(zhí)行的成功率。08 Brainstorming寫代碼前先問清楚brainstorming在所有技能里最靠前——開始寫代碼之前必須觸發(fā)。蘇格拉底式提問agent 通過提問澄清單人用還是協(xié)作需要持久化嗎要登錄嗎移動端支持嗎設(shè)計哲學(xué)“不澄清需求和邊界后面計劃再細(xì)也只是把錯事做工整。”brainstorming 解決的是搶跑失控點(diǎn)——先確認(rèn)做什么、不做什么再談怎么做。09 完整實(shí)戰(zhàn)用 superpowers 寫一個 React Todo List輸入“Let’s make a React todo list”Step 1 — Brainstormingagent 先問單人還是協(xié)作要持久化嗎localStorage要登錄嗎要移動端適配嗎你答單人、localStorage 持久化、不要登錄、桌面優(yōu)先。Step 2 — Using Git Worktrees設(shè)計確認(rèn)后agent 建隔離工作區(qū)、切新分支、驗證干凈基線。Step 3 — Writing Plans拆成① 項目骨架 ② 列表渲染與交互 ③ localStorage 存儲 ④ 測試 review。Step 4 — Subagent Dispatch你說go后agent 派發(fā) subagent 并行推進(jìn)各步驟。Step 5 — TDD 每步每步先寫測試看到 RED再寫實(shí)現(xiàn)到 GREEN最后 REFACTOR。Step 6 — Code Review任務(wù)之間requesting-code-review攔截關(guān)鍵缺陷不是所有問題都攔但嚴(yán)重問題必須解決。Step 7 — Finishing Branch完成finishing-a-development-branch統(tǒng)一驗證給你選項 merge / PR / keep / discard。怎么判斷 superpowers 真生效了盯三個信號? 先問清需求brainstorming 觸發(fā)? 拆細(xì)計劃writing-plans 輸出 2-5 分鐘粒度? TDD 真見失敗測試不是我寫好了而是測試先紅了三個都滿足說明框架在起作用缺一個說明技能被跳過了。10 安裝與配置superpowers 通過各編碼工具的插件市場安裝# Claude Code/plugininstallsuperpowersclaude-plugins-official# Cursor/add-plugin superpowers# Codex# 插件市場搜索安裝# Gemini CLIgemini extensionsinstallhttps://github.com/obra/superpowers# Kimi Code/pluginsinstallhttps://github.com/obra/superpowers# Hermes Agenthermes pluginsinstallobra/superpowers--enable安裝后無需手動操作——代理在會話啟動首條消息即自動激活 superpowers技能按場景自動觸發(fā)。關(guān)閉遙測export SUPERPOWERS_DISABLE_TELEMETRY111 亮點(diǎn)與邊界亮點(diǎn)本周雙榜冠軍27.6 萬 Star社區(qū)強(qiáng)驗證解決失控點(diǎn)搶跑 / 漏測 / 早宣告成功三個都堵上了跨工具通用9 編碼助手全支持不綁定模型可擴(kuò)展writing-skills讓你把團(tuán)隊規(guī)范寫成技能越用越貼合MIT 協(xié)議商用友好邊界必須說清楚它不提升模型上限——只會讓模型的下限更穩(wěn)。模型本身弱裝了也白搭小修小改顯啰嗦改個 typo 也走完整流程有時效率不如直接手寫依賴干凈 Git 基線臟工作區(qū)會導(dǎo)致部分技能不觸發(fā)中文文檔仍少社區(qū)以英文為主寫在最后superpowers 的爆火揭示了一個被很多人忽略的事實(shí)2026 年的 AI 編程瓶頸不在模型聰不聰明而在工程紀(jì)律有沒有被強(qiáng)制執(zhí)行。一個高級工程師的價值不是他懂多少語法而是他先想清楚、先寫測試、隔離改動、主動 review的紀(jì)律。superpowers 把這些紀(jì)律從人靠自覺變成了agent 靠框架強(qiáng)制。裝上它你的編碼助手就從熱心但毛躁的實(shí)習(xí)生變成了有流程、有標(biāo)準(zhǔn)、有交付意識的搭檔。如果你天天用 Claude Code / Cursor / Codex 寫代碼這個本周冠軍值得裝——畢竟能逼著 AI 不偷懶的框架才是好框架。GitHubhttps://github.com/obra/superpowers