最近在技術(shù)社區(qū)里“superpowers”這個詞的出現(xiàn)頻率高得有點反常。好幾個群隔三差五就有人問“superpowers怎么安裝”“裝完到底有什么用”我一開始還以為是某個游戲Mod或者新的瀏覽器插件直到自己花了一下午裝完、又實打?qū)嵱昧巳懿潘惆堰@個名字叫得響的玩意兒徹底搞清楚。簡單說Superpowers是Jesse Vincent維護的一個開源項目本質(zhì)是一套給Claude Code這類AI編程助手準備的能力增強包業(yè)界一般叫它“Skills技能包”。裝上之后AI的協(xié)作方式會發(fā)生一個很明顯的轉(zhuǎn)變以前它是你問一句、它答一句的被動工具現(xiàn)在它會主動拆解任務(wù)、寫實施計劃、系統(tǒng)排查報錯、用測試驗證結(jié)論甚至在動手改代碼之前先跟你把方案對齊。這篇文章不打算寫成README翻譯稿就按“它到底是什么、裝之前要懂什么、怎么裝、裝完能干什么、實際踩了什么坑”這個順序把我這三周的實測體感完整交代一遍給想裝還沒裝的朋友一個真實參考。1. 先說清楚Superpowers到底是個什么東西1.1 一個包還是一套方法論先說結(jié)論Superpowers既是一個具體的開源項目又是一套方法論的外殼。它把“AI編程助手應(yīng)該怎么被使用”這件事從一堆散落在個人備忘錄里的提示詞變成了一個結(jié)構(gòu)化的、開箱即用的技能庫。項目本身由Jesse Vincent維護面向的是Claude Code這款終端里的AI編程工具。它的核心形態(tài)是一批預(yù)先寫好的“技能”文件每個技能文件都是一份高度工程化的指令文檔教AI在特定場景下應(yīng)該用什么樣的流程來干活。比如遇到bug時不要急著改代碼而是先復(fù)現(xiàn)、再定位、再假設(shè)、再驗證比如拿到一個陌生代碼庫時先梳理目錄結(jié)構(gòu)和數(shù)據(jù)流再動手寫計劃。這里有一個很多人會忽略的點Superpowers并不是給AI“注入”了什么新模型能力它做的是把Claude Code已經(jīng)具備的能力通過更精細的提示詞編排、更嚴格的工作流約束壓榨出更高的上限。換句話說同一個模型裝與不裝在復(fù)雜任務(wù)上的表現(xiàn)差距可以非常明顯。1.2 讓人迷惑的項目名“Superpowers”這個名字其實相當容易引起誤解。搜索這個詞的時候你會碰到五六個同名項目——有一個是瀏覽器里的網(wǎng)頁游戲制作工具有一個是VS Code的插件還有的是自媒體領(lǐng)域講“個人超能力”的雞湯文。而最近這波熱搜“想要安裝superpowers”指向的基本都是Jesse Vincent做的這個Claude Code技能包。判斷是不是同一個東西最直接的辦法是看它的安裝方式。那個在代碼圈口口相傳的“一鍵安裝腳本”裝的不是游戲、不是插件而是一整套會寫入你家~/.claude目錄的配置和技能文件。搞清楚這個定位后面所有的安裝步驟和概念都好理解了。1.3 什么樣的人值得裝我的看法是如果你滿足以下任意兩條就值得花半小時裝一下試試日常重度使用Claude Code寫代碼、改bug、做代碼審查經(jīng)常接手自己沒寫過的舊項目需要快速理解陌生代碼庫習(xí)慣了讓AI直接“一把梭”輸出代碼但發(fā)現(xiàn)它在復(fù)雜任務(wù)里容易跑偏在做涉及多文件、多步驟的重構(gòu)或遷移希望AI能先給方案再動手反過來如果你只是偶爾用AI問幾個語法問題、復(fù)制粘貼幾個小函數(shù)那裝上之后的效果感知不會太強。它不是那種裝了就立刻“哇塞”的Demo型工具而是要在長周期、多步驟的真實任務(wù)里才能體現(xiàn)出價值的底座型配置。2. 裝之前必須理解的三個底層概念2.1 先搞懂SkillsAI的程序性記憶Claude Code在2025年加入了一套叫“Skills”的機制你可以把它理解為AI的“程序性記憶”。平時我們給AI寫提示詞是告訴它“這一次怎么做”而Skill是告訴它“以后凡是碰到這類場景就按這套流程做”。每個技能在磁盤上就是一個目錄里面有一個SKILL.md文件采用Markdown格式頂部帶YAML格式的元信息。一個典型的技能文件長這樣--- name: systematic-debugging description: 當用戶報告bug、異常行為或測試失敗時使用。適合需要定位根因而不是隨手打補丁的場景。 --- # 系統(tǒng)化調(diào)試 當被要求修復(fù)一個bug時不要立刻改代碼。按以下步驟執(zhí)行 ## 第一步復(fù)現(xiàn) 先嘗試穩(wěn)定復(fù)現(xiàn)問題記錄觸發(fā)條件和頻率。 ## 第二步定位 通過日志、調(diào)用鏈、二分法縮小嫌疑范圍定位到具體文件和函數(shù)。 ## 第三步假設(shè)與驗證 針對根因提出假設(shè)用最小改動驗證而不是大范圍重構(gòu)。name是技能的唯一標識description則是AI判斷“什么時候該用它”的依據(jù)。真正干活的時候模型會讀取任務(wù)描述和所有技能的description做語義匹配命中哪個就用哪個。這個匹配過程是靜默的、自動的不需要用戶在對話里手敲技能名。2.2 技能文件放在哪里、怎么被加載安裝Superpowers之后它的核心動作之一就是往你的全局Claude Code配置目錄里批量放置這些技能文件。我機器上裝完之后的目錄結(jié)構(gòu)大致是這樣的~/.claude/ ├── CLAUDE.md # 全局引導(dǎo)配置 ├── skills/ # 全局技能目錄 │ ├── brainstorming/ │ ├── code-review/ │ ├── systematic-debugging/ │ ├── ... │ └── system/ │ └── execute-command/ └── superpowers/ # 項目自身文件與輔助腳本這里面有一個關(guān)鍵細節(jié)技能存在全局目錄意味著它對所有項目都生效。Claude Code在啟動對話時會同時讀取全局和項目本地的CLAUDE.md以及各個技能目錄里的SKILL.md。全局配置負責(zé)定義“你是一個什么樣的AI、遇到任務(wù)大致怎么思考”技能文件則負責(zé)在具體場景下觸發(fā)具體流程。2.3 概念澄清Skills、CLAUDE.md、MCP不是一回事很多人第一次接觸Superpowers時會把三個概念混在一起CLAUDE.md、Skills和MCP。這三者其實是不同層面的東西我直接用一個表說清楚機制作用層面一句話解釋Superpowers主要用哪個CLAUDE.md會話記憶給AI設(shè)定全局規(guī)則、項目背景、工作習(xí)慣寫入了引導(dǎo)配置教AI“怎么用技能”Skills程序性記憶場景化的工作流指令按需加載核心大量預(yù)置技能文件MCP外部工具連接把外部API、數(shù)據(jù)庫、文件系統(tǒng)暴露給AI調(diào)用基本不涉及可選配合理解這個區(qū)分很重要如果你已經(jīng)裝了Superpowers但感覺“AI沒什么變化”大概率是沒意識到它的作用方式是間接的——它沒有直接改模型而是改了模型在對話里會“讀到什么、按什么流程思考”。也就是說它的價值完全取決于你給AI安排的任務(wù)復(fù)雜度。給AI的活兒越接近“多步驟工程任務(wù)”Superpowers的收益就越明顯整天問“幫我把這段代碼改成Python”那它和裸奔的Claude Code確實看不出多大差別。3. 安裝教程三步裝完跑通驗證3.1 前置環(huán)境檢查清單安裝前先確認你的機器滿足這幾個條件能省掉后面90%的排查時間本機已裝好Claude Code。Superpowers是它的增強包不是獨立工具。有可用的賬號和額度。安裝本身不收費但后續(xù)使用消耗的是Claude Code本身的token額度。終端能正常訪問GitHub或官方安裝源。安裝腳本要從遠端拉取項目文件這一步不通后面全是白搭。Shell環(huán)境干凈。建議用系統(tǒng)自帶的bash或zsh避免用某些魔改過PATH的奇怪終端模擬器。可以用這條命令快速確認環(huán)境claude --version如果能正常打印版本號說明第一步通過。如果你還沒裝Claude Code先去官方渠道裝好再來否則后面裝Superpowers沒有任何意義。3.2 執(zhí)行一鍵安裝腳本確認環(huán)境沒問題后安裝動作本身非常簡單。到項目倉庫的README頁復(fù)制最新的安裝命令目前官方給的主要是這一行curl -fsSL https://superpowers.obra.dev/install.sh | bash不建議對這條命令做任何“優(yōu)化”。我見過有人自作主張把管道改成先下載再執(zhí)行結(jié)果因為文件權(quán)限不一致反而報錯。直接原樣跑就行。腳本跑起來后主要干三件事在~/.claude/下創(chuàng)建superpowers目錄并把項目本體拉進去在~/.claude/skills/下批量放置技能文件在~/.claude/CLAUDE.md末尾追加一段引導(dǎo)配置告訴AI“你擁有這些技能、應(yīng)該怎么選擇和使用它們”整個過程一兩分鐘就能跑完終端里會滾動輸出大量文件操作日志?？吹筋愃艻nstalled N skills或者Setup complete的提示基本就算成功了。3.3 安裝后的目錄自檢裝完別急著開對話先花兩分鐘做個自檢確認文件確實落位了。我建議跑這幾條命令# 查看技能目錄里有多少個技能 ls ~/.claude/skills/ # 確認全局引導(dǎo)配置是否被改寫 tail -n 30 ~/.claude/CLAUDE.md # 確認項目本體存在 ls ~/.claude/superpowers/如果你發(fā)現(xiàn)skills/目錄是空的或CLAUDE.md沒有被追加內(nèi)容那安裝大概率沒成功直接跳到第6節(jié)看排查方案。自檢通過后新建一個Claude Code會話再開始用。不要在當前已經(jīng)打開的會話里繼續(xù)因為舊會話不會重新加載磁盤上的技能配置你會誤以為裝了個寂寞。3.4 升級與卸載的基本操作Superpowers迭代挺快的我用的這三周里就更新過兩次。升級方式依然是重跑安裝腳本它會覆蓋舊文件并保留你的自定義修改前提是你不去動它寫入的文件名。卸載則更簡單把三個位置的東西刪干凈就行rm -rf ~/.claude/skills rm -rf ~/.claude/superpowers # 手動把 CLAUDE.md 里 Superpowers 追加的段落刪掉注意第三節(jié)官方建議保留CLAUDE.md的備份或者安裝前先復(fù)制一份。我自己第一次卸載重裝時沒留備份導(dǎo)致得手動清理那段很長的引導(dǎo)文本實在太痛苦。所以我的建議是任何結(jié)構(gòu)性安裝之前先cp ~/.claude/CLAUDE.md ~/.claude/CLAUDE.md.bak這個習(xí)慣能救你無數(shù)次。4. 核心能力拆解技能包里到底有什么4.1 核心技能清單與用途裝完之后你大概會看到二十多個技能目錄名字在不同版本里會有微調(diào)。我把這段時間實際用過的、感覺價值密度最高的幾個列出來技能名觸發(fā)場景實際價值brainstorming需要產(chǎn)出多個方案、發(fā)散思路強制先發(fā)散后收斂避免AI只給一個平庸方案就完事planning多步驟任務(wù)開始前先寫實施計劃拆出階段目標和驗收點systematic-debugging遇到bug或測試失敗強制復(fù)現(xiàn)-定位-假設(shè)-驗證而不是猜著打補丁code-review代碼審查、合并前檢查按安全性、性能、可維護性逐層檢查出結(jié)構(gòu)化報告execution計劃已定、開始動手按計劃逐條執(zhí)行邊做邊匯報進度system/execute-command需要跑終端命令教會AI安全地執(zhí)行shell命令、解析輸出、失敗后自主修整red-team需要攻擊自己的設(shè)計或代碼站在對立面找漏洞和邊界情況防止自嗨4.2 技能選擇機制它怎么知道該用哪個這個問題我問過自己很多次也觀察過很多次。答案是全自動匹配不需要用戶操心。Claude Code拿到你的請求后會把請求語義和每個技能文件頭部的description字段做匹配。比如你說“幫我查一下這個報錯是什么原因”模型就會匹配到systematic-debugging的description于是整個對話就切換到“先復(fù)現(xiàn)、再定位、后假設(shè)”的邏輯。如果你說“幫我看看這次提交有沒有問題”它就更可能走code-review的流程。這里有個關(guān)鍵技巧技能的觸發(fā)高度依賴description和當前任務(wù)的語義重合度所以你在提問時盡量把場景詞說清楚。比如“請幫我審查一下這個PR”要比“幫我看看這段代碼咋樣”更容易精準觸發(fā)對應(yīng)技能。這也解釋了為什么有些人裝了之后覺得沒區(qū)別——他們給AI的指令太模糊技能匹配不上自然只能退回默認的“自由發(fā)揮”模式。4.3 這些技能背后共享的工程理念把20多個技能攤開看你會發(fā)現(xiàn)它們不是零散的小技巧而是幾條一致的工程原則在反復(fù)顯形第一先計劃后動手。多步驟任務(wù)開始前AI會先產(chǎn)出計劃文件拆成階段和檢查點而不是一頭扎進代碼里。這個習(xí)慣幫我擋住了至少三次“改完才發(fā)現(xiàn)方向錯了”的返工。第二結(jié)論必須被驗證。不管是修bug還是做重構(gòu)AI被要求給出可執(zhí)行的驗證方式——跑哪條命令、看什么輸出、對比什么數(shù)據(jù)。它不再拍胸脯說“應(yīng)該沒問題”而是說“我改了哪幾行、跑了哪組測試、結(jié)果如何”。第三允許AI用終端。system/execute-command這套技能讓AI能在受控范圍內(nèi)執(zhí)行shell命令、讀日志、跑測試遇到失敗還能自行修正重試。這意味著AI從“只寫代碼”進化到“寫代碼跑代碼看結(jié)果”這個閉環(huán)才是裝上之后體感變化最大的來源。5. 實戰(zhàn)記錄三周時間里我怎么用它5.1 場景一接手一個沒有文檔的舊服務(wù)前陣子我需要接手一個同事留下的內(nèi)部服務(wù)代碼量不大但是完全沒有文檔連啟動方式都靠猜。以前我的做法是自己翻目錄、看配置、猜入口通常要花一兩個小時。這次我裝完Superpowers之后直接在Claude Code會話里說了一句“幫我摸清這個項目的結(jié)構(gòu)我要知道它怎么啟動、核心模塊有哪些、數(shù)據(jù)流大概是什么樣?！彼⒖踢M入了planning和brainstorming的節(jié)奏先讓我確認了幾個關(guān)鍵問題然后用execute-command技能自動列了目錄樹、讀了關(guān)鍵的配置文件和入口文件最后產(chǎn)出了一份項目結(jié)構(gòu)說明。整個過程大概15分鐘比我預(yù)想快了非常多。更重要的是它產(chǎn)出的資料里標注了“基于XX文件推斷”“這部分還需要確認”讓我能清楚地知道哪些結(jié)論可靠、哪些得自己再看一眼。這種“知道自己不知道什么”的克制是裸裝Claude Code很少見到的。5.2 場景二給一個復(fù)雜模塊做重構(gòu)另一個讓我印象深刻的場景是重構(gòu)一個歷史債務(wù)很重的數(shù)據(jù)同步模塊。這個模塊邏輯分支多、測試覆蓋很差直接讓AI改很容易翻車。我當時的做法是明確說了“我要重構(gòu)這個模塊但我需要先有個方案”。這次它走的是planning加code-review的組合路徑先分析模塊的輸入輸出和所有調(diào)用方列出風(fēng)險點然后產(chǎn)出了一個重構(gòu)方案分成三階段每階段都配了對應(yīng)的驗證手段。最開始時我還覺得方案偏保守但實際執(zhí)行時正是因為階段拆得細我才能在第1階段發(fā)現(xiàn)一個隱藏的邊界情況及時叫停了后續(xù)動作。這個場景給我的啟發(fā)是Superpowers真正的價值不是讓AI寫得更多而是讓AI在動手前先形成“風(fēng)險認知”。方案里它會明確標注“這個改動會影響到XXX調(diào)用方”“這里需要額外測試”這些判斷以前都得靠我自己在腦海里過一遍。5.3 場景三批量清洗一個老倉庫的雜務(wù)還有一個不那么“技術(shù)”的場景但也很有代表性。我想給一個老倉庫統(tǒng)一整理代碼格式、清理掉無用的注釋和遺留調(diào)試代碼。這種活兒重復(fù)度高、機械單獨讓AI做容易做過頭——可能刪了不該刪的邏輯。這次我觸發(fā)了execution加system/execute-command的組合。AI先掃描了全倉庫的代碼列表統(tǒng)計了哪些文件大概率能安全清理列成清單讓我逐個確認然后才開始動手。整個過程里它每改完一批文件就跑一次編譯檢查確保沒把倉庫搞壞。最后我只需要審查一遍git diff而不是逐文件重新檢查。這三周用下來我的整體體感是它不太會在“單點問答”上給你驚喜但在“連續(xù)性工程任務(wù)”上把AI的可用性提高了一個檔次。這正好對應(yīng)了我開頭說的——Superpowers是一套方法論的外殼不是一顆銀子彈。6. 踩坑記錄安裝與日常使用中的問題們6.1 安裝失敗的頭號原因環(huán)境訪問問題裝Superpowers最常見的問題是跑安裝腳本時卡住或直接報錯。我?guī)蛢蓚€同事排查過最終原因歸結(jié)為兩類一類是網(wǎng)絡(luò)訪問不到安裝源。判斷方法很簡單先單獨跑一下curl -I 安裝腳本地址看返回狀態(tài)如果連這一步都不通那就是環(huán)境問題代理和網(wǎng)絡(luò)配置解決后才能繼續(xù)。另一類是腳本執(zhí)行權(quán)限問題。有時候你會看到Permission denied這時候不用慌可以先下載再用bash執(zhí)行curl -fsSL https://superpowers.obra.dev/install.sh -o install.sh bash install.sh但注意這種方式只是排查手段有條件還是建議直接用官方推薦的管道命令。另外提醒一句不要用sudo跑安裝腳本它只需要寫入你用戶目錄下的.claude文件夾用sudo反而可能把文件Owner搞亂導(dǎo)致后續(xù)Claude Code讀不了。6.2 技能的“不生效”其實有三種真相“我裝完了但AI一點變化都沒有”這大概是群里最常見的反饋。我自己排查過無數(shù)輪之后發(fā)現(xiàn)“不生效”基本可以拆成三種情況第一種舊會話緩存。你在安裝前就開著的Claude Code會話不會重新加載新技能。這種情況最容易迷惑人我一開始就差點栽在這上面。解決辦法很簡單裝完必開新會話。第二種任務(wù)描述與技能不匹配。正如前面說的技能是靠description語義匹配觸發(fā)的。給的任務(wù)太模糊或者壓根沒說場景詞AI根本不知道該調(diào)用哪個技能。這種情況的解法是換一種更具體的說法再問一次比如把“幫我看下這代碼”改成“幫我審查這段代碼的安全性和性能”。第三種配置被覆蓋了。如果你之前手動改過~/.claude/CLAUDE.md再運行Superpowers安裝腳本有可能會出現(xiàn)引導(dǎo)配置寫入失敗或新舊配置沖突。我在一次升級后就碰到過癥狀是技能目錄都在但AI死活不按技能流程走。最后是把CLAUDE.md里那段引導(dǎo)配置手動重寫了一遍問題才解決。6.3 多項目沖突與配置漂移如果你跟我一樣在不同項目里會讓Claude Code讀取項目級的CLAUDE.md那就得留意一個問題項目級配置的優(yōu)先級高于全局配置。某個項目里如果寫了和Superpowers引導(dǎo)邏輯相沖突的規(guī)則比如“不要使用任何技能”“只管輸出代碼不要廢話”那全局的Superpowers在這項目里就會被明顯削弱。這不是bug而是機制設(shè)計使然。我的處理方式是在項目級配置里明確寫一行“遵循全局技能選擇規(guī)則”把它和Superpowers的關(guān)系從“覆蓋”變成“兼容”。如果某個技能確實對這個項目不適用也可以按技能目錄去做排除但那是高級玩法不建議新手一上來就折騰。6.4 token消耗是真的會漲最后說一個99%的人不會在安裝文檔里看到的點裝上Superpowers之后token消耗會比裸裝明顯增加。原因很簡單——它讓AI在動手前多做了大量的規(guī)劃、分析和驗證這些“額外思考”都是要花token的。復(fù)雜任務(wù)里一次會話消耗翻倍甚至更多完全是正?，F(xiàn)象。所以我給重度使用者的建議是把Superpowers用在真正復(fù)雜的任務(wù)上簡單問題別開新會話。另外如果你用API按token計費建議在會話里通過配置對token預(yù)算做限制避免某些長任務(wù)跑飛了預(yù)算還渾然不知。我自己的習(xí)慣是凡是超過預(yù)期的長任務(wù)先讓AI輸出計劃確認之后再讓它執(zhí)行這樣既能控制成本也能避免它南轅北轍浪費token。裝了這三周我最大的感受倒不是它讓AI變“聰明”了多少而是它讓AI的工程行為變得可預(yù)期了——先計劃、再動手、最后驗證這套流程在真實的研發(fā)協(xié)作里比任何花哨能力都值錢。如果你剛裝完正在發(fā)愁“怎么感覺沒區(qū)別”不妨找一個需要跨多個文件、多步驟、有驗收標準的任務(wù)給它試試那種情況下你會立刻感受到區(qū)別。而如果只是日常問幾個片段問題那就當它不存在也沒關(guān)系它本來也不是為那種場景設(shè)計的。