頂流編碼Skill!superpowers 憑什麼狂攬178k Stars?
整理版優先睇
superpowers 用 Skill 檔案為 AI 編程助手建立工作紀律,多步驟複雜任務不再頻繁跑偏
呢篇文章講嘅係 superpowers 呢個開源項目,佢嘅原版喺 GitHub 上已經有 178k Stars。作者指出,而家嘅 AI 模型(例如 Claude Code)雖然識得寫代碼,但欠缺一套穩定嘅工作方法論,成日即興發揮,導致多步驟、多文件嘅真實開發場景頻頻出事。superpowers 嘅核心解決方案係一堆 Markdown 格式嘅 Skill 檔案,每個 Skill 定義一個工作流程(例如系統化調試、測試驅動開發),Claude Code 啓動時會讀取呢啲 Skill,遇到對應場景就自動跟住步驟做,唔再自由發揮。
文章仲介紹咗本地化版本 superpowers-zh,由中文翻譯加埋針對國內開發場景的原創 Skill,支援 17 款 AI 工具(包括通義靈碼、Trae 等),Git 工作流同代碼審查都適配咗國內習慣。安裝好之後,原本需要手動指示嘅步驟(例如問需求、寫方案、拆任務)會由 Skills 自動激活,成個過程「潤物細無聲」。
總結嚟講,AI 編程助手唔係唔識 TDD 或者規劃,係缺少一個機制強迫佢哋喺寫代碼前先停低諗清楚。Skills 就係呢個機制,而 superpowers-zh 令到國內開發者可以開箱即用。
- AI 會寫代碼但唔會「幹活」,因為缺乏紀律同固定流程,多步驟任務易出錯。
- superpowers 用 Skill 檔案(Markdown)為 Claude Code 等工具裝上工作 SOP,自動觸發對應流程。
- 英文原版支援 6 款工具,superpowers-zh 擴充到 17 款,並加入中文代碼審查、Git 工作流等原創 Skill。
- 安裝後,Claude 會先問清楚需求、提供方案,再逐步實現,每一步有 verification-before-completion 把關。
- 本質係 AI 唔識紀律,Skills 就係強迫佢哋跟足步驟嘅機制,全部檔案公開可改,適合自訂。
superpowers-zh GitHub 倉庫
本地化版本,包含中文翻譯、國內工具支援同原創 Skill,適合國內開發者使用。
AI 寫到代碼但做唔到嘢:問題出喺紀律
Claude Code 4.7 全系列唔好用,新模型甚至喺諸多方面不如 4.6
雖然官方話降智已經修復,但實際用起嚟仍然欠佳。直到用咗 superpowers 漢化版,先揾返當年 Opus 嘅感覺。而家嘅 AI 模型寫代碼能力越嚟越接近,但會寫代碼同會幹活完全係兩回事。
- 合格碼農接到需求會先問:邊界條件?有冇現成模塊?測試點樣跑?會唔會影響其他地方?
- Claude Code 出廠默認冇呢套流程,你講乜佢就做乜,導致多步驟、多文件、有約束條件嘅場景頻頻出錯。
用 Skill 檔案幫 AI 裝套工作 SOP
superpowers 要解決嘅正正係呢個問題。佢嘅做法係用一堆 Markdown 檔案,每個檔案描述一個工作方法論,叫 Skill。Claude Code 啓動時會讀取呢啲 Skill,之後遇到對應場景就跟住步驟做,而唔係自己即興發揮。
例如「系統化調試」Skill 規定咗四階段調試法,唔準喺未揾到根因之前就鬱代碼
測試驅動開發 Skill 嚴格執行紅綠重構循環:一定要先寫失敗嘅測試,再寫實現代碼
原版 178k Stars vs 本地化 superpowers-zh
英文原版 superpowers 有 178k Stars,但主要支援 6 款工具,Git 工作流範例係 GitHub Actions,代碼審查風格偏向西方直接反饋文化。對於用 Gitee、Coding CI 嘅國內開發者嚟講,需要自己改好多嘢。
superpowers-zh 完整翻譯咗英文上游 14 個 Skills,再加咗 6 個原創 Skill:中文代碼審查、中文 Git 工作流、中文技術文檔等
- 工具覆蓋由 6 款擴充到 17 款,包括 Qwen Code、Trae、Kiro、Hermes Agent 等國內常用工具。
- Git 工作流適配 Gitee、Coding、極、CNB 等平台,唔使自己摸索。
- 中文技術文檔 Skill 專門處理中英文混排嘅排版規範。
安裝好之後,你唔需要手動觸發任何命令,Skills 會根據上文下理自動激活,可以話係潤物細無聲。
裝咗之後有乜唔同?一個例子就明
未裝 superpowers-zh 時,你話「畀用戶模塊加個批量導出功能」,Claude 即刻開始寫 exportUsers() 函數。裝咗之後,Claude 會先進入 brainstorming Skill,主動問你:導出格式係 CSV 定 Excel?預計數據量幾大?權限控制嘅粒度係點?
得到答案後,Claude 會畀 2-3 個方案,等你確認設計方向,再進入 writing-plans Skill 拆任務,最後逐步實現
每一步都有 verification-before-completion 把關,聲稱完成之前一定要先跑驗證。全部自動化,你唔需要手動觸發。
- 1 第一步:brainstorming Skill 自動激活,問清楚需求細節同邊界。
- 2 第二步:提供多個方案,由開發者確認設計方向。
- 3 第三步:writing-plans Skill 將任務拆細。
- 4 第四步:逐步實現,每個 step 用 verification-before-completion 驗證。
安裝簡單,第一性原理理解本質
安裝好簡單,用一條命令就搞掂:npx superpowers-zh。佢會自動檢測你項目用緊邊個 AI 工具,然後將 Skills 安裝到對應位置。如果檢測唔到,可以手動指定工具。
cd /your/project
npx superpowers-zh
# 如果自動識別唔到,可以指定工具:
npx superpowers-zh --tool cursor
用 Claude Code 嘅話,安裝完重啓 Claude Code,Skills 就會喺啓動時自動加載。其他工具各有對應嘅設定檔位置,README 有詳細說明。
superpowers-zh 喺呢個基礎上加咗中文表達習慣同國內工具生態,令到呢套方法論對國內開發者開箱即用
所有 Skill 檔案都係公開嘅,邏輯透明,你可以改,亦可以自己寫新嘅。
雖然官方已經承認降智(即係話AI變蠢咗)並聲稱已修復,GPT-5.5一出,Claude就承認降智
但最近Claude Code 4.7成個系列真係好難用。
新模型甚至喺好多方面嘅表現都唔及舊嘅4.6,俾Codex 5.5打到爆。
直到琴日再試用咗一下漢化版嘅superpowers,先隱約揾返當年第一次見到Opus嘅感覺。
AI 識寫code,但唔識「做嘢」
其實而家啲AI模型嘅能力越來越接近,尤其係寫code方面。
但是識寫code和同識做嘢完全係兩回事。
一個合格嘅programmer接到需求,第一步唔係開editor。
佢會先問:
邊界條件係咩?有冇現成嘅module可以重用?test點樣行?呢個改動會唔會搞亂其他地方?
Claude Code 出廠預設冇呢套流程。你話咩,佢就做咩,而且每次都由零開始諗點樣做。
佢已經具備debug、規劃、重構嘅能力,但問題係佢每次都係即興發揮,而唔係按一套穩定嘅方法論嚟做。
結果就係,簡單任務冇問題,一旦去到多步驟、多檔案、有約束條件嘅真實開發場景,佢就開始成日走錯方向。
所以後尾就有咗管住佢嘅Claude.md、Memory.md,用嚟管理長程任務,詳細可以睇呢度Claude Code 長程任務嘅記憶管理方案
俾AI裝返套工作SOP
上面講嘅問題同樣都係superpowers要解決嘅。
AI編程助手缺嘅唔係能力,而係紀律。
而紀律需要條文。呢啲條文就係一堆Markdown檔案,每個檔案描述一個工作方法論,叫做Skill。
Claude Code啟動時讀取呢啲Skill,之後遇到對應場景就跟住Skill裏面嘅步驟做,而唔係自己即興發揮。
例如「系統化調試」呢個Skill。
規定咗四階段調試法:唔準喺未搞清楚根本原因之前就鬱code。
唔係要你手動觸發,而係Claude遇到bug時會自動進入呢個流程。
再例如測試驅動開發(TDD)嘅Skill。
嚴格執行紅綠重構循環:一定要先寫會fail嘅test,再寫實現代碼。
如果Claude想喺test之前寫code,呢個Skill會叫佢刪咗code再嚟過。
所謂嘅編程提示詞技巧,就係有法可依、有據可循。
178k Stars
英文原版superpowers而家喺GitHub上攞到178k Stars。
雖然啲Stars咁高,但係裏面冇乜特別高深嘅code。
主要部分全部係一堆Skill。
核心得三個部分:14個SKILL.md檔案,一個啟動hook,加上各平台嘅發現清單。
因為係純文字檔案,技能檔案係同宿主無關嘅,同一套skills/目錄,支援Claude Code、Cursor、Codex、Copilot CLI、Gemini CLI、OpenCode。
但英文版對國內開發者有個現實障礙:只支援6款工具,Git工作流範例全部係GitHub Actions,code審查風格係西方團隊嘅直接反饋文化。用喺Gitee項目上、Coding CI流水線上,要自己改好多嘢。
為國內開發者重新做一次
superpowers-zh喺原倉庫嘅基礎上,進行咗本地化嘅適配,非常適合國內用戶使用。
佢完整翻譯咗英文上游嘅14個Skills,同時加咗6個專門針對國內開發場景嘅原創Skill:
中文代碼審查:重新適配國內團隊嘅溝通風格。
中文Git工作流:Gitee、Coding、極、CNB都有對應嘅CI配置範例,唔使自己摸索適配。
中文技術文檔:專門處理中英文混排嘅排版規範。
另一個分別係工具覆蓋範圍。
英文上游支援6款工具,superpowers-zh支援17款,包括Qwen Code、Trae、Kiro、Hermes Agent等國內開發者更常用嘅工具。
安裝之後嘅變化
都係用文章開頭嗰個場景做例子。
冇裝superpowers-zh,你話「俾用戶模塊加個批量導出功能」,Claude即刻開始寫 exportUsers() 函數。
裝咗之後,Claude會先進入brainstorming Skill,主動問你:
- 導出格式係CSV定係Excel?
- 預計數據量幾大,需唔需要異步處理?
- 權限控制嘅粒度係咩?
得到答案後,俾你2-3個方案,等你確認設計方向,再進入writing-plans Skill拆任務,最後逐步實現。
每個步驟有verification-before-completion把關,聲稱完成之前一定要先行驗證。
最新版本嘅superpowers成個過程你唔需要手動觸發任何command,Skills會根據上下文自動激活。
可以話係潤物細無聲。
安裝好簡單
項目提供一鍵安裝script,自動檢測你項目入面用咗邊個AI工具,然後將Skills安裝到對應位置:
cd /your/project
npx superpowers-zh
認唔出嘅情況可以手動指定工具:
npx superpowers-zh --tool cursor
如果你用Claude Code,安裝完成後重啟Claude Code,Skills就會喺啟動時自動加載。
Cursor、Kiro、通義靈碼等其他工具各有對應嘅配置檔案位置,README裏面有詳細說明。
第一性原理
superpowers項目嘅作者Jesse Vincent講過一個意思,係理解呢套嘢嘅關鍵本質:
AI唔係唔識TDD,叫佢講可以講一個鐘。佢缺嘅係一個機制——喺真係要寫code嘅時候拉住自己,迫自己先寫test。
Skills就係嗰個機制。
superpowers-zh喺呢個基礎上加咗中文表達習慣同國內工具生態,令到呢套方法論對國內開發者開箱即用。
Skill檔案本身係公開嘅,邏輯透明,你可以改,亦都可以自己寫新嘅。
項目地址:
github.com/jnMetaCode/superpowers-zh

雖然官方已經承認降智並聲稱已修復,GPT-5.5一發布,Claude就承認降智
但是最近Claude Code 4.7全系列是真的不好用。
新模型甚至在諸多方面的表現都不如老的4.6,各種被Codex 5.5吊打。
直到昨天再次配置使用了一下漢化版本的superpowers後,才隱約找到了當年初見Opus的感覺。
AI 會寫代碼,但不會"幹活"
其實現在的AI模型的能力越來越趨近了,尤其是寫代碼方面。
但是會寫代碼和會幹活完全是兩回事。
合格的碼農接到需求,第一步不是打開編輯器。
他會先問:
邊界條件是什麼?有沒有現有的模塊可以複用?測試怎麼跑?這個改動會不會破壞別的地方?
Claude Code 出廠默認沒有這套流程。你說什麼,它就幹什麼,而且每次都從零開始想怎麼幹。
它已經具備調試、規劃、重構的能力,可問題是它每次都在即興發揮,而不是按一套穩定的方法論來。
結果就是,簡單任務沒問題,一旦到了多步驟、多文件、有約束條件的真實開發場景,它就開始頻繁跑偏。
於是就有了後面的管束他的Claude.md,Memory.md,用於長程任務的管理,詳細可以看這裏Claude Code 長程任務的記憶管理方案
給 AI 裝一套工作 SOP
上面的問題同樣也是superpowers 要解決的。
AI 編程助手缺的不是能力,而是紀律。
而紀律需要條文。這些條文就是一堆 Markdown 文件,每個文件描述一個工作方法論,叫做 Skill。
Claude Code 啓動時讀取這些 Skill,之後遇到對應場景就按 Skill 裏的步驟來,而不是自己即興發揮。
比如"系統化調試"這個 Skill。
規定了四階段調試法:不允許在沒弄清根因之前就動代碼。
不是讓你手動觸發,是 Claude 遇到 bug 時自動進入這個流程。
再比如測試驅動開發的 Skill。
嚴格執行紅綠重構循環:必須先寫失敗的測試,再寫實現代碼。
如果 Claude 想在測試之前寫代碼,這個 Skill 會讓它把代碼刪掉重來。
所謂的編程提示詞技巧,就是有法可依,有據可循。
178k Stars
英文原版 superpowers 項目現在 GitHub 上 178k Stars。
雖然是這麼高的Star,但是裏面沒有什麼特別高深的代碼。
主體部分全是一堆的Skill。
核心就三個部分:14 個 SKILL.md 文件,一個啓動 hook,加上各平台的發現清單。
因為是純文本文件,技能文件是宿主無關的,同一套 skills/ 目錄,支持 Claude Code、Cursor、Codex、Copilot CLI、Gemini CLI、OpenCode。
但英文版對國內開發者有個現實障礙:只支持 6 款工具,Git 工作流示例全是 GitHub Actions,代碼審查風格是西方團隊的直接反饋文化。用在 Gitee 項目上、Coding CI 流水線上,得自己改不少東西。
為國內開發者重新做一遍
superpowers-zh 在原倉庫的基礎上,進行了本地化的適配,非常適合國區用戶來使用。
它完整翻譯了英文上游的 14 個 Skills,同時加了 6 個專門針對國內開發場景的原創 Skill:
中文代碼審查:重新適配國內團隊的溝通風格。
中文 Git 工作流:Gitee、Coding、極、CNB都有對應的 CI 配置示例,不用自己摸索適配。
中文技術文檔:專門處理中英文混排的排版規範。。
另一個差別是工具覆蓋範圍。
英文上游支持 6 款工具,superpowers-zh 支持 17 款,包括Qwen Code、Trae、Kiro、Hermes Agent 等國內開發者更常用的工具。
裝了之後的變化
還是用文章開頭那個場景舉例。
沒裝 superpowers-zh,你說"給用戶模塊加個批量導出功能",Claude 立刻開始寫 exportUsers() 函數。
裝了之後,Claude 會先進入 brainstorming Skill,主動問你:
- 導出格式是 CSV 還是 Excel?
- 預計數據量多大,需要異步處理嗎?
- 權限控制的粒度是什麼?
得到答案後,給你 2-3 個方案,等你確認設計方向,再進入 writing-plans Skill 拆任務,最後逐步實現。
每個步驟有 verification-before-completion 把關,聲稱完成之前必須先跑驗證。
最新版本的superpowers整個過程你不需要手動觸發任何命令,Skills 根據上下文自動激活。
可以說是潤物細無聲。
安裝很簡單
項目提供一鍵安裝腳本,自動檢測你項目裏用了哪個 AI 工具,然後把 Skills 安裝到對應位置:
cd /your/project
npx superpowers-zh
識別不出來的情況可以手動指定工具:
npx superpowers-zh --tool cursor
如果你用 Claude Code,安裝完成後重啓 Claude Code,Skills 就會在啓動時自動加載。
Cursor、Kiro、通義靈碼等其他工具各有對應的配置文件位置,README 裏有詳細說明。
第一性原理
superpowers 項目的作者 Jesse Vincent 說過一個意思,是理解這套東西的關鍵本質:
AI 不是不懂 TDD,讓它講能講一個小時。它缺的是一個機制——在真正要寫代碼的時候把自己拉住,強迫自己先寫測試。
Skills 就是那個機制。
superpowers-zh 在這個基礎上加了中文表達習慣和國內工具生態,讓這套方法論對國內開發者開箱即用。
Skill 文件本身是公開的,邏輯透明,你可以改,也可以自己寫新的。
項目地址:
github.com/jnMetaCode/superpowers-zh
