最近superpowers這個詞在熱搜里冒得很快我刷到不少人都在問有沒有skills怎么引入這些技能想要安裝superpowers。最初我以為又是什么新出的AI模型或者某個編輯器插件真正去翻了一遍開源社區(qū)才弄明白它并不是一個獨立軟件而是一套技能包工作流專門用來給AI助手裝上崗位化的專業(yè)能力。這篇就圍繞大家最關心的幾件事展開——superpowers到底能做什么、有哪些skills、怎么安裝、怎么在具體場景里真正用起來。我自己從裝到用大概折騰了兩周中間踩了不少坑也總結出一些和官方文檔不太一致的經驗。這篇文章不是搬運說明書而是把你真正會遇到的問題、會忽略的細節(jié)、會踩的坑一次性說清楚。1. superpowers的真實身份一套技能包而不是某個具體工具1.1 先回答熱搜里最常問的那句有沒有skills有而且數(shù)量不少。superpowers整個項目的核心資產就是一批預先寫好的技能文件skills每一個技能文件都對應一種完整的工作能力。你可以把它理解成給AI助手配了一整套崗位職責書它不再只會泛泛地聊天而是遇到具體任務時會自動啟用對應的專業(yè)流程。我安裝后掃描到的技能大致分這幾類技能組典型技能適用場景內容創(chuàng)作類寫博客、寫教程、改寫潤色、生成大綱公眾號推文、技術博客、產品文案研究分析類深度研究、觀點整理、數(shù)據(jù)核查行業(yè)調研、競品分析、資料匯總項目管理類目標拆解、任務規(guī)劃、風險檢查個人OKR、項目啟動、需求評審編程輔助類代碼審查、重構建議、Bug定位代碼評審會、重構任務、線上問題排查學習解釋類概念講解、手把手教學、常見誤區(qū)分析帶新人、技術分享、知識科普每個技能不是一句提示詞那么簡單它內部帶有完整的調用條件、執(zhí)行步驟、輸出結構、自查清單。這是superpowers和其他提示詞模板最不一樣的地方。1.2 它和普通提示詞模板的核心區(qū)別很多剛接觸的朋友會有一個誤解這不就是一堆現(xiàn)成的prompt嗎我自己寫一份幫我寫一篇技術博客的提示詞效果好像也差不多。實際用下來差別很大。普通提示詞模板是一次性臺詞你發(fā)給AI它回答結束下次再發(fā)同樣的臺詞它再從零開始。superpowers這類技能包走的是工作流模式當你觸發(fā)某個技能AI就進入該技能定義的完整工作流程。比如寫作技能會先問清目標讀者和文章目的再生成大綱然后逐段寫最后自己跑一遍查重和邏輯檢查。這個過程不是一次對話完成的而是多輪推進的。打個比方普通提示詞像外賣菜單你點一道菜它做一道技能包像請了個帶SOP的廚師你說今晚做一桌家常菜他會自己決定先洗菜還是先切菜按什么順序出菜出鍋前還要試味。這就是大家覺得用了superpowers之后AI變聰明了的根本原因——其實模型沒變變的是工作方法。2. 核心機制拆解技能文件、觸發(fā)詞與技能目錄是如何協(xié)作的2.1 SKILL.md一份技能文件的崗位說明書結構想用好superpowers必須先看懂它的技能文件長什么樣。每個技能通常是一個獨立目錄目錄里必須有一個SKILL.md主文件里面用結構化的方式描述這個技能的完整信息。下面是我從自己安裝的技能里抽出來的一個簡化模板--- name: write-blog-post description: 當用戶需要撰寫一篇結構完整、邏輯清晰的博客文章時使用。 when_to_use: 用戶明確說寫文章/寫博客/寫推文或提供素材要求組織成文。 triggers: - 寫一篇關于...的文章 - 幫我整理成博客 - 我需要一份發(fā)布用的長文 --- # 技能博客寫作 ## 輸入要求 - 目標讀者 - 文章主題 - 參考資料或關鍵信息點 ## 執(zhí)行步驟 1. 明確文章定位與核心觀點 2. 生成文章大綱并請用戶確認 3. 按大綱逐部分撰寫 4. 輸出后執(zhí)行自查清單 ## 輸出格式 - 標題、摘要、正文分段 - 含小標題和關鍵信息提示 ## 自查清單 - 開頭100字是否抓住注意力 - 段落是否有信息增量 - 結尾是否有明確行動指引這段內容看起來像配置但AI讀取時是靠它來判斷什么時候該用這個技能用了之后該做什么。其中最關鍵的是description和when_to_use這兩段寫得越清楚AI的判斷就越準。2.2 觸發(fā)詞的工作邏輯不是硬核命令而是意圖匹配很多人第一次接觸時會以為技能需要手動輸入某個斜杠命令來調用比如輸入/write才會觸發(fā)寫作技能。實際不是這樣。superpowers的觸發(fā)詞更像火柴AI會根據(jù)你對它說的話結合每個技能的description和when_to_use判斷要不要點燃這根火柴。舉個例子。你直接說幫我寫一篇關于智能家居的科普文章AI掃描技能庫后發(fā)現(xiàn)write-blog-post的when_to_use里寫了寫一篇關于...的文章于是自動加載這個技能然后開始按技能里的步驟走流程。這個過程不需要你記任何命令也不需要額外輸入觸發(fā)詞。這也帶來一個技巧如果你希望某個技能穩(wěn)定觸發(fā)最好在對話里把任務意圖說完整。比如用寫博客的技能幫我寫一篇面向新手的智能家居科普文比只說寫篇文章要穩(wěn)得多。意圖越明確AI匹配到正確技能的概率越高。2.3 技能目錄的加載順序與覆蓋規(guī)則superpowers安裝后會生成一個專門的技能目錄AI助手啟動時會掃描這個目錄下所有技能并建立索引。我本地的目錄結構大致是~/.superpowers/ ├── skills/ │ ├── write-blog-post/ │ │ ├── SKILL.md │ │ └── examples/ │ ├── deep-research/ │ │ ├── SKILL.md │ │ └── templates/ │ ├── project-planning/ │ │ └── SKILL.md │ └── ... ├── config/ │ └── settings.json └── logs/ └── skill-loader.log這里有個容易忽略的規(guī)則如果多個技能目錄里出現(xiàn)同名技能加載順序通常由配置里的掃描優(yōu)先級決定。默認情況下先掃描到的技能會優(yōu)先生效后面的同名技能會被跳過。也就是說你后安裝的版本不一定能覆蓋先安裝的版本必須去config/settings.json里調整優(yōu)先級或者直接刪掉不用的舊技能目錄。我最初就在這里栽過跟頭后面會專門講。3. 完整安裝過程與目錄規(guī)劃適合想要安裝superpowers的新手3.1 安裝前的環(huán)境準備先說結論你不需要新建什么特殊環(huán)境只需要有一個支持技能目錄的AI工作臺客戶端。目前主流做法是使用桌面版AI助手或帶工作區(qū)讀取能力的工作流工具因為superpowers的技能文件放在本地目錄里客戶端需要能讀取這個目錄并在對話中把這些技能作為上下文參考。安裝前我建議做三件事把現(xiàn)有AI助手的配置文件和對話記錄備份一份防止安裝過程干擾原環(huán)境。確認AI工作臺的版本支持加載本地Markdown技能文件如果不支持需要選擇兼容的運行方式或配合腳本加載。規(guī)劃好技能目錄的存放位置建議固定在~/.superpowers或項目工作區(qū)的.superpowers目錄不要隨手亂放。這一步別省。我見過不少人上來直接跑安裝腳本裝完發(fā)現(xiàn)AI根本讀不到技能回頭排查才發(fā)現(xiàn)是AI客戶端的工作區(qū)和技能目錄不在同一個路徑下。3.2 兩種安裝方式自動腳本與手動部署superpowers官方倉庫提供了自動安裝腳本也支持手動部署。我用過的比較穩(wěn)妥的方式是先自動安裝、再手動修正配置。自動安裝的命令大致是這樣git clone superpowers倉庫地址 ~/superpowers-src cd ~/superpowers-src ./install.sh安裝腳本會問你幾個問題包括技能目錄放哪里、是否創(chuàng)建默認配置、是否備份舊配置?；卮鹜晁鼤詣影裺kills目錄復制到目標位置并生成一份settings.json。如果你不想跑腳本也可以手動部署把倉庫里的skills目錄完整復制到你的~/.superpowers/下。檢查settings.json是否存在不存在則手動創(chuàng)建一個空配置。重啟AI工作臺客戶端讓技能被重新掃描加載。手動方式適合需要精細控制目錄結構的人。我推薦第一次使用先跑自動腳本等熟悉了目錄結構再手動調整也不遲。3.3 安裝后驗證不急著用先做一次技能體檢裝完之后別急著寫文章先花兩分鐘確認技能真的加載成功。最直接的辦法是在對話里問一句你現(xiàn)在加載了哪些技能AI如果正常讀到技能目錄會列出可用的技能清單。如果它回答不上來大概率是目錄路徑或權限有問題。我整理了一份簡單的驗證清單檢查項預期結果如果異常怎么辦技能目錄存在~/.superpowers/skills下有多個技能子目錄重新執(zhí)行安裝腳本或手動復制AI能列出技能名對話中詢問技能列表有明確回復檢查AI工作臺的工作區(qū)是否指向技能目錄觸發(fā)技能有響應輸入幫我寫一篇科普文章后AI進入寫作流程檢查SKILL.md里的when_to_use是否被正確讀取日志無報錯logs/skill-loader.log沒有讀取失敗記錄查看是否有權限不足或YAML格式錯誤做完這四項檢查基本可以確定技能已經就位。我見過很多裝完沒用上的情況80%都是卡在這一步——不是安裝失敗是根本沒驗證AI是否真的讀到了技能文件。4. 具體使用的三種高頻場景寫作、研究、規(guī)劃4.1 內容創(chuàng)作場景怎么讓AI自動進入寫作者狀態(tài)我平時寫技術博客最多所以最先測的就是寫作技能。進入方式很簡單直接在對話里提出完整需求用寫博客的技能幫我寫一篇關于如何搭建個人知識庫的科普文章。目標讀者是剛接觸知識管理的職場人希望文章能講清楚工具選擇和工作流搭建字數(shù)在3000字左右。這時候AI會按照技能流程走先確認讀者畫像再給出大綱我確認后才開始正文寫作。和普通對話最大的區(qū)別是它不會一口氣把文章全倒出來而是分階段推進中間還會根據(jù)我的反饋調整。寫完后它會自動跑自查清單。我常用的是博客寫作技能它的檢查項包括開頭有沒有直接點明問題、段落之間有沒有邏輯跳躍、信息點是否足夠具體。這比自己肉眼校對要省力不少。不過我也發(fā)現(xiàn)一個需要留意的點技能生成的大綱質量很高但正文容易偏工整看起來挑不出毛病卻缺少個人觀點。所以我一般會在輸入需求時就補充加入你個人的實踐經驗這樣生成的內容會更貼近真實分享而不是模板感很重的科普。4.2 研究分析場景怎么觸發(fā)深度研究技能深度研究技能是我認為superpowers里最被低估的一個。觸發(fā)它不需要說復雜的話只需要把你的研究目標講清楚使用深度研究技能幫我整理一份關于國內低代碼平臺選型的調研資料。重點對比主流平臺的功能差異、定價模式、適用企業(yè)規(guī)模、典型落地案例。觸發(fā)后AI會按研究技能定義的流程工作先列出信息收集框架再逐項填充最后輸出一份帶信息來源和可信度評估的調研清單。和普通問答的區(qū)別在于它會先把需要知道什么拆出來而不是直接給你一段概括。比如它輸出的信息框架會有這些維度平臺背景、核心能力、價格檔位、適用場景、限制與風險。每個維度下面再展開具體信息。這樣的結構直接可以拿來當匯報材料底稿比自己看到什么查什么要系統(tǒng)得多。在使用這個技能時我建議配合一個習慣明確提出請區(qū)分事實和推測。AI在輸出調研內容時有時會把推斷內容和已知信息混在一起。加了這句話之后它會在每條信息后面標注可信度方便你判斷哪些可以直接用、哪些還需要進一步核實。4.3 項目規(guī)劃場景把模糊目標拆成可執(zhí)行任務項目規(guī)劃技能是我的高頻使用項。過去面對一個模糊目標時我習慣自己拿紙筆列步驟想到哪寫到哪?，F(xiàn)在我會直接這樣觸發(fā)使用項目規(guī)劃技能幫我把兩個月內上線一個輕量級內容社區(qū)這個目標拆解成可執(zhí)行的任務清單包含階段劃分、關鍵里程碑、風險和驗收標準。AI會按照項目規(guī)劃技能的流程輸出一份結構化計劃一般包含目標定義、階段拆分、每階段的具體任務、負責人建議、時間估算、風險清單、驗收標準。它會強迫你把想做的事情變成能執(zhí)行的任務。這里分享一個我實測的小技巧不要只給一句目標就完事最好把已知的約束條件一起丟進去比如團隊只有兩個人后端使用現(xiàn)成的服務每天只有晚上有兩小時開發(fā)時間。技能文件里雖然定義了通用步驟但它非常依賴輸入信息。你給的約束越具體輸出的計劃就越接近可執(zhí)行狀態(tài)而不是一份放之四海而皆準的模板。5. 實測中的踩坑記錄與進階組合用法5.1 最常見的三個坑和解決方式第一個坑技能沒加載或觸發(fā)詞不生效。這個最隱蔽。我遇到過的情況是AI能正常聊天但輸入觸發(fā)語句時完全進入不了技能流程。排查后發(fā)現(xiàn)是AI工作臺的工作區(qū)目錄沒有指向技能目錄導致它讀不到SKILL.md。解決方式是把工作區(qū)路徑改到包含skills目錄的那一級然后重啟客戶端。如果你也遇到明明安裝了卻沒用上先檢查路徑別急著重裝。第二個坑多個技能同時被觸發(fā)輸出內容串味。有一次我既想要深度研究又想要博客寫作結果在對話里同時說了兩個技能的觸發(fā)內容AI居然把兩個技能混在一起輸出的文章既有研究框架又有寫作流程兩邊都不完整。后來我學到的辦法是一次對話只觸一個技能如果確實需要組合使用就明確告訴AI先執(zhí)行A技能的步驟再套用B技能的格式。這樣它才會按順序切換而不是平行地縫合多個流程。第三個坑技能文件格式錯誤導致加載失敗。superpowers的技能文件主要是Markdown格式但其中一些元信息要求特定的寫法。我曾在自己的自定義技能里少寫了一個字段日志直接報錯AI完全忽略了這個技能且沒有任何彈窗提示。所以修改技能文件后一定要去看logs/skill-loader.log確認技能被成功索引。這個習慣幫我避開了很多改了沒生效的困惑。5.2 組合技能的高級用法讓多個技能協(xié)同干活技能單獨用的時候已經很順手但真正體現(xiàn)價值的是組合使用。我自己最常做的組合是深度研究 博客寫作先用研究技能把資料整理成結構化信息清單再觸發(fā)寫作技能讓AI基于清單寫文章。這樣輸出的文章信息密度明顯比單純讓AI直接寫要高。另一種組合是項目規(guī)劃 代碼審查先讓規(guī)劃技能把功能拆成模塊和任務再讓代碼審查技能對現(xiàn)有代碼按模塊逐一檢查。兩者配合起來比單獨跑一輪代碼審查得出的結論更貼合項目階段。組合調用的實操要點是一個階段只激活一個技能階段切換時要用清晰的語言做標記比如研究部分完成現(xiàn)在進入寫作階段請使用寫博客的技能。這樣AI不會混淆當前操作流程輸出也更連貫。5.3 自定義新技能的注意事項用了一段時間后你大概率會想寫自己的技能。我的建議是不要一上來就寫復雜的先從一個高頻重復的單一任務開始。比如你經常讓AI幫你整理會議紀要那就寫一個會議紀要整理技能把固定步驟、輸出模板全寫進SKILL.md。寫技能文件時有幾個重點description要寫清楚適用邊界寧可多寫幾行也不要含糊。when_to_use要包含你實際會用的表達方式。比如你平時習慣說把今天的會議整理一下那就把這個原句寫進去。執(zhí)行步驟要具體到AI可操作的粒度不要只寫撰寫紀要要寫清先列出參會人、再按議題歸納結論、最后標出待辦事項和負責人。輸出格式最好給一個樣例AI照格式輸出時偏差會小很多。寫完一定要做觸發(fā)測試并根據(jù)結果調整描述和步驟。這里也提醒一點技能不是越多越好。安裝太多技能反而會讓AI在匹配時猶豫甚至誤觸發(fā)。我自己的原則是把真正高頻使用的技能訓熟低頻需求直接用普通對話解決不為偶爾一次的任務增加技能庫的噪聲。用到現(xiàn)在我最實際的體會是superpowers沒有讓AI變聰明但它確實讓我的工作方式變得更有章法。以前寫文章靠臨場發(fā)揮現(xiàn)在有固定的寫作流程兜底以前做調研東一下西一下現(xiàn)在AI會先給我信息框架再填內容。它把很多隱性的工作方法顯性化了。如果你正準備安裝superpowers建議從寫作、研究、規(guī)劃這三個技能開始體驗不要一上來就把整個技能庫全裝進去。先用熟一兩個建立起對技能式工作流的感覺再慢慢擴展你會找到最適合自己的節(jié)奏。