最近一個月我?guī)缀跆焯炫菰贑laude Code里寫項目代碼生成速度確實沒話說但真正讓人頭疼的不是“寫得慢”而是“寫得快但不穩(wěn)”。改完一個函數(shù)旁邊的模塊崩了測試紅了一片AI卻還在自信地繼續(xù)往下寫。這種時候你才會意識到AI編程的瓶頸早就從“生成速度”轉(zhuǎn)移到了“可靠性”。我后來把Anthropic開源的Superpowers完整跑了一圈才真正理解為什么說它是讓AI編程從“快”走向“可靠”的關(guān)鍵工具。Superpowers本質(zhì)上是Claude的一個Skills集合把規(guī)劃、寫碼、測試、審查、調(diào)試這一整套工程流程拆成了一組可調(diào)用的標(biāo)準(zhǔn)動作。這篇文章我不打算跟你復(fù)述官方README而是從實際使用者的角度講清楚它解決什么問題、有哪些skills、怎么裝怎么用以及我踩過的坑。1. 先把Superpowers講清楚它到底是什么解決了什么問題1.1 從“快”到“可靠”AI編程的第二個階段先說一個我自己的觀察。第一代AI編程工具解決的是“快”的問題你在IDE里按一下TabAI幫你補全十幾個字符或者一鍵生成一個函數(shù)。那時候大家比的都是誰生成的代碼多、誰打字打得少這個階段確實很有沖擊力。但等你真正把一個像樣的項目交到AI手里讓它連續(xù)寫幾百個文件、跨模塊改邏輯的時候你會發(fā)現(xiàn)“快”根本不值錢真正值錢的是做完之后系統(tǒng)還能跑。Claude Code這種智能體類的編程工具出現(xiàn)之后AI已經(jīng)不是單純幫你補代碼了而是能自己讀文件、改文件、跑命令、看報錯、再重試。這聽上去很美好可一旦它運行起來問題就變成了另一個模樣它會在沒有完全理解需求的情況下直接開寫會在改A文件的時候順手破壞了B文件的依賴關(guān)系會在測試還沒跑的情況下就告訴你“完成”。這種現(xiàn)象的本質(zhì)是AI缺少一套工程上強制執(zhí)行的流程。它像一個熱情過剩但經(jīng)驗不足的實習(xí)生寫代碼不含糊但做事沒章法。Superpowers就是沖著這個痛點來的。它不改變Claude生成代碼的能力而是給Claude配了一套標(biāo)準(zhǔn)作業(yè)程序。每一個skill都是一份經(jīng)過設(shè)計的操作流程告訴Claude在什么場景下該做什么、按什么順序做、做到什么程度才算完。有了這套程序AI的行為就從“隨機發(fā)揮”變成了“按SOP執(zhí)行”這正是從“快”走向“可靠”的核心轉(zhuǎn)變。1.2 Skills機制的核心讓Claude知道自己該干什么要理解Superpowers得先理解Claude Skills機制。簡單說一個skill就是一個文件夾文件夾里有一份SKILL.md文件有時候還帶幾個可執(zhí)行的腳本。SKILL.md的開頭有一段frontmatter寫著這個skill的名字和描述下面則是具體的操作步驟。Claude Code啟動時會掃描本地skills目錄把所有skill注冊進自己的“工具箱”里。關(guān)鍵在于當(dāng)你在對話中提出需求時Claude會根據(jù)需求判斷該調(diào)用哪個skill。比如你說“幫我看看這段代碼有沒有問題”它會匹配到code-review你說“我這邊出了一個bug快幫我搞定”它會匹配到debugging或fix-bug。這套機制本質(zhì)上給了Claude一種“元認(rèn)知”能力——它不光是會寫代碼還知道自己當(dāng)前處于哪個工作階段、該調(diào)用哪套方法來應(yīng)對。這個設(shè)計思路我認(rèn)為非常聰明因為它沒有試圖把流程硬編碼進模型而是把流程做成可插拔的模塊讓模型按需調(diào)用。Superpowers之所以值得關(guān)注還有一個原因它不是一個社區(qū)隨手寫的小玩具而是Anthropic團隊內(nèi)部日常使用的skills集合。你可以把它理解為官方把自己的工作方法開源出來了。這就意味著你看到的不是某個博主拍的腦袋而是一套在真實商業(yè)項目中被磨過的流程。1.3 這套工具適合誰用如果你只是偶爾用AI寫個腳本、做個一次性爬蟲那Superpowers對你來說可能有點多余那些場景不需要嚴(yán)格流程跑了就行。但如果你跟我一樣用Claude Code在正經(jīng)項目上連續(xù)開發(fā)兩周以上需要維護多個模塊、反復(fù)修改需求、保持代碼質(zhì)量穩(wěn)定那這套skill就非常值錢了。它適合幾類人一是用Claude Code做中大型項目開發(fā)的開發(fā)者需要AI承擔(dān)更多自主編碼任務(wù)二是團隊里負(fù)責(zé)維護代碼質(zhì)量的工程師想讓AI的產(chǎn)出更規(guī)范、更好審查三是對AI編程工作流有好奇心、想研究“如何讓AI更可靠”的實踐者。說白了只要你的痛點不是“AI寫不出來”而是“AI寫出來的東西讓人不敢信”就可以試著引入Superpowers。2. Superpowers套裝里到底有哪些skills按場景怎么挑2.1 項目啟動與規(guī)劃類skills我打開Superpowers倉庫的時候第一反應(yīng)是這已經(jīng)不是簡單的“提示詞集合”了它幾乎把軟件開發(fā)的完整生命周期都覆蓋了。我先按使用場景給你分個類方便你按需挑選。項目啟動和規(guī)劃這一塊包含start-a-project、create-a-project、brainstorming、generate-prd、planning、write-spec、manage-project、update-tasks這幾個。brainstorming是用來澄清需求的當(dāng)你只有一個模糊想法時它會引導(dǎo)Claude一步步追問目標(biāo)用戶、核心場景、約束條件和風(fēng)險點最后產(chǎn)出一份決策記錄。這個skill對我特別有用因為AI最怕的不是代碼寫得差而是在需求沒搞清楚的情況下瞎寫一通。planning則是把需求拆解成可執(zhí)行的子任務(wù)每個任務(wù)帶上驗收標(biāo)準(zhǔn)。它生成的tasks.md就是后續(xù)所有工作的索引。manage-project和update-tasks負(fù)責(zé)維護任務(wù)狀態(tài)保證項目推進過程中不跑偏。如果你用Claude Code接過一個稍微大點的需求一定體會過“它一上來就開始寫代碼”的那種恐懼。用了planning之后Claude會先停下來做一個整體規(guī)劃這個停頓本身就能避免大量返工。2.2 編碼與修改類skills進入編碼環(huán)節(jié)這塊有edit-file、improve-code、fix-bug、change-a-skill、build-a-skill、create-diagnostics。edit-file不是讓Claude隨便改文件而是要求它在改動前先讀取相關(guān)文件、確認(rèn)改動范圍再精確編輯避免改動時誤傷其他邏輯。improve-code是在已有代碼基礎(chǔ)上做重構(gòu)和優(yōu)化fix-bug則是針對具體bug做修復(fù)。這幾個skills里我最想強調(diào)的是edit-file。過去Claude Code在改代碼時經(jīng)常出現(xiàn)的一個問題是一次性重寫整個文件把原本好的風(fēng)格也順手毀了。edit-file會先做分析、再分步改每個步驟都盡量小步快走。它把“修改代碼”這個動作變成了一個受控流程而不是一次玄學(xué)操作。build-a-skill和change-a-skill這兩個是“元技能”——專門用來創(chuàng)建、修改skill本身的。我一開始沒太在意后來才意識到這是Superpowers最強大的地方。你不需要等官方更新你完全可以把自己團隊的工作規(guī)范寫成新的skill讓Claude以后都按你的規(guī)范來。比如你公司要求所有PR都帶上性能測試結(jié)果那你就可以寫一個create-performance-check的skill。2.3 測試、審查與調(diào)試類skills測試和質(zhì)量這塊的skills是Superpowers的重頭戲包括create-tests、run-tests、code-review、debugging、investigate-issue。我的感受是Anthropic顯然是知道自家模型的問題在哪——它能生成大量代碼但往往忘記測試、跳過驗證。所以Superpowers專門把測試和審查做成了獨立skills。create-tests會根據(jù)已有代碼生成測試用例run-tests負(fù)責(zé)執(zhí)行測試并分析失敗原因。code-review是逐文件審查代碼質(zhì)量關(guān)注邏輯漏洞、邊界條件和潛在隱患。debugging是一個很有意思的skill它不會讓Claude上來就亂改代碼而是先要求你復(fù)現(xiàn)問題、提出假設(shè)、驗證假設(shè)再動手修復(fù)。這個流程很像一位有經(jīng)驗的工程師在排除故障而不是在瞎猜。2.4 流程輔助與擴展類skills最后還有一個流程輔助類create-pr-description、get-approval、add-mcp、explore-ai-news、review-a-skill甚至還有個t-shirt。create-pr-description會讀取你當(dāng)前工作區(qū)的git diff生成結(jié)構(gòu)清晰的中英文PR描述。get-approval要求Claude在執(zhí)行高風(fēng)險操作前先征求你同意給你一個“剎車”的機會。add-mcp用來給Claude Code添加MCP服務(wù)器這個對經(jīng)常接外部工具的人很實用。review-a-skill用來審查其他skill的質(zhì)量如果你是團隊里負(fù)責(zé)維護這套工具的人這個skill相當(dāng)于一個質(zhì)檢員。t-shirt這個技能看似搞笑實際是官方用來展示“skill如何封裝一個完整創(chuàng)意流程”的示例。3. 從零安裝Superpowersclone、復(fù)制目錄、驗證生效三步搞定3.1 安裝前的環(huán)境檢查安裝Superpowers之前先確認(rèn)你本地的Claude Code版本不要太老最好是最新版因為skills機制迭代得比較快。我用的是2025年年中的版本跑這些skills沒有遇到兼容性問題。另外skills依賴Node.js環(huán)境跑一些輔助腳本所以本機最好裝好Node.js版本不要太低。還要說一句目錄結(jié)構(gòu)的事。Claude Code默認(rèn)讀取~/.claude/skills/這個目錄你放在這下面的每一個子目錄只要包含SKILL.md文件就會被自動注冊成一個skill。知道了這個機制安裝就很簡單了不需要什么特殊工具。3.2 安裝的具體步驟我用的是命令行安裝整個過程大概三分鐘。先把倉庫clone到本地然后把skills目錄下所有子目錄復(fù)制到Claude Code的skills目錄里。命令大概是這樣的mkdir -p ~/.claude/skills git clone https://github.com/anthropics/superpowers.git cp -r superpowers/skills/* ~/.claude/skills/裝完之后你可以進到~/.claude/skills/目錄下看看應(yīng)該能看到brainstorming、planning、debugging、code-review這樣一長串目錄。如果你只想用其中一部分可以只復(fù)制需要的目錄沒必要全量安裝。我一開始是全量裝的后來發(fā)現(xiàn)有些不常用就把目錄再精簡了一下。裝太多skill雖然不影響穩(wěn)定性但會讓Claude在選擇時有點“選擇困難”偶爾會用錯工具。3.3 驗證skill是否加載成功驗證方法很簡單。啟動Claude Code在對話輸入會彈出skill自動補全列表。如果能看到剛才復(fù)制的那些名字說明加載成功了。你也可以直接問一句“你現(xiàn)在有哪些skills可以用”正常的Claude會基于已加載的skills列出一個清單。我建議你裝完之后隨手開一個新目錄做個小試驗寫一個最簡單的Python腳本故意留一個bug然后讓Claude用debugging流程處理一下。這樣既能驗證skill是否生效也能直觀感受一下“按流程走”和“直接亂修”之間的區(qū)別。4. 實操中的核心用法與經(jīng)驗把工作流真正跑起來4.1 用brainstorming做需求澄清別讓AI瞎起步我第一個想重點講的實際操作是用brainstorming做需求澄清。以前我都是直接跟Claude說“幫我做一個待辦事項應(yīng)用”然后它就嗖嗖開寫。表面上效率很高但做到一半就會發(fā)現(xiàn)我要的可能是帶數(shù)據(jù)統(tǒng)計的輕量工具它給的是一個帶用戶注冊的完整平臺方向就偏了?，F(xiàn)在我的做法是啟動任務(wù)前先用brainstorming。我會說“我有個想法幫我brainstorming一下弄清楚具體要做什么”。這個skill會引導(dǎo)出幾個關(guān)鍵問題核心用戶是誰、最重要的那個場景是什么、必須做和不能做的邊界在哪里、有什么限制條件。整個過程大概幾十秒但它逼著我把想法說出來、被挑戰(zhàn)、再收斂。最終產(chǎn)出的決策記錄我會讓它保存在項目目錄里后續(xù)所有編程任務(wù)都以這份記錄為準(zhǔn)。這個步驟看著簡單實際上非常關(guān)鍵。因為AI編程最大的浪費是方向錯了還一直在寫brainstorming相當(dāng)于在開工前先對表把我和Claude對需求的理解對齊了再動手。4.2 用planning把需求拆成任務(wù)讓執(zhí)行有節(jié)奏需求對齊之后緊接著我會調(diào)用planning。這個skill會把需求拆解成任務(wù)列表每個任務(wù)附上驗收標(biāo)準(zhǔn)和依賴關(guān)系。它生成的tasks.md會一直存在項目里后續(xù)Claude每完成一項就更新一下狀態(tài)。我用下來最直觀的感受是有了planning之后Claude的執(zhí)行節(jié)奏感完全不同了。沒有計劃時它總是急著把一個功能從頭寫到尾寫到一半被其他問題打斷又去改別的。有了計劃它會遵守“一次只做一個任務(wù)、做完標(biāo)記完成、再做下一個”的節(jié)奏。這就像你給一個充滿干勁的人配了一張作戰(zhàn)地圖他不光跑得快還知道自己此刻該站在哪。這里給一個建議planning拆出來的任務(wù)粒度不要太粗也不要太細(xì)。太粗執(zhí)行時還是要靠隨機應(yīng)變太細(xì)光維護任務(wù)狀態(tài)就消耗大量上下文。我一般控制在“半天到一天能完成”的粒度這樣既不會失控也不會讓流程本身成為負(fù)擔(dān)。4.3 用create-tests和run-tests把質(zhì)量關(guān)口焊死我一直覺得測試是AI編程可靠性的最后一道防線。Claude生成代碼的能力太強了強到它容易對自己的產(chǎn)出過度自信。如果不強制它寫測試、跑測試那它真的可能告訴你“所有功能都已實現(xiàn)”但實際上連最基本的邊界條件都沒處理。我的標(biāo)準(zhǔn)流程是寫完一個功能模塊立刻調(diào)用create-tests讓它生成對應(yīng)的測試再用run-tests執(zhí)行一遍。如果測試掛了就讓Claude基于失敗信息修代碼修完再跑直到全綠。這樣做的好處是質(zhì)量驗證不再是“人肉檢查”而是有一套客觀標(biāo)準(zhǔn)。實際跑下來create-tests生成的測試質(zhì)量還算可以關(guān)鍵路徑的覆蓋度比我預(yù)期高。但你也別指望它生成的測試有多全面因為它是基于現(xiàn)有代碼生成的天然會帶上同樣的思維盲區(qū)。所以我有時會在寫完測試后再手動補幾個邊界用例。另外一個經(jīng)驗是不要讓Claude同時改代碼和更新測試分兩輪做先改功能再更新測試這樣測試結(jié)果才能真實反映代碼狀態(tài)。4.4 用code-review和debugging處理“看起來能跑”的代碼到了項目后期最常做的事就是review和debug。code-review這個skill會逐文件審查代碼重點看邏輯漏洞、并發(fā)問題、未處理異常等。我通常會讓它在每次較大的改動之后跑一遍審查結(jié)果直接當(dāng)作代碼評審依據(jù)。debugging則是我處理線上問題的主力。這個skill最讓我滿意的地方是它強制要求先復(fù)現(xiàn)再動手。以前我讓Claude修bug它經(jīng)常上來就“我覺得這里有問題”然后把不相干的代碼也改了。用了debugging之后它會要求我先給復(fù)現(xiàn)步驟或者讓它在本地重現(xiàn)故障然后提假設(shè)、寫驗證方法、再動代碼。整個過程非常接近人類工程師的標(biāo)準(zhǔn)排障思路。這里我要提醒一句debugging不是萬能藥。如果bug是環(huán)境配置引起的跟代碼邏輯無關(guān)那它光靠復(fù)現(xiàn)和假設(shè)也很難定位。我遇到過一次折騰了半小時發(fā)現(xiàn)是依賴版本不一致導(dǎo)致的。所以別迷信任何工具該檢查環(huán)境的時候還是要檢查環(huán)境。4.5 用build-a-skill沉淀團隊規(guī)范最后說一下進階用法——build-a-skill。因為Superpowers是開源的它的skills本質(zhì)上就是一堆SKILL.md文件你完全可以照著它的結(jié)構(gòu)寫自己的。我用它把團隊的一些代碼規(guī)范封裝成了內(nèi)部skill比如“所有數(shù)據(jù)庫變更必須寫遷移腳本”“提交代碼前必須檢查敏感信息”之類。這個做法的價值在于你不用每次都在對話里反復(fù)叮囑Claude而是把規(guī)范固化下來讓它每次進入對應(yīng)場景時自動生效。就像一個老工程師把經(jīng)驗沉淀成文檔之后每個新人都能按這份文檔做事。如果你團隊里有人在維護AI編程工作流這個能力絕對值得研究。5. 常見問題與排查技巧實錄5.1 裝好了但Claude就是識別不到skill這是我見過最多的問題也是我第一次裝時踩過的坑。原因往往出在目錄嵌套上。有人直接clone整個superpowers倉庫然后原封不動放進~/.claude/skills/結(jié)果目錄結(jié)構(gòu)變成了~/.claude/skills/superpowers/skills/planning/SKILL.mdClaude Code掃描時沒找到有效skill自然什么也識別不了。正確做法是讓每個skill的子目錄直接位于~/.claude/skills/下面也就是~/.claude/skills/planning/SKILL.md這種結(jié)構(gòu)。檢查方法很簡單用命令看下目錄結(jié)構(gòu)確認(rèn)沒有多套一層就完事了。5.2 SKILL.md存在但Claude沒有自動調(diào)用有時skill已經(jīng)加載但Claude在你遇到某個場景時沒自動喚起對應(yīng)的skill。這個一般是skill的description寫得不夠精準(zhǔn)導(dǎo)致的——description是Claude決定何時調(diào)用skill的依據(jù)寫得含糊匹配率就低。Superpowers自帶的skills大多寫得不錯但你自己寫的skill經(jīng)常會犯這個毛病。我的技巧是給每個自建skill的description加上明確的觸發(fā)場景和關(guān)鍵詞比如“當(dāng)用戶提到性能優(yōu)化或頁面卡頓時使用此skill”。另外遇到?jīng)]有自動調(diào)用的情況最直接的兜底方案就是在對話里顯式輸入skill名稱來手動觸發(fā)完全沒問題。建議把常用幾個skill的調(diào)用方式記在項目說明文檔里提醒后續(xù)的AI會話使用。5.3 skill里的腳本跑不起來部分skills帶輔助腳本比如add-mcp、create-diagnostics。你在使用時會發(fā)現(xiàn)腳本沒有執(zhí)行權(quán)限提示permission denied。這個通常是因為clone下來的文件默認(rèn)沒有保留可執(zhí)行位。解決方法很直接給對應(yīng)腳本加上執(zhí)行權(quán)限chmod x ~/.claude/skills/*/scripts/* 2/dev/null還有個容易忽略的點是腳本運行需要Node.js環(huán)境如果你是在容器或者精簡環(huán)境下用Claude Code可能沒有裝Node。這個提前裝好就行不用等到報錯再折騰。5.4 skill太多導(dǎo)致上下文被擠占選擇也受影響這是另一個很現(xiàn)實的問題。每個加載的skill的SKILL.md都會占用上下文窗口裝幾十個不常用的skill會把寶貴的上下文空間吃掉不少。而且skill多了之后Claude在選擇時偶爾會出現(xiàn)“猶豫”明明該用debugging它卻先調(diào)用了一次investigate-issue。雖然不影響最終結(jié)果但過程確實更繞了。我的建議是保持克制的安裝清單先用base的planning、brainstorming、create-tests、run-tests、debugging、code-review這六個等真正需要的時候再把其他skill加進來。我現(xiàn)在的~/.claude/skills/目錄里只保留了十來個常用技能跑項目又穩(wěn)又省心。5.5 引入skills之后幻覺反而變多了先排查這套流程有一個現(xiàn)象值得一提有時候引入了這套流程Claude的產(chǎn)出還是會有幻覺。這時候別急著罵skill沒用先想想是不是流程執(zhí)行不到位。比如它說自己“已經(jīng)跑了測試”但實際輸出里沒有測試結(jié)果它說“所有task已完成”但tasks.md還有一堆未勾選項。我的經(jīng)驗是在關(guān)鍵節(jié)點要求Claude給出可驗證的證據(jù)比如“請貼出測試輸出”“請把tasks.md的當(dāng)前狀態(tài)發(fā)給我”。這不是不信任AI而是工程上本來就要求可追溯。Superpowers提供了流程框架但最終守門的是你自己。該檢查的時候絕不含糊這樣才能把可靠性真正提上來。整個Superpowers用下來我的體會是它沒有Magic核心價值就是把AI編程從“寫代碼很快”重新定義成“交付結(jié)果很可靠”。它提供的思維方式和流程框架比任何單個提示詞都值得學(xué)習(xí)。如果你正準(zhǔn)備讓AI深入?yún)⑴c現(xiàn)有項目建議先裝上planning、debugging、code-review這幾個最核心的skills跑一周你會明顯感受到工作節(jié)奏變得更踏實、更可控。