最近在技術(shù)社區(qū)里一個話題開始被頻繁提起“聽說一些公司開始做員工skills了”。如果你關(guān)注過 Claude Code、Codex、Cursor、OpenCode 這些 AI 編程工具大概率已經(jīng)見過skills這個英文詞。它并非某一家公司的專屬概念而是正在成為 AI Agent 時代的一種新“知識封裝單元”。但聽到“員工skills”很多人第一反應(yīng)是這不就是給 AI 寫提示詞嗎公司搞這個和以前沉淀文檔、做 Wiki、搞專家?guī)煊惺裁磪^(qū)別這篇文章想聊清楚幾件事員工skills到底是什么為什么它和提示詞、Agent、Tools 這些概念有本質(zhì)差異以及一家公司如果要落地“員工skills”應(yīng)該從哪個環(huán)節(jié)開始、有哪些坑、需要什么樣的工程規(guī)范。文章會給出一個完整的示例從目錄結(jié)構(gòu)、編寫規(guī)范到實(shí)際安裝和驗(yàn)證盡量讓技術(shù)讀者看完后不僅理解概念還能在自己的項(xiàng)目里跑通一個最小閉環(huán)。1. 這篇文章真正要解決的問題先從一個具體的場景切入。假設(shè)你是一家公司的前端負(fù)責(zé)人團(tuán)隊(duì) 20 個人每天要用 AI 輔助做代碼審查。你發(fā)現(xiàn)不同的開發(fā)問 AI 的方式完全不一樣有的人會貼上一大段代碼讓 AI“幫我看看有沒有問題”有的人會要求“找出性能隱患和可訪問性問題”還有的人希望 AI 按照團(tuán)隊(duì)自己的 ESLint 規(guī)則給出修改建議。結(jié)果就是AI 的回答質(zhì)量參差不齊。團(tuán)隊(duì)成員每次都要寫不同的提示詞有人寫得好有人寫得差。更麻煩的是團(tuán)隊(duì)積累的那些審查經(jīng)驗(yàn)比如“圖片必須加懶加載”“按鈕交互必須有 loading 態(tài)”“移動端禁止橫向滾動”全部散落在各種文檔和每個人的腦海里AI 根本不知道。這時候如果做一套“前端代碼審查 skills”把這些規(guī)則、檢查項(xiàng)、示例代碼全部封裝成一個可復(fù)用的技能包團(tuán)隊(duì)成員只要讓 AI 加載這個 skillAI 就能按照團(tuán)隊(duì)一致的規(guī)范去審查代碼。這就是“員工skills”要解決的問題把人和團(tuán)隊(duì)的經(jīng)驗(yàn)轉(zhuǎn)化為 AI 可復(fù)用的能力模塊而不是靠每個人反復(fù)輸入零散的提示詞。所以這篇文章值得一讀的人群包括正在使用 Claude Code、Codex、Cursor、OpenCode 等 AI 編程工具的開發(fā)者。團(tuán)隊(duì)里負(fù)責(zé) AI 工程化、負(fù)責(zé)沉淀開發(fā)規(guī)范的架構(gòu)師和技術(shù)負(fù)責(zé)人。對 Agent、Skill、Tool 這些概念有困惑想搞清楚它們之間邊界的人。讀完這篇文章你會明白員工skills不是“給 AI 寫幾句提示詞”那么簡單而是一套有結(jié)構(gòu)、有目錄規(guī)范、有可執(zhí)行腳本、有驗(yàn)證方式的工程化產(chǎn)物。2. Skills 的基礎(chǔ)概念它到底是哪一層的東西要理解員工skills首先得把“skills”和它周圍的幾個概念分清楚。2.1 Skills 是什么從材料信息看當(dāng)前 AI 工具鏈中影響最廣的 skills 規(guī)范之一是 Anthropic 推行的 Agent Skills 格式。這個格式的基本單元是一個目錄目錄里包含一個SKILL.md文件用來描述這個技能的功能、使用場景、工作流程目錄里還可以放各種輔助腳本、模板、參考文檔它們會被 AI 在執(zhí)行任務(wù)時動態(tài)加載。一個典型的 skills 目錄結(jié)構(gòu)看起來是這樣的code-review-skill/ ├── SKILL.md └── scripts/ ├── check-eslint.md └── review-frontend.py這里面的關(guān)鍵設(shè)計是SKILL.md 不是給人類閱讀的而是給 AI 讀取的指令手冊。當(dāng) AI 遇到與這個 skill 相關(guān)的任務(wù)時它會自動讀取 SKILL.md按照里面的規(guī)則和流程去執(zhí)行。這樣一來人類團(tuán)隊(duì)的規(guī)范就變成了 AI 的工作指南。2.2 Skills 和提示詞Prompt的區(qū)別很多人覺得 skills 就是高級提示詞這種理解對了一半。提示詞是一次性的自然語言指令。它存在于對話上下文里用完就沒了。即使你把自己的提示詞寫得天花亂墜換個會話AI 又忘得一干二凈。Skills 是持久化的能力封裝。它不只是“一段文字指令”還包括執(zhí)行邏輯、參考資料、腳本工具以及觸發(fā)條件。更重要的是skills 是放在項(xiàng)目目錄里的文件可以被版本管理可以被團(tuán)隊(duì)分享可以被 AI 動態(tài)發(fā)現(xiàn)和加載。打個比方提示詞像你在餐廳臨時告訴廚師“這道菜少放鹽、多放辣、不要香菜”skills 像廚師手里那本標(biāo)準(zhǔn)化菜譜里面規(guī)定了每一步的做法、用哪種醬油、什么時候下鍋。2.3 Skills 和 Tools、Agents 的區(qū)別這里有一個非常容易混淆的點(diǎn)。Tools 是 AI 可以調(diào)用的外部功能。比如“搜索網(wǎng)頁”“讀文件”“執(zhí)行代碼”“調(diào)用某個 API”。它們解決的是“AI 能對外部世界做什么”的問題。在 Claude Code 里Tools 是內(nèi)置的你可以讓 AI 讀文件、寫文件、執(zhí)行 Bash 命令。Skills 解決的是“AI 如何按照特定方式做一件事”的問題。它更像一套操作規(guī)范告訴你什么時候調(diào)用工具、調(diào)用哪些工具、按照什么順序、遵循什么標(biāo)準(zhǔn)。同一個 Tool用不同的 Skills 去編排產(chǎn)出的結(jié)果會完全不同。Agents 則是更大的概念。Agent 是一個能自主規(guī)劃、調(diào)用工具、執(zhí)行任務(wù)的系統(tǒng)。Skills 可以理解為 Agent 身上的技能包。一個粗略的層級關(guān)系是概念解決的問題形態(tài)提示詞告訴 AI 做什么一段文本Tools讓 AI 能操作外部世界函數(shù)/API/命令Skills讓 AI 按特定標(biāo)準(zhǔn)完成一類任務(wù)規(guī)則文檔腳本參考資料Agents自主分析、決策、執(zhí)行復(fù)雜任務(wù)一個智能體程序這樣看下來員工skills的真正價值就清晰了它不是給某個具體任務(wù)寫一次性提示詞而是把一類可重復(fù)的任務(wù)固化成 AI 能穩(wěn)定執(zhí)行的能力標(biāo)準(zhǔn)。2.4 Skills 和 MCP 的關(guān)系還有一個容易混淆的概念是 MCPModel Context Protocol。MCP 解決的是“如何把外部數(shù)據(jù)源和工具接入 AI”的傳輸協(xié)議問題。Skills 和 MCP 不是競爭關(guān)系而是不同層次的東西。Skills 可以觸發(fā) AI 去調(diào)用 MCP 服務(wù)器提供的工具也可以直接使用腳本完成工作。它們是互補(bǔ)的。在實(shí)際項(xiàng)目中一個清晰的判斷是如果你只是給 AI 提供“按團(tuán)隊(duì)規(guī)范審查代碼”“按固定格式生成會議紀(jì)要”這類標(biāo)準(zhǔn)化能力skills 是更輕量、更直接的選擇如果你需要接入公司內(nèi)部的數(shù)據(jù)源、API、數(shù)據(jù)庫MCP 可能更合適。兩者可以同時存在。3. 為什么公司開始把“員工skills”當(dāng)成一件事來做聊完概念回到文章標(biāo)題為什么一些公司開始做員工skills了核心驅(qū)動因素是AI 工具的普及讓“個人能力”和“組織能力”之間的差距被放大了。過去一個資深工程師的經(jīng)驗(yàn)通過代碼評審、技術(shù)分享、文檔沉淀來傳遞。這個過程很慢而且損耗很大。新員工要看很久文檔、問很多人才能達(dá)到“像老員工一樣做事”的水平。但在 AI 編程工具普及之后團(tuán)隊(duì)里的每一個開發(fā)都在和 AI 協(xié)作。AI 的輸出質(zhì)量取決于:你給了它什么上下文它知不知道你的團(tuán)隊(duì)規(guī)范有沒有按照你的工程標(biāo)準(zhǔn)去執(zhí)行。這時候團(tuán)隊(duì)遇到一個尷尬的問題AI 對公共知識很精通但對公司內(nèi)部的知識一無所知。它不知道你們的命名規(guī)范、不知道你們的發(fā)布流程、不知道你們常見的線上事故、不知道你們約定俗成的代碼結(jié)構(gòu)。員工skills就是用來解決這個“內(nèi)部知識斷裂”問題的。公司做員工skills本質(zhì)上是在做一件事把團(tuán)隊(duì)內(nèi)部的私域知識轉(zhuǎn)化為 AI 可以理解、加載、執(zhí)行的結(jié)構(gòu)化能力包。舉個例子一家公司可能在內(nèi)部做一套“Java 后端開發(fā) skills”里面包含團(tuán)隊(duì)的項(xiàng)目分層規(guī)范Controller / Service / Repository 怎么劃分。接口返回值格式統(tǒng)一 Result 包裝、錯誤碼規(guī)范。數(shù)據(jù)庫操作規(guī)范必須走 MyBatis 分頁、禁止在循環(huán)里查庫。日志規(guī)范INFO 記錄入?yún)⒊鰠?、WARN 記錄重試、ERROR 記錄異常堆棧。測試要求關(guān)鍵業(yè)務(wù)必須有單元測試覆蓋率不低于多少。一旦這套 skills 建好團(tuán)隊(duì)的 AI 編程工具就能輸出符合公司風(fēng)格的代碼而不是泛泛的“標(biāo)準(zhǔn)答案”。更進(jìn)一步公司還可以做“前端代碼審查 skills”“數(shù)據(jù)庫變更評審 skills”“生產(chǎn)環(huán)境故障排查 skills”“技術(shù)方案編寫 skills”。每一個 skills 都是對一類高頻重復(fù)工作的標(biāo)準(zhǔn)化封裝。4. 員工skills的落地從個人技能到組織能力理解了概念和動機(jī)之后下一步要解決的是員工skills到底怎么在公司落地4.1 個人技能的沉淀路徑從一個開發(fā)者的視角來看最自然的切入點(diǎn)是我把平時寫的最好的提示詞、最常用的檢查項(xiàng)、最頻繁的回歸流程設(shè)計成一個可復(fù)用的技能包。這個階段不涉及復(fù)雜的組織設(shè)計只要個人愿意花一點(diǎn)時間整理即可。典型的做法是第一步找出重復(fù)次數(shù)最多的任務(wù)。比如“幫我用 Vue3 寫一個表格組件”“幫我檢查這個頁面的響應(yīng)式布局問題”——這是每周都會出現(xiàn)的高頻請求。第二步把這個任務(wù)的完成標(biāo)準(zhǔn)拆成步驟和檢查項(xiàng)。比如寫表格組件時必須支持分頁、loading、空狀態(tài)、列寬拖動并且使用團(tuán)隊(duì)的BaseTable基類。第三步把這些步驟寫成 SKILL.md放到項(xiàng)目目錄里測試一下 AI 是否真的能按標(biāo)準(zhǔn)執(zhí)行。4.2 從個人技能到團(tuán)隊(duì)技能個人 skills 的局限在于它只在一個人的項(xiàng)目里有效。要變成團(tuán)隊(duì)能力至少要解決三個問題。第一個問題是存放位置。團(tuán)隊(duì)的 skills 不能散落在每個人的電腦里而是應(yīng)該放在統(tǒng)一的代碼倉庫中比如team-skills/所有團(tuán)隊(duì)成員共享。第二個問題是命名與分類。如果不對 skills 做統(tǒng)一管理過一段時間就會產(chǎn)生大量功能重疊、命名混亂的技能包。比如“前端審查”“code-review”“vue-check”可能做的是同一件事。第三個問題是更新維護(hù)。團(tuán)隊(duì)規(guī)范會變skills 也必須跟著變。如果沒人負(fù)責(zé)維護(hù)skills 就會慢慢變成廢棄文檔。一個有實(shí)踐價值的做法是由技術(shù)負(fù)責(zé)人或架構(gòu)師牽頭把團(tuán)隊(duì)里已經(jīng)驗(yàn)證有效的個人 skills 收斂到統(tǒng)一倉庫并指定對應(yīng)的 owner。每個 skill 都要有版本說明和更新日志就像代碼庫一樣管理。4.3 企業(yè)級 skills 的工程化如果公司的目標(biāo)是把 skills 做成真正的組織能力那就需要對 skills 做工程化治理。至少包括規(guī)范層定義 skills 目錄結(jié)構(gòu)、文案語言、觸發(fā)條件、質(zhì)量標(biāo)準(zhǔn)。倉庫層建立 skills 的統(tǒng)一代碼倉庫支持版本管理、變更評審、發(fā)布。測試層為每個 skill 設(shè)計驗(yàn)證用例確保 AI 加載后能穩(wěn)定輸出預(yù)期結(jié)果。運(yùn)營層統(tǒng)計哪些 skills 被高頻使用、哪些沒人用、哪些效果不好及時淘汰和更新。這四個層次聽起來復(fù)雜但實(shí)際落地時可以從最小集開始先做一個統(tǒng)一倉庫再定一個簡單的目錄規(guī)范最后把團(tuán)隊(duì)的 top-3 高頻任務(wù)各封裝成一個 skill。5. 核心流程拆解如何寫一個員工skills上面講了很多理念這一節(jié)進(jìn)入實(shí)操層面。我們以“前端代碼審查 skills”為例完整拆解一個員工skills的創(chuàng)建流程。5.1 定義 skill 的目標(biāo)與邊界寫一個 skill 之前首先要回答三個問題這個 skill 是什么負(fù)責(zé)哪一類任務(wù)這個 skill 不是什么它不處理哪些任務(wù)邊界是什么執(zhí)行這個 skill 后AI 應(yīng)該交付什么結(jié)果以“前端代碼審查”為例它負(fù)責(zé)審查前端代碼中的性能問題、可訪問性問題、響應(yīng)式布局問題、規(guī)范不符合問題。它不負(fù)責(zé)不審查后端邏輯、不審查數(shù)據(jù)庫設(shè)計、不替代人工走查視覺細(xì)節(jié)。交付結(jié)果一份按嚴(yán)重程度分級的審查報告包含問題描述、示例代碼、修改建議、對應(yīng)文件路徑。這一步很關(guān)鍵。如果邊界不清楚AI 會什么都往這個 skill 里塞。5.2 搭建目錄結(jié)構(gòu)根據(jù) Agent Skills 的通用結(jié)構(gòu)建議先建一個目錄frontend-code-review/ ├── SKILL.md ├── scripts/ │ └── list-files.py └── references/ └── team-frontend-rules.mdSKILL.md是主入口用于告訴 AI 這個技能是干什么的、什么時候啟用、怎么執(zhí)行。scripts/用于放可執(zhí)行的輔助腳本。references/用于放團(tuán)隊(duì)規(guī)范、代碼示例、參考文檔。5.3 編寫 SKILL.mdSKILL.md的編寫質(zhì)量直接決定整個 skill 好不好用。下面是一份示例你可以根據(jù)團(tuán)隊(duì)實(shí)際情況修改。--- name: frontend-code-review description: 按團(tuán)隊(duì)前端規(guī)范審查代碼檢查性能、可訪問性、響應(yīng)式與規(guī)范問題輸出分級審查報告。 --- # 前端代碼審查 ## 適用場景 當(dāng)用戶要求“審查這段前端代碼”“幫我做 code review”“檢查這個組件是否有性能問題”時使用本技能。 ## 不適用場景 - 用戶要求審查后端接口、數(shù)據(jù)庫邏輯、基礎(chǔ)設(shè)施配置。 - 用戶只要求解釋代碼含義不做質(zhì)量評估。 ## 執(zhí)行步驟 1. 先確認(rèn)審查范圍是單個文件還是改動文件列表。 2. 讀取涉及的代碼文件定位組件類型與核心邏輯。 3. 按“性能與渲染”“可訪問性”“響應(yīng)式與移動端”“代碼規(guī)范”四個維度逐項(xiàng)檢查。 4. 參考 references/team-frontend-rules.md 中的團(tuán)隊(duì)規(guī)范確認(rèn)是否存在不一致。 5. 輸出分級審查報告。 ## 審查重點(diǎn) ### 性能與渲染 - 列表是否使用 key且 key 是否為穩(wěn)定唯一值。 - 是否存在不必要的 setState 導(dǎo)致重復(fù)渲染。 - 圖片是否開啟懶加載。 - 大數(shù)據(jù)量場景是否使用了虛擬滾動。 ### 可訪問性 - 交互元素是否包含合適的 aria-label。 - 圖片是否提供 alt 文本。 - 是否可以在無鼠標(biāo)狀態(tài)下完成核心操作。 ### 響應(yīng)式與移動端 - 是否出現(xiàn)固定寬高導(dǎo)致的橫向滾動。 - 是否使用 rem、vw/vh 或響應(yīng)式斷點(diǎn)。 - 移動端點(diǎn)擊區(qū)域是否過小。 ### 代碼規(guī)范 - 是否存在違反團(tuán)隊(duì)命名規(guī)范的標(biāo)識符。 - 是否有 console.log 殘留。 - 是否有未使用的 import 或變量。 ## 輸出格式 按以下結(jié)構(gòu)輸出審查報告 1. 審查范圍 2. 嚴(yán)重問題必須修復(fù)說明原因與修復(fù)方式 3. 建議改進(jìn)值得優(yōu)化給出具體方案 4. 符合規(guī)范的部分簡短說明幫助開發(fā)者理解哪些寫得好 5. 修改示例對問題最嚴(yán)重的一處給出優(yōu)化前后的代碼對比這份文檔看起來很樸素但它實(shí)際是把團(tuán)隊(duì)經(jīng)驗(yàn)結(jié)構(gòu)化成了 AI 可執(zhí)行的步驟。每個審查重點(diǎn)都是一條規(guī)則AI 在審查時會逐條對照。5.3.1 SKILL.md 編寫的六個要點(diǎn)如果沒有寫過 skill第一次寫時很容易踩坑。下面是六個實(shí)戰(zhàn)中驗(yàn)證過的要點(diǎn)。第一個要點(diǎn)觸發(fā)條件要明確。SKILL.md 里的“適用場景”要寫得具體否則 AI 可能在不該啟用時亂用或者該用時不用。第二個要點(diǎn)步驟要可執(zhí)行不要寫太抽象。比如“檢查代碼質(zhì)量”太模糊“檢查是否存在不必要的 setState 導(dǎo)致重復(fù)渲染”就很具體。第三個要點(diǎn)規(guī)則要有示例。特別是團(tuán)隊(duì)自定義的規(guī)范最好附上“正確寫法”和“錯誤寫法”的代碼片段。第四個要點(diǎn)輸出格式必須定義。如果不定義輸出格式AI 每次給的報告格式都不一樣后期很難統(tǒng)計和消費(fèi)。第五個要點(diǎn)注意 token 消耗。SKILL.md 會被 AI 加載進(jìn)上下文太冗長會浪費(fèi)上下文窗口。所以能用列表表達(dá)的就不要寫長篇論述。第六個要點(diǎn)定期版本化。SKILL.md 一旦穩(wěn)定就給它打一個版本號。后續(xù)團(tuán)隊(duì)規(guī)范變化時可以對比差異并更新。5.4 創(chuàng)建輔助腳本不是所有的 skill 都需要腳本但如果技能涉及文件掃描、數(shù)據(jù)統(tǒng)計、格式校驗(yàn)?zāi)_本可以讓 AI 的執(zhí)行更穩(wěn)定。以下是一個簡單的 Python 腳本用于從項(xiàng)目中提取待審查的前端文件列表#!/usr/bin/env python3 # 文件路徑frontend-code-review/scripts/list-files.py # 功能掃描項(xiàng)目中的前端源碼文件列出待審查文件。 import os import sys EXCLUDE_DIRS {node_modules, dist, build, .git, .next} FRONT_END_EXTS {.vue, .tsx, .jsx, .ts, .js, .css, .scss, .less} def main(): root sys.argv[1] if len(sys.argv) 1 else . files [] for dirpath, dirnames, filenames in os.walk(root): dirnames[:] [d for d in dirnames if d not in EXCLUDE_DIRS] for f in filenames: if os.path.splitext(f)[1] in FRONT_END_EXTS: files.append(os.path.join(dirpath, f)) files.sort() for file in files: print(file) if __name__ __main__: main()這個腳本本身沒什么難度但它在 skill 中的價值是讓 AI 不依賴自己猜測文件路徑直接拿到準(zhǔn)確的文件清單。引用方式很簡單在 SKILL.md 的執(zhí)行步驟中寫明如果需要審查整個項(xiàng)目中的前端文件先運(yùn)行以下命令獲取文件清單 bash python3 scripts/list-files.py .然后對清單中的文件進(jìn)行逐項(xiàng)審查。### 5.5 加入團(tuán)隊(duì)規(guī)范文檔 references/team-frontend-rules.md 是團(tuán)隊(duì)知識的集中體現(xiàn)。這一部分無需從零編寫可以直接把團(tuán)隊(duì)已有的前端規(guī)范、代碼評審 checklist、常見問題列表整理進(jìn)去。 markdown # 團(tuán)隊(duì)前端規(guī)范摘要 ## 命名規(guī)范 - 組件文件名PascalCase如 UserProfile.vue - 普通工具函數(shù)camelCase如 formatDateTime.ts - CSS 類名BEM 風(fēng)格如 block__element--modifier ## 組件規(guī)范 - 通用表格必須使用 BaseTable 組件 - 表單必須支持 Enter 鍵提交 - 圖片必須指定寬高避免布局偏移 ## 禁止項(xiàng) - 禁止在 render 函數(shù)中直接 new Date()除非有明確更新需求 - 禁止在循環(huán)中使用 await 發(fā)起串行請求 - 禁止在組件卸載后更新狀態(tài) ## 常見性能問題 - 大列表未開啟虛擬滾動 - 父子組件未使用 memo / computed 導(dǎo)致無效渲染 - 動態(tài) import 未做 Suspense 邊界處理建議一開始不要追求大而全先聚焦團(tuán)隊(duì)最容易出問題的 5 到 10 條規(guī)則后續(xù)再逐步擴(kuò)充。6. 完整示例構(gòu)建一個“員工skills”并安裝到 AI 編程工具為了讓文章更落地這里給出一個從零到一的最小完整示例。我們會創(chuàng)建一個小型的“新員工入職指引 skills”目標(biāo)是讓 AI 能夠根據(jù)它回答新員工關(guān)于公司開發(fā)環(huán)境、代碼倉庫、提交流程的問題。6.1 創(chuàng)建目錄與文件第一步建立目錄結(jié)構(gòu)mkdir -p team-onboarding-skill/scripts cd team-onboarding-skill第二步創(chuàng)建SKILL.md--- name: team-onboarding description: 回答新員工入職相關(guān)問題包括開發(fā)環(huán)境搭建、代碼倉庫地址、分支規(guī)范、提交流程、常見命令。 --- # 新員工入職指引 ## 適用場景 當(dāng)用戶詢問以下問題時啟用本技能 - “公司代碼倉庫在哪里” - “如何配置開發(fā)環(huán)境” - “提交代碼的流程是什么” - “有哪些開發(fā)規(guī)范需要遵守” ## 執(zhí)行步驟 1. 先判斷用戶所在小組和項(xiàng)目類型。 2. 根據(jù)問題類型查閱 references 目錄中的對應(yīng)文檔。 3. 如果文檔中缺少信息明確告知用戶“該信息未在團(tuán)隊(duì)知識庫中收錄請咨詢對應(yīng)項(xiàng)目負(fù)責(zé)人”不要編造。 4. 回答時盡量給出可復(fù)制的命令或操作步驟。 ## 回答要求 - 所有命令必須給出完整命令并注明在哪個目錄下執(zhí)行。 - 涉及敏感信息密碼、Token時提示用戶走公司內(nèi)部安全通道獲取禁止出現(xiàn)在回答中。 - 如果問題涉及賬號權(quán)限引導(dǎo)用戶走權(quán)限申請流程不要嘗試?yán)@過權(quán)限系統(tǒng)。第三步創(chuàng)建references/development-setup.md放開發(fā)環(huán)境配置信息# 開發(fā)環(huán)境搭建 ## 前端項(xiàng)目 依賴節(jié)點(diǎn)版本 20使用 pnpm 作為包管理器。 bash nvm use 20 pnpm install pnpm dev后端項(xiàng)目依賴 JDK 21使用 Maven 構(gòu)建。mvn clean install mvn spring-boot:run環(huán)境變量本地開發(fā)需要配置以下環(huán)境變量API_BASE_URL本地 API 地址APP_ENV設(shè)為devLOG_LEVEL設(shè)為debug第四步創(chuàng)建 references/git-workflow.md markdown # Git 提交流程 ## 分支命名 - 功能分支feature/xxx - 修復(fù)分支fix/xxx - 發(fā)布分支release/xxx ## 提交信息 提交信息必須包含 Jira 單號例如 text [PROJ-123] 完成用戶列表功能合并規(guī)范功能開發(fā)完成后通過 Merge Request 合并到 develop 分支至少 1 人審批。### 6.2 把 skill 安裝到 Claude Code 目前各類 AI 編程工具對 skills 的支持方式大同小異把 skill 目錄放在一個約定的位置AI 就能發(fā)現(xiàn)并加載它。 在 Claude Code 中社區(qū)的常見做法是將 skills 放在項(xiàng)目根目錄的 .claude/skills/ 下或者用戶級目錄的 ~/.claude/skills/ 下。以剛才創(chuàng)建的 onboarding skill 為例 bash # 假設(shè)你的項(xiàng)目在 ~/work/my-project mkdir -p ~/work/my-project/.claude/skills cp -r team-onboarding-skill ~/work/my-project/.claude/skills/安裝完成后你在 Claude Code 對話中輸入“如何開發(fā)環(huán)境搭起來”或者“我們項(xiàng)目的分支規(guī)范是什么”AI 就有機(jī)會加載這個 skill按照里面的規(guī)則回答。6.3 把 skill 安裝到 Codex在 OpenAI Codex 中社區(qū)實(shí)踐是使用AGENTS.md配合 skills 目錄的方式。你可以把 skill 放到項(xiàng)目倉庫的skills/目錄下并在說明文檔中引用。更通用的做法是不管工具怎么變化你只需要保證兩點(diǎn)——第一skill 目錄存在于項(xiàng)目倉庫中第二目錄里有一個 AI 能讀取到的主文件SKILL.md 或類似命名。下面是在 Codex CLI 項(xiàng)目中使用 skill 的示意mkdir -p ~/work/my-project/skills cp -r team-onboarding-skill ~/work/my-project/skills/然后在項(xiàng)目根目錄的AGENTS.md中增加一行團(tuán)隊(duì)技能包位于 skills/ 目錄遇到與對應(yīng)技能相關(guān)的問題時請先讀取相關(guān) SKILL.md。6.4 安裝到 Cursor 和 OpenCodeCursor 類 IDE 中skills 的加載通常有兩種實(shí)現(xiàn)方式一種是借助.cursor/rules或項(xiàng)目配置文件把技能內(nèi)容注入上下文另一種是把 skill 作為項(xiàng)目文件由 AI 通過文件讀取能力加載。如果你使用的是 OpenCode社區(qū)的做法是把 skill 放在項(xiàng)目內(nèi)統(tǒng)一的目錄然后通過配置讓 AI 知道這個目錄的存在。以 OpenCode 為例可以在項(xiàng)目的配置說明中寫清楚# OpenCode 項(xiàng)目配置 skills 目錄./skills 規(guī)則遇到與本項(xiàng)目技能包相關(guān)的任務(wù)時必須先查看對應(yīng)目錄下的 SKILL.md 再回答。這種“配置聲明 文檔說明”的方式雖然不是某個工具的官方標(biāo)準(zhǔn)格式但在目前 skills 生態(tài)尚未完全統(tǒng)一的情況下是兼容性最高、最容易上手的做法。7. 運(yùn)行結(jié)果與效果驗(yàn)證寫完 skill 并安裝到工具之后不能直接宣布完成。你需要驗(yàn)證兩件事第一AI 能不能正確發(fā)現(xiàn)和加載這個 skill第二AI 執(zhí)行 skill 的結(jié)果是否符合預(yù)期。7.1 驗(yàn)證 AI 是否正確加載了 skill最簡單的方法是用一個觸發(fā)問題去測試。比如你剛安裝了 onboarding skill在會話中提問請先查看團(tuán)隊(duì)技能包中是否有新員工入職相關(guān)的技能如果有請按照其規(guī)則回答我的前端項(xiàng)目如何啟動如果 AI 加載成功它的回答應(yīng)該包含SKILL.md中定義的步驟和 references 中提到的具體命令而不是給出一段泛泛的答非所問。還可以在提問中直接要求請告訴我你在處理這個問題時使用了哪個技能包它的主要規(guī)則是什么通過這種元問題你可以確認(rèn) AI 是否真的讀取了你的 SKILL.md。7.2 判斷輸出質(zhì)量驗(yàn)證輸出質(zhì)量時不要只看 AI 有沒有“提到”你的規(guī)則要看它是否完整執(zhí)行了你給出的流程。以“前端代碼審查 skills”為例理想的輸出應(yīng)該包含 SKILL.md 中規(guī)定的五個部分審查范圍、嚴(yán)重問題、建議改進(jìn)、符合規(guī)范部分、修改示例。如果 AI 只返回了一句“代碼看起來不錯但有一些小問題”說明它沒有嚴(yán)格按 skill 執(zhí)行需要檢查 SKILL.md 的指令是否足夠明確或者觸發(fā)條件是否匹配。如果運(yùn)行失敗排查順序如下第一步檢查 skill 目錄是否真的放在了工具查找的位置。很多情況下AI 沒有加載 skill 只是因?yàn)槟夸浄佩e了。第二步檢查 SKILL.md 的 frontmatter 中的 name 和 description 是否準(zhǔn)確。description 是 AI 判斷“何時使用該技能”的關(guān)鍵信號如果寫得模糊AI 可能不知道該調(diào)用它。第三步檢查 SKILL.md 中的執(zhí)行步驟是否具體是否有 AI 無法執(zhí)行的動作。第四步檢查 references 文件是否被正確引用。如果 SKILL.md 中寫了讀取某個文件但實(shí)際目錄里沒有這個文件AI 可能只按 SKILL.md 的通用內(nèi)容回答。8. 員工skills常見問題與排查方法這里合并了個人開發(fā)者和團(tuán)隊(duì)管理者最常遇到的問題整理成一張排查表。問題現(xiàn)象可能原因排查方式解決方案AI 沒有加載 skill仍然按普通方式回答skill 目錄位置不在工具搜索路徑內(nèi)確認(rèn)目錄是否放在.claude/skills、skills等約定位置移動到正確目錄或檢查項(xiàng)目的配置文件AI 加載了 skill但完全不按 SKILL.md 執(zhí)行SKILL.md 中的步驟不具體AI 無法理解查看 SKILL.md 是否給出可執(zhí)行動作和輸出格式將步驟拆細(xì)加入明確的輸出結(jié)構(gòu)要求輸出結(jié)果時好時壞不穩(wěn)定提示詞依賴太多規(guī)則沒有被確定性執(zhí)行把關(guān)鍵規(guī)則改為必須執(zhí)行的 list 形式將“必須檢查項(xiàng)”和“可選檢查項(xiàng)”分開skill 內(nèi)容太多上下文被消耗過大SKILL.md 和 references 文件過于冗長檢查 skill 目錄大小和文檔篇幅精簡文檔把次要內(nèi)容折疊到 references 中按需引用團(tuán)隊(duì)多人維護(hù)skill 內(nèi)容混亂缺乏命名規(guī)范、目錄結(jié)構(gòu)不統(tǒng)一查看是否存在多個功能重疊的 skill建立統(tǒng)一規(guī)范指定唯一 owner技能更新后AI 仍使用舊邏輯AI 會話緩存導(dǎo)致的舊上下文查看會話上下文和工具進(jìn)程版本重啟會話確認(rèn)重新加載最新 skill 文件技能涉及數(shù)據(jù)操作時AI 誤刪數(shù)據(jù)腳本沒有權(quán)限保護(hù)AI 直接執(zhí)行危險命令檢查 skill 中是否包含刪除類指令腳本中增加確認(rèn)機(jī)制和最小權(quán)限原則需要特別強(qiáng)調(diào)一點(diǎn)如果團(tuán)隊(duì)把 skills 用于生產(chǎn)環(huán)境、數(shù)據(jù)庫操作或權(quán)限相關(guān)場景務(wù)必在 SKILL.md 中明確寫入“執(zhí)行危險操作前必須向用戶確認(rèn)”的規(guī)則。skills 不會主動降低安全性安全邊界由編寫者自己負(fù)責(zé)。9. 員工skills落地的最佳實(shí)踐如果你們公司或團(tuán)隊(duì)準(zhǔn)備開始做員工skills下面幾個實(shí)踐建議可以參考。9.1 從高頻痛點(diǎn)起步不要一開始就試圖建立龐大的技能庫。先找 3 到 5 個團(tuán)隊(duì)最高頻、最耗時的任務(wù)把它們做成 skills實(shí)際用起來再慢慢擴(kuò)展。高頻任務(wù)通常有幾個特征重復(fù)發(fā)生、規(guī)則明確、完成后有明確產(chǎn)物。代碼審查、接口文檔生成、技術(shù)方案編寫、測試用例生成、發(fā)布檢查清單都是很好的起點(diǎn)。9.2 統(tǒng)一命名與目錄規(guī)范在團(tuán)隊(duì)倉庫中約定一套規(guī)范比如skills 放在skills/或.claude/skills/目錄。每個 skill 一個目錄目錄名用中劃線連接比如frontend-code-review。每個 skill 必須有 SKILL.md且 frontmatter 中的 name 和 description 必須寫清楚。references 中只放必要文檔不放入與技能無關(guān)的資料。9.3 Skill 的維護(hù)比創(chuàng)建更重要一個沒有人維護(hù)的 skill半年后會變成一文不值的歷史包袱。建議團(tuán)隊(duì)指定每個 skill 的 owner并建立季度審查機(jī)制定期檢查這些規(guī)則還符合當(dāng)前團(tuán)隊(duì)規(guī)范嗎這個 skill 還有人用嗎有沒有更好的腳本或工具可以替換9.4 安全與權(quán)限邊界skills 本質(zhì)上是代碼團(tuán)隊(duì)?wèi)?yīng)該在代碼審查時同步審查 skills 的腳本內(nèi)容尤其是涉及文件刪除、數(shù)據(jù)修改、外部請求的腳本。建議在 SKILL.md 中增加安全約束并在腳本層面遵循最小權(quán)限原則。生產(chǎn)環(huán)境操作類的 skill必須要求人工二次確認(rèn)。9.5 先學(xué)習(xí)再復(fù)用對企業(yè)里最典型的場景建議先收集老員工在真實(shí)項(xiàng)目中如何操作再把這些經(jīng)驗(yàn)轉(zhuǎn)化為 skill 的規(guī)則。這種方式沉淀出來的 skill 通常比 AI 自己生成的通用技能有價值得多因?yàn)樗藞F(tuán)隊(duì)特有的知識和約束。10. 員工skills的設(shè)計誤區(qū)最后再來看看員工skills最容易被誤解的幾個點(diǎn)。理解這些誤區(qū)能幫你少走彎路。第一個誤區(qū)把 skill 當(dāng)成提示詞收藏夾。有些人把平時積累的提示詞統(tǒng)一封裝成 skill結(jié)果發(fā)現(xiàn) AI 的行為沒有本質(zhì)變化。原因在于skill 的價值不在于“存了一段提示詞”而在于它提供了完整的決策流程和執(zhí)行標(biāo)準(zhǔn)包括觸發(fā)條件、步驟、輸出格式、參考資料。第二個誤區(qū)追求大而全的 superpower 式技能包。社區(qū)里流行的 superpower skills 確實(shí)功能豐富但團(tuán)隊(duì)落地時不要照搬這種方案。因?yàn)樵酱蟮募寄馨诫y維護(hù)越難驗(yàn)證。企業(yè)內(nèi)部的 skill 應(yīng)該小而專只做一件事并做好這一件事。第三個誤區(qū)期望 AI 100% 執(zhí)行 skill 規(guī)則。即使寫了 SKILL.mdAI 仍然是大模型可能在某些情況下產(chǎn)生偏差。所以重要的技能需要設(shè)計驗(yàn)證用例定期抽檢輸出質(zhì)量而不是寫完就放手。第四個誤區(qū)忽略 skill 的上下文成本。每次調(diào)用 skill 都會消耗 token。如果一個技能加載了巨量參考文檔會拖慢響應(yīng)速度也會降低模型對關(guān)鍵規(guī)則的注意力。精簡是 skill 設(shè)計的長期原則。第五個誤區(qū)把員工skills當(dāng)成純技術(shù)任務(wù)來做。員工skills的難點(diǎn)不在寫代碼而在把隱形知識顯性化。這需要技術(shù)負(fù)責(zé)人、資深工程師、AI 工程化人員一起參與而不是把它丟給一個人去“開發(fā)”就結(jié)束了。11. 對開發(fā)者的行動建議如果你是一名開發(fā)者看完這篇文章后可以按下面的路徑開始實(shí)踐。第一步在本地建一個skills目錄選一個自己重復(fù)遇到三次以上的任務(wù)照著 SKILL.md 格式寫一個最小可用的技能包。第二步把它安裝到你目前使用的 AI 編程工具中跑通一個從觸發(fā)到輸出的完整流程。第三步驗(yàn)證輸出質(zhì)量調(diào)整 SKILL.md 的步驟和規(guī)則直到結(jié)果穩(wěn)定。第四步把技能包提交到團(tuán)隊(duì)的代碼倉庫并邀請同事試用。第五步收集反饋優(yōu)化細(xì)節(jié)然后基于同樣流程開發(fā)第二個、第三個技能包。對于技術(shù)負(fù)責(zé)人或架構(gòu)師行動建議則是第一步盤點(diǎn)團(tuán)隊(duì)重復(fù)性最高的 5 類任務(wù)明確每個任務(wù)的已有規(guī)范和完成標(biāo)準(zhǔn)。第二步定一個簡單的 skills 倉庫規(guī)范先保證命名統(tǒng)一、目錄統(tǒng)一、owner 明確。第三步從任務(wù)清單中挑一個最有把握的做成第一個員工skills設(shè)置驗(yàn)證用例。第四步復(fù)盤效果看它是否真的提高了團(tuán)隊(duì)的效率或一致性再決定要不要繼續(xù)投入。員工skills還處于早期它不會是 AI 工具的最終形態(tài)但它代表了一個明確的方向知識經(jīng)驗(yàn)不再只是給人看的文檔而是可執(zhí)行、可復(fù)用、可驗(yàn)證的 AI 能力單元。提前把這條路跑通的公司在 AI 落地上的效率差距會越來越大。希望這篇文章能給你一個清晰的起點(diǎn)。如果你的團(tuán)隊(duì)也在嘗試做員工skills可以沿著上面的示例先做一個最小閉環(huán)試試看。實(shí)踐之后你大概率會發(fā)現(xiàn)真正讓 skill 發(fā)揮價值的不是格式和工具而是你把自己團(tuán)隊(duì)做事的標(biāo)準(zhǔn)想明白了多少。