最近小半年AI 編程工具圈子里“skills”這個(gè)詞的熱度肉眼可見地漲了起來。Claude Code、Codex、OpenCode 這些工具都陸續(xù)支持通過 skills 給 AI 注入可復(fù)用的專業(yè)能力GitHub 上各種 skills 合集也越來越多從前端開發(fā)、數(shù)學(xué)建模到 AI 漫劇制作幾乎每個(gè)高頻場(chǎng)景都有人做了對(duì)應(yīng)的技能包。我自己從五月初開始把手頭的公共流程逐個(gè)沉淀成 skills幾個(gè)項(xiàng)目跑下來效率和穩(wěn)定性的提升是實(shí)打?qū)嵉?。這篇就圍繞 skills 這個(gè)主題把“它到底是什么、哪些值得用、怎么手動(dòng)裝、怎么寫、怎么排坑”一次講透適合剛接觸這個(gè)概念的新手也適合已經(jīng)在用但想系統(tǒng)整理 skills 的同學(xué)。1. 先搞清楚AI Skills 到底是個(gè)什么東西1.1 從 superpower skills 說開去社區(qū)里最出圈的一套能力包就是 superpower skills很多人第一次意識(shí)到“原來 AI 還能這么用”就是從它開始的。簡單說skills 是一種把特定任務(wù)的“解題套路”打包成文件的能力機(jī)制你給 AI 一份結(jié)構(gòu)化的說明文檔里面寫清楚某個(gè)領(lǐng)域的工作流程、判斷標(biāo)準(zhǔn)、代碼約定、常見陷阱AI 在遇到相關(guān)任務(wù)時(shí)會(huì)主動(dòng)讀取這份文檔按里面定義的“套路”來工作而不是每次都用通用能力臨場(chǎng)發(fā)揮。我習(xí)慣把它理解成給 AI 寫“崗位說明書”。比如你在前端項(xiàng)目里希望 AI 遵守團(tuán)隊(duì)的 commit 規(guī)范、組件命名約定、自動(dòng)化測(cè)試覆蓋要求如果不用 skills你就得在每個(gè) prompt 里反復(fù)強(qiáng)調(diào)而且它還經(jīng)常忘。把這些約束寫進(jìn)一個(gè) skill 文件AI 每次啟動(dòng)相關(guān)任務(wù)時(shí)就會(huì)自動(dòng)把它加入上下文行為表現(xiàn)明顯更穩(wěn)定。superpower skills 之所以受歡迎就是因?yàn)樗堰@種“崗位說明書”按場(chǎng)景拆得很細(xì)從代碼審查到項(xiàng)目規(guī)劃都有對(duì)應(yīng)技能拿來即用。1.2 Skills、提示詞和插件三者的邊界很多人會(huì)問skills 和大段提示詞、傳統(tǒng)插件有什么區(qū)別我自己的使用體感是這樣的提示詞是“一次性指令”你說完就完了AI 只能當(dāng)次遵守下次還得重新說。插件是“外部工具接入”它更多解決的是 AI 能力邊界問題比如讓它能跑命令、讀網(wǎng)頁。Skills 介于兩者之間它不改變 AI 的能力邊界而是改變 AI 的“工作方式”真正解決的是行為一致性、專業(yè)深度的問題。一個(gè)很典型的例子團(tuán)隊(duì)里有個(gè)后端老手每次寫接口都要先列字段校驗(yàn)、再寫錯(cuò)誤碼、最后補(bǔ)接口文檔。這套經(jīng)驗(yàn)寫在人腦里很難傳給新同事。但如果把它寫成 skillAI 就能按照這套“老手流程”來生成接口代碼新人也通過觀察 AI 的輸出反向?qū)W會(huì)這套流程。所以 skills 某種意義上也是一種“經(jīng)驗(yàn)的編碼化表達(dá)”它是把人的方法論固化下來再讓 AI 去執(zhí)行。2. 值得先裝的 Skills 與技能源網(wǎng)站2.1 社區(qū)熱度最高的幾套能力包GitHub 上現(xiàn)在能直接搜到一堆 skills 合集挑幾個(gè)我實(shí)際用過、體感不錯(cuò)的說一下superpower skills這家的特點(diǎn)是“全”從 Java、Python 到前端項(xiàng)目腳手架、代碼審查都有分類很清晰適合做入門套裝。安裝后每個(gè) skill 對(duì)應(yīng)一個(gè)子目錄AI 會(huì)根據(jù)任務(wù)自動(dòng)選擇調(diào)用不會(huì)一上來把所有內(nèi)容都塞進(jìn)上下文。typesafe ai skills做 TypeScript/全棧項(xiàng)目的同學(xué)重點(diǎn)看一下。它把類型安全相關(guān)的約束寫得非常細(xì)包括泛型使用邊界、API 類型推導(dǎo)、錯(cuò)誤處理模式對(duì)追求代碼健壯性的團(tuán)隊(duì)很友好。cola skills名字看著隨意實(shí)際是一套偏“生產(chǎn)效率”的技能集合覆蓋了會(huì)議紀(jì)要整理、需求拆分、PR 描述生成這類日常開發(fā)雜活能省下不少隱形時(shí)間。codex nature skills主要針對(duì) Codex 使用場(chǎng)景優(yōu)化里面的技能文件更貼近“自然語言驅(qū)動(dòng)編程”的寫法比如用一段口語化描述快速生成 CRUD 代碼框架然后讓 AI 自己補(bǔ)齊邊界情況。我的建議是不要貪多。skills 不是裝得越多越好因?yàn)?AI 每次都要在心里“翻閱”技能目錄來匹配任務(wù)裝 50 個(gè)技能不代表它每次都會(huì)精準(zhǔn)選中最好的那個(gè)。我個(gè)人的節(jié)奏是第一周只裝 superpower skills 里的 3-5 個(gè)高頻技能跑順了之后再逐步增加。2.2 常用 Skills 源網(wǎng)站和檢索方式很多新手卡在“去哪找 skills”。除直接去 GitHub 搜索claude skills、codex skills這類關(guān)鍵詞外還有幾個(gè)聚集了大量技能包的托管站點(diǎn)可以重點(diǎn)收藏Awesome Claude Code / Awesome Codex 這類合集倉庫它們專門收錄社區(qū)的高質(zhì)量 skills帶目錄和說明相當(dāng)于技能包行業(yè)的 “awesome list”優(yōu)先從這里找不容易踩坑。個(gè)人博客和公眾號(hào)的分享文章不少資深使用者會(huì)把自己沉淀的 skill 寫成教程附帶下載鏈接。這類技能包往往比通用倉庫的更貼合實(shí)戰(zhàn)場(chǎng)景因?yàn)樗鼈兪菑木唧w項(xiàng)目里長出來的不是憑空設(shè)計(jì)的。npm / PyPI 上的發(fā)布包有些技能作者會(huì)把 skills 打成 npm 包或 Python 包發(fā)布方便用包管理器安裝。這種方式的好處是版本管理很干凈升級(jí)、回退都有跡可循。搜索時(shí)有個(gè)技巧不要只搜“skills”這個(gè)寬泛詞要把場(chǎng)景詞帶上比如“前端開發(fā) skills”“數(shù)學(xué)建模 skills”“AI 漫劇常用 skills”這樣找到的結(jié)果會(huì)精準(zhǔn)很多。之前我在找數(shù)學(xué)建模相關(guān)的技能包時(shí)直接搜“數(shù)學(xué)建模 skills”幾乎沒有有效結(jié)果但換成“codex skills 數(shù)學(xué)建?！薄癱laude skills 建模比賽”之后很快就找到了好幾個(gè)群體維護(hù)的集合。3. 手動(dòng)安裝 GitHub 上的 Skills 實(shí)操3.1 Claude Code 手動(dòng)安裝 SkillsClaude Code 對(duì) skills 的原生支持做得比較早安裝機(jī)制也最簡單。先說最常用的情況你從 GitHub 上下載了一個(gè) skills 倉庫里面有很多以技能名命名的目錄每個(gè)目錄里都有一個(gè)SKILL.md文件安裝步驟如下把倉庫 clone 到本地或者直接下載 ZIP 解壓。打開 Claude Code 的全局 skills 目錄macOS / Linux 一般是~/.claude/skills/Windows 在%USERPROFILE%\.claude\skills\。把你需要的技能子目錄整個(gè)復(fù)制進(jìn)去注意是一個(gè)技能一個(gè)目錄不要把SKILL.md直接扔到 skills 根目錄。重啟 Claude Code 會(huì)話然后在對(duì)話里輸入/skills或直接問“你現(xiàn)在有哪些技能”看它是否識(shí)別到你剛裝入的技能。這里有個(gè)很容易出錯(cuò)的地方不要在SKILL.md文件里加過多與主題無關(guān)的內(nèi)容。Claude Code 在匹配技能時(shí)會(huì)把SKILL.md的頭部元信息和前幾段內(nèi)容當(dāng)作“技能摘要”來用如果摘要寫得太模糊AI 就不知道什么時(shí)候該用這個(gè)技能。比如你裝一個(gè)“數(shù)學(xué)建?？焖俳?skill”摘要里那個(gè)人卻寫“這個(gè)技能用于各種文檔生成”AI 大概率會(huì)在寫周報(bào)的時(shí)候把它調(diào)出來結(jié)果自然是牛頭不對(duì)馬嘴。3.2 Codex 與 OpenCode 的安裝路徑Codex 的 skills 機(jī)制與 Claude Code 大同小異區(qū)別主要在目錄命名和配置文件的解析規(guī)則上。Codex 一般讀取~/.codex/skills/目錄下的技能包在項(xiàng)目里也可以用.codex/skills/實(shí)現(xiàn)“僅該項(xiàng)目可用”的局部技能。我在實(shí)際使用中發(fā)現(xiàn)Codex 對(duì)技能正文里的“步驟化指令”解析更強(qiáng)所以寫 Codex skill 時(shí)盡量把一個(gè)任務(wù)拆成清晰的 numbered steps效果會(huì)比大段散文更好。OpenCode 的安裝路徑則更接近“配置文件驅(qū)動(dòng)”。它通常讀取~/.config/opencode/skills/或項(xiàng)目內(nèi)的.opencode/skills/目錄。安裝方式同樣是復(fù)制技能目錄但需要注意 OpenCode 對(duì)技能元信息的校驗(yàn)更嚴(yán)格如果SKILL.md頭部的 YAML 字段缺少name或description它可能直接忽略整個(gè)技能而不是報(bào)錯(cuò)。遇到裝完沒生效的情況第一步就去檢查 YAML 頭部是否完整。不管是哪種工具通用原則是一致的在全局目錄安裝則所有項(xiàng)目可用在項(xiàng)目內(nèi)安裝則只有當(dāng)前項(xiàng)目可用。個(gè)人的建議是通用型技能如代碼風(fēng)格約定、git 工作流規(guī)范放在全局目錄領(lǐng)域?qū)Ｓ眯图寄苋缒硞€(gè)業(yè)務(wù)系統(tǒng)的架構(gòu)說明、某個(gè)特定比賽的建模套路放在項(xiàng)目目錄這樣 AI 在匹配任務(wù)時(shí)不會(huì)因?yàn)榧寄芴喽靵y。3.3 前端開發(fā)、數(shù)學(xué)建模、AI 漫劇場(chǎng)景配置示例挑三個(gè)高頻場(chǎng)景說下具體的技能包配置思路。前端開發(fā) skills技能目錄里至少要有SKILL.md和rules/保存代碼規(guī)范、templates/保存組件模板這幾個(gè)子目錄。我常用的一套前端技能會(huì)在SKILL.md里寫清楚組件文件命名用 PascalCase、樣式文件與組件同目錄、狀態(tài)管理統(tǒng)一走 hooks、頁面路由統(tǒng)一懶加載。配置完成后我再讓 AI 寫一個(gè)用戶登錄頁它產(chǎn)出的代碼結(jié)構(gòu)幾乎和我手寫的一致review 成本大幅下降。數(shù)學(xué)建模 skills這個(gè)場(chǎng)景比較特殊因?yàn)榻１荣惖娜蝿?wù)通常是一個(gè)開放性問題不是“寫代碼”那么簡單。我見過效果不錯(cuò)的建模技能包里面會(huì)把整個(gè)流程拆成“問題分析 → 假設(shè)確立 → 模型選擇 → 靈敏度分析 → 論文寫作”五個(gè)階段每個(gè)階段在SKILL.md里有明確的產(chǎn)出物模板。實(shí)戰(zhàn)時(shí) AI 會(huì)自動(dòng)按這個(gè)流程推進(jìn)而不是一開始就埋頭調(diào)參。搭配上對(duì)matplotlib繪圖風(fēng)格的規(guī)范、對(duì)公式排版的要求論文初稿的質(zhì)量會(huì)高一個(gè)檔次。AI 漫劇常用 skills這個(gè)領(lǐng)域最近特別火技能包的核心是“鏡頭感”。一個(gè)好的漫劇 skill 會(huì)告訴 AI 如何把一個(gè)腳本片段拆成分鏡、每個(gè)分鏡應(yīng)該包含哪些場(chǎng)記信息、對(duì)話和旁白如何排版、角色情緒如何用視覺語言表達(dá)。這類技能偏內(nèi)容創(chuàng)作安裝后主要影響 AI 的“劇本解讀能力”同樣的故事腳本有沒有這個(gè)技能包裝出來是兩種效果。4. 從用到寫開發(fā)自己的 Skills4.1 SKILL.md 結(jié)構(gòu)與格式規(guī)范用了一段時(shí)間別人的技能包你會(huì)發(fā)現(xiàn)最適配的還是自己寫的那份。寫 skill 并不神秘核心就是維護(hù)一個(gè)SKILL.md文件它的基本格式遵循 Markdown YAML frontmatter 的約定--- name: frontend-bootstrap description: 用于初始化前端項(xiàng)目的技能包含目錄結(jié)構(gòu)、命名規(guī)范、構(gòu)建配置和代碼風(fēng)格約定。當(dāng)前端項(xiàng)目是 React TypeScript Vite 時(shí)自動(dòng)調(diào)用。 --- # 前端項(xiàng)目初始化 ## 項(xiàng)目結(jié)構(gòu) - src/components存放組件組件文件使用 PascalCase 命名 - src/hooks存放自定義 hooks文件名使用 camelCase ## 初始化步驟 1. 使用 Vite 創(chuàng)建項(xiàng)目指定 react-ts 模板 2. 安裝基礎(chǔ)依賴react-router-dom、zustand、axios 3. 配置 eslint 與 prettier規(guī)則參考 .eslintrc 文件 ## 代碼約定 - 禁止使用 any 類型 - 接口響應(yīng)統(tǒng)一用 ApiResponseT 包裹注意description字段是天坑很多初學(xué)者在這里寫幾句話就完事但它的作用其實(shí)是“技能索引”。AI 在決策要不要用某個(gè)技能時(shí)主要看這段描述與當(dāng)前任務(wù)的匹配度。寫描述時(shí)要盡量包含觸發(fā)條件、適用場(chǎng)景不要只寫功能概括。正文部分建議按“背景 → 步驟 → 檢查清單 → 常見問題”的結(jié)構(gòu)來寫。背景讓 AI 理解為什么這么做步驟讓它知道怎么做檢查清單讓它在結(jié)果出現(xiàn)偏差時(shí)可自查常見問題則幫它提前避免失誤。一套成熟的技能文件這四個(gè)部分缺一不可。4.2 前端開發(fā) Skills 的寫法示例拿前端項(xiàng)目中最常見的“新增一個(gè)列表頁面”來說沒有技能時(shí) AI 的產(chǎn)出波動(dòng)很大——有時(shí)候?qū)?class 組件有時(shí)候?qū)懞瘮?shù)組件有時(shí)候封裝表格有時(shí)候一把梭。寫一個(gè)>--- name:># 模型選擇決策路徑 1. 拿到問題后先判斷數(shù)據(jù)類型是時(shí)序數(shù)據(jù)、截面數(shù)據(jù)還是面板數(shù)據(jù) 2. 截面數(shù)據(jù)優(yōu)先考慮回歸模型先做多重共線性檢驗(yàn) 3. 時(shí)序數(shù)據(jù)優(yōu)先考慮 ARIMA / Prophet 等序列模型但必須先做平穩(wěn)性檢驗(yàn) 4. 若數(shù)據(jù)量極小少于 30 條放棄機(jī)器學(xué)習(xí)模型改用統(tǒng)計(jì)推斷 5. 每選擇一種模型必須列明適用條件、優(yōu)點(diǎn)、局限并在論文中說明選擇理由這類技能表面看是規(guī)矩實(shí)際上是把一個(gè)“建模老手”的思維過程顯化出來。AI 讀了這份技能就不會(huì)一上來就甩一個(gè)復(fù)雜的 LSTM而是先做假設(shè)、做數(shù)據(jù)探查、驗(yàn)證前提條件整個(gè)建模過程會(huì)嚴(yán)謹(jǐn)很多。寫技能還有一個(gè)實(shí)用技巧每個(gè)步驟后加一句“為什么”。AI 本質(zhì)上是概率模型它理解“怎么做”很容易但如果沒有“為什么”做支撐一旦任務(wù)場(chǎng)景偏離技能預(yù)設(shè)它就會(huì)生搬硬套。有“為什么”的說明它才能在邊界情況下做出合理調(diào)整。5. 常見問題與調(diào)試實(shí)錄5.1 裝完不生效AI 始終不調(diào)用這是我被問得最多的問題。排查思路我建議按順序來確認(rèn)技能目錄位置是否正確。很多工具對(duì)全局目錄和項(xiàng)目目錄的優(yōu)先級(jí)處理不一致有可能項(xiàng)目內(nèi)同名技能把全局技能覆蓋了。確認(rèn) SKILL.md 頭部 YAML 是否完整。name與description是必須要有的description缺失是 AI 不調(diào)用技能的最常見原因。確認(rèn)技能文件是否被工具加載。直接在對(duì)話里問它“你現(xiàn)在有哪些可用技能”如果列表里沒有說明加載失敗有但不用說明description寫得不夠精準(zhǔn)。重啟會(huì)話再試。有次我改了技能正文AI 一直還在用舊版本重啟后才發(fā)現(xiàn)新內(nèi)容已經(jīng)生效。還有個(gè)容易誤導(dǎo)人的情況很多用戶會(huì)在對(duì)話里手動(dòng)指定“請(qǐng)使用 xx 技能”這時(shí) AI 回復(fù)“好的”但實(shí)際代碼輸出并沒有體現(xiàn)技能特征。這是因?yàn)椴糠止ぞ甙选坝脩麸@式提及技能”當(dāng)作高優(yōu)先級(jí)指令把技能正文當(dāng)作低優(yōu)先級(jí)參考。要判斷技能是否真的被調(diào)用最有效的辦法是在SKILL.md里埋一個(gè)標(biāo)志性輸出比如“本頁面使用>