頂流編碼Skill！178k Stars！這套SOP Skill讓AI編程助手不再跑偏
整理版優先睇
給AI裝SOP：用Skill文件令Claude Code唔再亂寫code
作者用Claude Code重構模塊時出事——AI冇問需求邊界、冇查現有代碼就開寫，結果搞崩其他功能。佢話呢個唔係AI嘅問題，而係佢冇俾AI一套紀律。AI識寫code但唔識做嘢，因為佢哋冇穩定方法論，每次都即興發揮。
解決方法係俾AI裝SOP——一堆Markdown文件叫Skill，定義工作方法論。Claude Code啟動時讀呢啲Skill，遇到對應場景就按步驟做，唔會自己亂嚟。GitHub上有個superpowers項目，178k Stars，核心就係14個SKILL.md文件、一個啟動hook同平台發現清單，支援多款AI工具。
因為原版主要係英文同西方Git工作流，所以有開發者整咗superpowers-zh，本地化適配國內工具同Git平台，仲加咗6個原創Skill（例如中文代碼審查、Gitee CI配置）。裝咗之後，AI會先問需求邊界、俾幾個方案你揀，再逐步實現，每個步驟有驗證把關，唔會亂衝。
- AI寫code唔等於識做嘢，需要紀律（SOP）嚟防止亂發揮。
- superpowers項目用Skill.md文件定義方法論，呢啲文件純文字，可跨工具使用。
- superpowers-zh針對國內開發者，翻譯Skills、擴充工具支援（17款）、加入Gitee/Coding CI配置。
- 用咗之後，AI會先問需求邊界、設計方案，然後逐步實現，每一步都有驗證。
- 安裝簡單：一行npx命令自動偵測工具，或者手動指定，之後重啟即生效。
superpowers-zh GitHub 倉庫
本地化版 superpowers，包含14個翻譯Skills + 6個原創Skills，支援17款國內外AI工具。
AI識寫code但唔識做嘢
上星期我用Claude Code重構一個模塊，結果佢直接開寫，冇問我需求邊界，冇查現有代碼，寫完一跑——搞崩咗另一功能。我氣到想掟鍵盤，但諗返：呢個唔係佢嘅問題，係我嘅問題。我俾咗需求，佢就開工。至於點樣做、會唔會出事，佢根本冇諗過。
AI會寫code，但唔會做嘢——呢個係兩回事
合格嘅programmer接到需求，第一反應唔係開editor。佢會先問：邊界條件係乜？有冇現成模塊可以重用？呢個改動會唔會影響其他功能？測試點樣搞？Claude Code出廠默認冇呢套流程，你話乜佢做乜，每次都從零開始諗。
AI即興發揮嘅問題
作者話呢個問題嘅根源係：AI編程助手缺嘅唔係能力，係紀律。而紀律需要條文——一堆Markdown文件，每個描述一個工作方法論，叫做Skill。
解決方案：俾AI裝一套SOP
Claude Code啟動時讀取呢啲Skill，遇到對應場景就按裏面嘅步驟嚟做，唔會自己亂發揮。例如「系統化調試」Skill規定四階段調試法，唔容許喺未揾出根因之前就鬱code；「測試驅動開發」Skill嚴格執行紅綠重構循環——必須先寫失敗測試，再寫實現code，如果Claude想喺測試之前寫code，呢個Skill會叫佢刪咗重來。
編程提示詞嘅本質：有法可依，有據可循
- 1 AI會根據上下文自動激活對應Skill，唔需要手動觸發。
- 2 每個Skill定義咗具體步驟同驗證條件，確保唔會跳過關鍵檢查。
- 3 多個Skills可以串聯使用，形成完整工作流程。
178k Stars嘅superpowers項目
GitHub上有個superpowers項目，而家178k Stars。入面冇乜高深code，主體就係Skill文件。核心得三部分：14個SKILL.md文件、一個啟動hook、各平台發現清單。因為係純文字，同一套skills目錄支援Claude Code、Cursor、Codex、Copilot CLI、Gemini CLI、OpenCode等多款工具。
178k Stars，核心係Skill文件
純文字，跨工具通用
superpowers-zh：專為國內開發者而設
原版superpowers對國內開發者有現實障礙：只支援6款工具；Git工作流全係GitHub Actions；code審查風格係西方團隊嘅直接反饋文化。如果用喺Gitee、Coding CI流水線，要自己改好多嘢。
於是有superpowers-zh，喺原倉庫基礎上做本地化適配：完整翻譯14個Skills，另加6個國內開發場景嘅原創Skill，包括中文代碼審查、中文Git工作流（有Gitee/Coding/CNB CI配置示例）、中文技術文檔處理（中英文混排排版規範）等。工具覆蓋由6款擴展到17款，包括Qwen Code、Trae、Kiro、Hermes Agent等國內常用工具。
- 中文代碼審查：適配國內團隊溝通風格。
- 中文Git工作流：預設Gitee、Coding、CNB CI配置。
- 中文技術文檔處理：處理中英文混排排版。
安裝方法：一鍵執行
安裝非常簡單：喺你嘅project目錄執行呢個命令：
cd /your/project
npx superpowers-zh如果佢認唔到你用緊邊款AI工具，可以手動指定：
npx superpowers-zh --tool cursor如果你用Claude Code，安裝後重啟，Skills就會喺啟動時自動加載。Cursor、Kiro、通義靈碼等其他工具各有對應配置位置，README有詳細說明。
一鍵執行，自動偵測工具
上星期我用Claude Code重構一個模塊，點知佢直接開寫，冇問我需求邊界，冇查現有代碼，寫完一跑——整到其他功能炒咗。
我嬲到想掉爛鍵盤，但轉頭諗諗：呢個唔係佢嘅問題，係我嘅問題。
我俾咗需求，佢就開工。至於點樣做、會唔會出事，佢根本冇諗過。
AI識寫代碼，但唔識做嘢。呢兩樣嘢唔同。
一個合格嘅程序員接到需求，第一反應唔係打開編輯器。
佢會先問：
- • 邊界條件係咩？
- • 有冇現成模塊可以重用？
- • 呢個改動會唔會影響其他功能？
- • 測試點樣行？
Claude Code出廠預設冇呢套流程。你講咩佢做咩，每次都由頭開始諗。
佢明明識除錯、識規劃、識重構，但每次都係「即興發揮」，而唔係跟穩定嘅方法論去做。
簡單任務冇問題，一旦遇到多文件、多步驟、有約束嘅真實開發場景，佢就開始成日走歪。
解決方案：幫AI裝返套SOP
AI編程助手缺咗嘅唔係能力，係紀律。
紀律需要條文——一堆Markdown檔案，每個檔案描述一個工作方法論，叫做Skill。
Claude Code啟動時會讀取呢啲Skill，遇到對應場景就跟住Skill入面嘅步驟做，而唔係自己亂咁發揮。
好似「系統化除錯」呢個Skill：
規定四階段除錯法，唔準喺未搞清楚根因之前就改代碼。
唔係要你手動觸發，而係Claude遇到bug時會自動行呢個流程。
又好似測試驅動開發嘅Skill：
嚴格執行紅綠重構循環——一定要先寫失敗嘅測試，再寫實現代碼。
如果Claude想喺測試之前寫代碼，呢個Skill會叫佢刪咗重新嚟過。
呢個就係編程提示詞嘅本質：有法可依，有據可循。
178k Stars嘅superpowers項目
GitHub上面有個項目叫superpowers，而家有178k Stars。
入面冇咩高深代碼，主體全部係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：
| Skill | 作用 |
|---|---|
| 中文代碼審查 | 適配國內團隊嘅溝通風格 |
| 中文Git工作流 | Gitee、Coding、CNB都有CI配置示例 |
| 中文技術文檔 | 處理中英文混排嘅排版規範 |
工具覆蓋由6款擴展到17款，包括Qwen Code、Trae、Kiro、Hermes Agent等國內常用工具。
裝咗之後嘅變化
返去開頭嗰個場景。
冇裝superpowers-zh：
你話「俾用戶模塊加個批量導出功能」，Claude即刻開始寫exportUsers()函數。
裝咗之後：
Claude會先進入brainstorming Skill，主動問你：
- • 導出格式係CSV定係Excel？
- • 預計數據量幾大，需唔需要異步處理？
- • 權限控制嘅粒度係咩？
得到答案之後，俾你2-3個方案，等你確認設計方向，再進入writing-plans Skill拆任務，最後逐步實現。
每個步驟有verification-before-completion把關，聲稱完成之前一定要先跑驗證。
成個過程你唔需要手動觸發任何命令，Skills會根據上下文自動激活。
潤物細無聲。
安裝方法
一鍵安裝腳本，自動檢測你項目用嘅AI工具：
cd /your/project
npx superpowers-zh認唔到可以手動指定：
npx superpowers-zh --tool cursor如果你用Claude Code，安裝後重啟，Skills就會喺啟動時自動加載。
Cursor、Kiro、通義靈碼等其他工具各有對應配置位置，README入面有詳細說明。
寫喺最後
superpowers項目嘅作者講過一句話，係理解呢套嘢嘅關鍵：
「AI唔係唔識TDD，叫佢講可以講一個鐘。佢缺嘅係一個機制——喺真係要寫代碼嘅時候拉住自己，強迫自己先寫測試。」
Skills就係嗰個機制。
superpowers-zh喺呢個基礎上加咗中文表達習慣同國內工具生態，令呢套方法論對國內開發者開箱即用。
Skill檔案本身公開透明，你可以改，亦都可以自己寫新嘅。
🔗 項目地址
GitHub: github.com/jnMetaCode/superpowers-zh
上週我用Claude Code重構一個模塊，結果它直接開寫，沒問我需求邊界，沒查現有代碼，寫完一跑——把別的功能搞崩了。
我氣得想砸鍵盤，但轉念一想：這不是它的問題，是我的問題。
我給了需求，它就幹活。至於怎麼幹、會不會出事，它壓根沒想過。
AI會寫代碼，但不會幹活。這是兩回事。
合格的程序員接到需求，第一反應不是打開編輯器。
他會先問：
- • 邊界條件是什麼？
- • 有沒有現成模塊可以複用？
- • 這個改動會不會影響其他功能？
- • 測試怎麼跑？
Claude Code出廠默認沒這套流程。你說啥它幹啥，每次都從零開始想。
它明明會調試、會規劃、會重構，但每次都在"即興發揮"，而不是按穩定的方法論來。
簡單任務沒問題，一旦遇到多文件、多步驟、有約束的真實開發場景，它就開始頻繁跑偏。
解決方案：給AI裝一套SOP
AI編程助手缺的不是能力，是紀律。
紀律需要條文——一堆Markdown文件，每個文件描述一個工作方法論，叫做Skill。
Claude Code啓動時讀取這些Skill，遇到對應場景就按Skill裏的步驟來，而不是自己瞎發揮。
比如"系統化調試"這個Skill：
規定四階段調試法，不允許在沒弄清根因之前就動代碼。
不是讓你手動觸發，是Claude遇到bug時自動進入這個流程。
再比如測試驅動開發的Skill：
嚴格執行紅綠重構循環——必須先寫失敗的測試，再寫實現代碼。
如果Claude想在測試之前寫代碼，這個Skill會讓它刪掉重來。
這就是編程提示詞的本質：有法可依，有據可循。
178k Stars的superpowers項目
GitHub上有個項目叫superpowers，現在178k Stars。
裏面沒有什麼高深代碼，主體全是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：
| Skill | 作用 |
|---|---|
| 中文代碼審查 | 適配國內團隊的溝通風格 |
| 中文Git工作流 | Gitee、Coding、CNB都有CI配置示例 |
| 中文技術文檔 | 處理中英文混排的排版規範 |
工具覆蓋從6款擴展到17款，包括Qwen Code、Trae、Kiro、Hermes Agent等國內常用工具。
裝了之後的變化
回到開頭那個場景。
沒裝superpowers-zh：
你說"給用戶模塊加個批量導出功能"，Claude立刻開始寫exportUsers()函數。
裝了之後：
Claude會先進入brainstorming Skill，主動問你：
- • 導出格式是CSV還是Excel？
- • 預計數據量多大，需要異步處理嗎？
- • 權限控制的粒度是什麼？
得到答案後，給你2-3個方案，等你確認設計方向，再進入writing-plans Skill拆任務，最後逐步實現。
每個步驟有verification-before-completion把關，聲稱完成之前必須先跑驗證。
整個過程你不需要手動觸發任何命令，Skills根據上下文自動激活。
潤物細無聲。
安裝方法
一鍵安裝腳本，自動檢測你項目用的AI工具：
cd /your/project
npx superpowers-zh識別不出來可以手動指定：
npx superpowers-zh --tool cursor如果你用Claude Code，安裝後重啓，Skills就會在啓動時自動加載。
Cursor、Kiro、通義靈碼等其他工具各有對應配置位置，README裏有詳細說明。
寫在最後
superpowers項目的作者說過一句話，是理解這套東西的關鍵：
"AI不是不懂TDD，讓它講能講一個小時。它缺的是一個機制——在真正要寫代碼的時候把自己拉住，強迫自己先寫測試。"
Skills就是那個機制。
superpowers-zh在這個基礎上加了中文表達習慣和國內工具生態，讓這套方法論對國內開發者開箱即用。
Skill文件本身公開透明，你可以改，也可以自己寫新的。
🔗 項目地址
GitHub: github.com/jnMetaCode/superpowers-zh