頂流編碼Skill!superpowers 憑什麼狂攬178k Stars?

作者:字節筆記本
日期:2026年5月5日 上午1:35
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

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 就係強迫佢哋跟足步驟嘅機制,全部檔案公開可改,適合自訂。
值得記低
連結 github.com

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 CodeTraeKiroHermes Agent 等國內常用工具。
  • Git 工作流適配 GiteeCoding、極、CNB 等平台,唔使自己摸索。
  • 中文技術文檔 Skill 專門處理中英文混排嘅排版規範。

安裝好之後,你唔需要手動觸發任何命令,Skills 會根據上文下理自動激活,可以話係潤物細無聲。

整理重點

裝咗之後有乜唔同?一個例子就明

未裝 superpowers-zh 時,你話「畀用戶模塊加個批量導出功能」,Claude 即刻開始寫 exportUsers() 函數。裝咗之後,Claude 會先進入 brainstorming Skill,主動問你:導出格式係 CSV 定 Excel?預計數據量幾大?權限控制嘅粒度係點?

得到答案後,Claude 會畀 2-3 個方案,等你確認設計方向,再進入 writing-plans Skill 拆任務,最後逐步實現

每一步都有 verification-before-completion 把關,聲稱完成之前一定要先跑驗證。全部自動化,你唔需要手動觸發。

  1. 1 第一步:brainstorming Skill 自動激活,問清楚需求細節同邊界。
  2. 2 第二步:提供多個方案,由開發者確認設計方向。
  3. 3 第三步:writing-plans Skill 將任務拆細。
  4. 4 第四步:逐步實現,每個 step 用 verification-before-completion 驗證。
整理重點

安裝簡單,第一性原理理解本質

安裝好簡單,用一條命令就搞掂:npx superpowers-zh。佢會自動檢測你項目用緊邊個 AI 工具,然後將 Skills 安裝到對應位置。如果檢測唔到,可以手動指定工具。

安裝指令 bash
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

圖片