1. 從skills這個(gè)模糊詞說(shuō)起它到底指什么第一次看到skills這個(gè)標(biāo)題加上一堆熱搜詞里混著 Agent Skills、Google Cloud、GKE、Genkit、codex skills、claude agent skills我腦子里第一反應(yīng)是這詞太泛了。但把熱搜詞串起來(lái)看方向其實(shí)很清晰——這里的 skills 不是指人類技能而是指 AI Agent 生態(tài)里那套可插拔能力包機(jī)制。說(shuō)白了skills 就是給 AI 助手Agent裝的一個(gè)個(gè)技能模塊。你可以把它理解成手機(jī)上的 AppAgent 本身是操作系統(tǒng)skills 就是一個(gè)個(gè)裝上去就能干具體活的應(yīng)用。裝一個(gè)寫論文的 skillAgent 就會(huì)按學(xué)術(shù)規(guī)范幫你組織文獻(xiàn)、搭結(jié)構(gòu)裝一個(gè)分鏡的 skill它就能按鏡頭語(yǔ)言拆解腳本裝一個(gè)代碼審計(jì)的 skill它就知道該從哪些角度去找漏洞。這個(gè)機(jī)制為什么這兩年突然火核心原因是大模型的能力邊界在通用和專用之間反復(fù)橫跳。通用模型什么都懂一點(diǎn)但真到具體任務(wù)上往往不如一個(gè)被精心約束過(guò)流程的專用配置。skills 就是那個(gè)約束層——它把提示詞、工具調(diào)用、執(zhí)行步驟、輸出格式打包成一個(gè)可復(fù)用的單元讓 Agent 在特定任務(wù)上表現(xiàn)得像換了個(gè)人。熱搜里出現(xiàn)的 Google Cloud、GKE、Genkit 這幾個(gè)詞說(shuō)明 skills 已經(jīng)不只是本地玩票而是往云原生、往生產(chǎn)環(huán)境走了。GKE 是 Google 的 Kubernetes 托管服務(wù)Genkit 是 Google 出的 AI 應(yīng)用開(kāi)發(fā)框架這倆湊一起意味著 skills 可以被部署成集群里的服務(wù)被多個(gè) Agent 共享調(diào)用。這是從個(gè)人玩具到團(tuán)隊(duì)基礎(chǔ)設(shè)施的關(guān)鍵一步。至于 codex skills、claude agent skills 這些指的是不同 Agent 平臺(tái)各自的 skills 規(guī)范。它們格式不完全一樣但設(shè)計(jì)哲學(xué)相通聲明式描述 可執(zhí)行邏輯 明確邊界。你告訴系統(tǒng)這個(gè) skill 叫什么、什么時(shí)候用、怎么用、輸出什么系統(tǒng)在合適的時(shí)候自動(dòng)掛載它。所以這篇內(nèi)容我打算這么聊先把 skills 的本質(zhì)和它解決的問(wèn)題講透再拆解一個(gè) skill 從設(shè)計(jì)到落地的完整鏈路然后重點(diǎn)講實(shí)際開(kāi)發(fā)中最容易踩的坑最后聊聊它在云上GKE Genkit 這條線怎么跑起來(lái)。適合誰(shuí)看如果你正在做 Agent 相關(guān)的東西或者想給自己常用的 AI 工具加定制能力又或者單純好奇skills 到底是不是又一個(gè)概念泡沫這篇應(yīng)該能給你一些實(shí)在的參考。2. skills 的本質(zhì)把提示詞工程升級(jí)成能力工程2.1 為什么光靠提示詞不夠用很多人一開(kāi)始接觸 Agent都是靠一段長(zhǎng)長(zhǎng)的系統(tǒng)提示詞搞定一切。我早期也這么干寫個(gè)兩三千字的 prompt把角色、規(guī)則、輸出格式全塞進(jìn)去。剛開(kāi)始挺爽但任務(wù)一復(fù)雜就崩。問(wèn)題出在哪提示詞是軟約束它沒(méi)有結(jié)構(gòu)沒(méi)有邊界也沒(méi)有復(fù)用機(jī)制。你寫了一段幫我審代碼的提示詞下次想審另一種語(yǔ)言的代碼要么改提示詞要么重寫。更麻煩的是當(dāng) Agent 需要調(diào)用外部工具時(shí)提示詞里描述的工具用法和實(shí)際工具定義容易對(duì)不上模型就開(kāi)始瞎編參數(shù)。skills 的出現(xiàn)本質(zhì)是把這種一坨提示詞拆成了有結(jié)構(gòu)的模塊。一個(gè) skill 通常包含幾個(gè)固定部分元信息名字、描述、適用場(chǎng)景。這是給 Agent 的路由依據(jù)決定什么時(shí)候該掛載這個(gè) skill。指令體具體怎么做步驟是什么有哪些約束。工具聲明這個(gè) skill 需要調(diào)用哪些外部能力參數(shù) schema 是什么。輸出規(guī)范結(jié)果長(zhǎng)什么樣是 JSON 還是 Markdown字段有哪些。這么一拆好處立刻顯現(xiàn)。Agent 在接到任務(wù)時(shí)先根據(jù)元信息匹配 skill匹配上了再加載指令體和工具執(zhí)行完按輸出規(guī)范返回。整個(gè)過(guò)程是可預(yù)測(cè)、可測(cè)試、可復(fù)用的。2.2 skills 和傳統(tǒng)插件、函數(shù)調(diào)用的區(qū)別有人會(huì)問(wèn)這不就是函數(shù)調(diào)用function calling換了個(gè)名字嗎不完全是。函數(shù)調(diào)用解決的是模型怎么調(diào)一個(gè)具體接口的問(wèn)題它是單次、原子的。skills 解決的是模型怎么完成一類任務(wù)的問(wèn)題它是流程化、組合式的。一個(gè) skill 內(nèi)部可能調(diào)用好幾個(gè)函數(shù)中間還有判斷、循環(huán)、格式轉(zhuǎn)換。打個(gè)比方函數(shù)調(diào)用像是給你一把螺絲刀skills 像是給你一套裝宜家柜子的完整流程——先看圖紙、再分類零件、按順序擰螺絲、最后檢查穩(wěn)定性。螺絲刀只是其中一環(huán)。熱搜里agent tool agent skills這個(gè)詞組很能說(shuō)明問(wèn)題tool 是工具skill 是用工具的方法論。兩者是不同層級(jí)的東西。2.3 一個(gè) skill 的最小可用結(jié)構(gòu)為了后面講實(shí)操方便這里先給一個(gè)通用的 skill 結(jié)構(gòu)示意。不同平臺(tái)字段名不一樣但骨架大同小異name: code-review description: 對(duì)指定代碼文件進(jìn)行靜態(tài)審查輸出問(wèn)題清單和修復(fù)建議 when_to_use: 當(dāng)用戶要求審查代碼、找 bug、檢查代碼規(guī)范時(shí) steps: - 讀取目標(biāo)文件內(nèi)容 - 按語(yǔ)言規(guī)則檢查常見(jiàn)問(wèn)題空指針、邊界、資源泄漏 - 按嚴(yán)重程度分級(jí) - 生成結(jié)構(gòu)化報(bào)告 tools: - read_file - run_linter output: format: markdown sections: [問(wèn)題列表, 嚴(yán)重程度, 修復(fù)建議]這個(gè)結(jié)構(gòu)里description 和 when_to_use 是最關(guān)鍵的兩個(gè)字段。它們直接決定 Agent 能不能在正確的時(shí)機(jī)掛載這個(gè) skill。我見(jiàn)過(guò)太多人把這兩個(gè)字段寫得含糊其辭結(jié)果 skill 要么從不被觸發(fā)要么在不該觸發(fā)的時(shí)候亂觸發(fā)。2.4 為什么現(xiàn)在值得投入學(xué) skills一個(gè)現(xiàn)實(shí)判斷Agent 的競(jìng)爭(zhēng)已經(jīng)從模型多強(qiáng)轉(zhuǎn)向能力多全。模型本身大家用的都差不多差距在于誰(shuí)能把具體任務(wù)打磨得更順。skills 就是打磨的載體。而且 skills 有個(gè)隱性價(jià)值它是團(tuán)隊(duì)知識(shí)的沉淀方式。你們團(tuán)隊(duì)踩過(guò)的坑、總結(jié)的最佳實(shí)踐寫成文檔沒(méi)人看寫成 skill 卻能被 Agent 自動(dòng)執(zhí)行。這是把人腦里的經(jīng)驗(yàn)變成系統(tǒng)里的能力的過(guò)程。熱搜里今天學(xué)會(huì)了skills打開(kāi)新世界這種表達(dá)我理解那種感覺(jué)——當(dāng)你第一次看到自己寫的 skill 被 Agent 準(zhǔn)確調(diào)用并完成任務(wù)時(shí)確實(shí)會(huì)有種原來(lái)可以這樣的頓悟。3. 從零設(shè)計(jì)一個(gè) skill我踩過(guò)的坑和驗(yàn)證過(guò)的流程3.1 先想清楚這個(gè) skill 的邊界在哪設(shè)計(jì) skill 最容易犯的錯(cuò)是貪大求全。我第一個(gè) skill 想做一個(gè)全能寫作助手結(jié)果描述寫得又長(zhǎng)又泛Agent 根本不知道該在什么時(shí)候用它用起來(lái)也是東一榔頭西一棒子。后來(lái)我改了個(gè)思路一個(gè) skill 只干一件事而且這件事要能用一句話說(shuō)清楚。比如把會(huì)議記錄整理成待辦清單、給一段 SQL 做性能分析、把技術(shù)文檔翻譯成面向小白的版本。邊界越清晰Agent 匹配越準(zhǔn)執(zhí)行越穩(wěn)。判斷邊界是否清晰有個(gè)簡(jiǎn)單測(cè)試你能不能給這個(gè) skill 寫出三個(gè)不該用它的場(chǎng)景。如果寫不出來(lái)說(shuō)明邊界還是模糊的。3.2 描述字段的寫法給 Agent 看的廣告文案description 和 when_to_use 這兩個(gè)字段本質(zhì)是寫給 Agent 的廣告。Agent 在決定掛載哪個(gè) skill 時(shí)就是靠這些文字做語(yǔ)義匹配。所以寫法要遵循幾個(gè)原則用動(dòng)詞開(kāi)頭明確動(dòng)作。比如審查代碼比代碼審查相關(guān)好。包含觸發(fā)關(guān)鍵詞。用戶可能說(shuō)幫我看看這段代碼有沒(méi)有問(wèn)題也可能說(shuō)review 一下描述里要覆蓋這些說(shuō)法。說(shuō)明輸出物。Agent 知道會(huì)產(chǎn)出什么更容易判斷是否匹配。避免歧義詞。處理、優(yōu)化這種詞太泛盡量換成具體動(dòng)作。我實(shí)測(cè)下來(lái)描述里帶上 2-3 個(gè)典型用戶說(shuō)法匹配準(zhǔn)確率會(huì)明顯提升。比如description: 審查代碼并找出潛在問(wèn)題。適用于用戶說(shuō)幫我看看這段代碼、review 一下、有沒(méi)有 bug、代碼規(guī)范檢查等場(chǎng)景。輸出問(wèn)題清單和修復(fù)建議。3.3 指令體的顆粒度太粗會(huì)飄太細(xì)會(huì)死指令體是 skill 的核心寫多細(xì)是個(gè)技術(shù)活。寫太粗比如檢查代碼質(zhì)量Agent 就自由發(fā)揮了每次結(jié)果都不一樣。寫太細(xì)比如把每一行判斷邏輯都寫死skill 就失去了靈活性遇到稍微不同的情況就卡住。我的經(jīng)驗(yàn)是流程寫細(xì)判斷留活。也就是說(shuō)步驟要明確先讀文件、再檢查、再分級(jí)、再輸出但每一步內(nèi)部的判斷標(biāo)準(zhǔn)可以給原則而不是死規(guī)則。比如按嚴(yán)重程度分級(jí)這一步我會(huì)說(shuō)明導(dǎo)致崩潰的算高、影響性能的算中、風(fēng)格問(wèn)題算低但不寫死具體規(guī)則讓模型根據(jù)上下文判斷。3.4 工具聲明的坑schema 對(duì)不上是最常見(jiàn)的失敗原因skill 要調(diào)用外部工具時(shí)工具聲明的 schema 必須和實(shí)際工具定義嚴(yán)格一致。我踩過(guò)最典型的坑是skill 里寫參數(shù)叫file_path實(shí)際工具定義里叫path結(jié)果 Agent 調(diào)用時(shí)一直報(bào)參數(shù)錯(cuò)誤排查了半天才發(fā)現(xiàn)是命名不一致。還有個(gè)坑是必填參數(shù)沒(méi)標(biāo)清楚。如果某個(gè)參數(shù)是必填的但 schema 里沒(méi)標(biāo) requiredAgent 可能就不傳然后工具執(zhí)行失敗。反過(guò)來(lái)如果標(biāo)了 required 但實(shí)際可以不傳Agent 又會(huì)強(qiáng)行編一個(gè)值出來(lái)。建議做法工具聲明直接從工具的實(shí)際定義里復(fù)制不要手寫。如果平臺(tái)支持自動(dòng)生成 schema一定用自動(dòng)生成。3.5 輸出規(guī)范結(jié)構(gòu)化是穩(wěn)定性的保障輸出規(guī)范決定了 skill 的結(jié)果能不能被下游消費(fèi)。如果只是給人看Markdown 就夠了如果要被其他程序處理就必須用 JSON 之類的結(jié)構(gòu)化格式。我一般會(huì)要求輸出包含這幾個(gè)部分結(jié)論、依據(jù)、置信度、后續(xù)建議。結(jié)論是直接答案依據(jù)是推理過(guò)程置信度讓調(diào)用方知道這個(gè)結(jié)果有多可靠后續(xù)建議是可選動(dòng)作。這套結(jié)構(gòu)在大多數(shù)場(chǎng)景下都?jí)蛴谩Ｓ袀€(gè)細(xì)節(jié)輸出里不要包含我認(rèn)為、可能這類模糊詞除非確實(shí)不確定。Agent 的輸出會(huì)被下游當(dāng)事實(shí)用模糊詞會(huì)污染整個(gè)鏈路。4. 實(shí)測(cè)中最容易翻車的幾個(gè)場(chǎng)景4.1 skill 沖突兩個(gè) skill 搶同一個(gè)任務(wù)當(dāng)你有多個(gè) skill且它們的適用場(chǎng)景有重疊時(shí)Agent 可能選錯(cuò)。我遇到過(guò)代碼審查和代碼優(yōu)化兩個(gè) skill用戶說(shuō)幫我改改這段代碼Agent 有時(shí)掛審查、有時(shí)掛優(yōu)化結(jié)果完全不一樣。解決辦法有兩個(gè)一是在描述里明確區(qū)分審查側(cè)重找問(wèn)題優(yōu)化側(cè)重改代碼二是設(shè)置優(yōu)先級(jí)如果平臺(tái)支持給更專用的 skill 更高優(yōu)先級(jí)。4.2 上下文超限skill 加載太多把窗口撐爆每個(gè) skill 的指令體都要占上下文。如果一次掛載了五六個(gè) skill加上對(duì)話歷史很容易超出模型窗口。表現(xiàn)就是 Agent 開(kāi)始忘事前面說(shuō)的規(guī)則后面就不遵守了。我的做法是控制同時(shí)掛載的 skill 數(shù)量一般不超過(guò) 3 個(gè)。如果任務(wù)確實(shí)需要多個(gè) skill 協(xié)作就分步執(zhí)行而不是一次性全掛上。4.3 工具調(diào)用失敗后的重試邏輯skill 調(diào)用外部工具時(shí)失敗是常態(tài)。網(wǎng)絡(luò)抖動(dòng)、參數(shù)錯(cuò)誤、權(quán)限不足都可能讓工具調(diào)用掛掉。如果 skill 里沒(méi)寫重試邏輯Agent 可能就直接報(bào)錯(cuò)了。建議在指令體里明確工具調(diào)用失敗時(shí)先檢查參數(shù)再重試一次還失敗就返回錯(cuò)誤信息而不是瞎編結(jié)果。這個(gè)約束能避免很多Agent 編造工具返回的問(wèn)題。4.4 輸出格式漂移說(shuō)好 JSON 卻返回 Markdown即使你在輸出規(guī)范里寫了要 JSON模型有時(shí)還是會(huì)返回 Markdown。原因是模型在生成時(shí)覺(jué)得Markdown 更自然。對(duì)抗這個(gè)問(wèn)題的辦法是在指令體里也強(qiáng)調(diào)格式并且給一個(gè)具體的輸出示例。示例比規(guī)范更有效模型會(huì)模仿示例的格式。4.5 跨平臺(tái)兼容同一個(gè) skill 換個(gè)平臺(tái)就跑不起來(lái)不同 Agent 平臺(tái)的 skill 規(guī)范不一樣。字段名、工具聲明方式、輸出約束機(jī)制都有差異。我試過(guò)把一個(gè)平臺(tái)的 skill 直接搬到另一個(gè)平臺(tái)結(jié)果一半字段不認(rèn)。如果要做跨平臺(tái)建議把 skill 的核心邏輯指令體和平臺(tái)適配層分開(kāi)。核心邏輯用自然語(yǔ)言寫平臺(tái)相關(guān)的部分工具聲明、元信息格式單獨(dú)維護(hù)。這樣遷移時(shí)只需要改適配層。5. 把 skills 跑在云上GKE Genkit 這條線的實(shí)際考量5.1 為什么要把 skill 部署成服務(wù)本地跑 skill 適合個(gè)人玩但團(tuán)隊(duì)用就有問(wèn)題每個(gè)人的環(huán)境不一樣skill 版本不一致更新要挨個(gè)通知。把 skill 部署成云上服務(wù)就能做到統(tǒng)一版本、集中管理、按需調(diào)用。熱搜里出現(xiàn) GKE 和 Genkit說(shuō)明這條路已經(jīng)有人在走了。GKE 提供容器編排Genkit 提供 AI 應(yīng)用框架兩者結(jié)合可以讓 skill 以 API 的形式對(duì)外提供服務(wù)任何 Agent 都能調(diào)用。5.2 部署時(shí)的幾個(gè)關(guān)鍵決策第一個(gè)決策skill 是無(wú)狀態(tài)還是有狀態(tài)。大多數(shù) skill 應(yīng)該是無(wú)狀態(tài)的每次調(diào)用獨(dú)立這樣容易水平擴(kuò)展。如果 skill 需要維護(hù)會(huì)話狀態(tài)就要考慮用外部存儲(chǔ)而不是放在服務(wù)內(nèi)存里。第二個(gè)決策同步還是異步?？焖俜祷氐?skill 用同步 API耗時(shí)長(zhǎng)的比如要跑幾分鐘的分析用異步先返回任務(wù) ID再輪詢結(jié)果。第三個(gè)決策怎么隔離不同 skill 的資源。如果多個(gè) skill 共享一個(gè)服務(wù)一個(gè) skill 出問(wèn)題可能拖垮其他。用 GKE 的話可以考慮按 skill 分組部署或者用資源配額限制單個(gè) skill 的消耗。5.3 Genkit 在其中的角色Genkit 這類框架的價(jià)值是把 AI 應(yīng)用的常見(jiàn)模式封裝好比如提示詞管理、工具調(diào)用、流式輸出、追蹤調(diào)試。你不用自己從頭搭這些基礎(chǔ)設(shè)施專注寫 skill 邏輯就行。實(shí)際用下來(lái)我覺(jué)得它最大的好處是調(diào)試體驗(yàn)。AI 應(yīng)用的調(diào)試很痛苦因?yàn)槟Ｐ洼敵霾淮_定。Genkit 提供的追蹤功能能讓你看到每次調(diào)用的完整鏈路輸入是什么、掛了哪些 skill、調(diào)了哪些工具、輸出是什么。這對(duì)排查問(wèn)題幫助很大。5.4 云上部署的成本和性能權(quán)衡把 skill 放云上成本主要來(lái)自三塊計(jì)算資源、模型調(diào)用、網(wǎng)絡(luò)傳輸。計(jì)算資源相對(duì)好控制模型調(diào)用是大頭尤其是高頻調(diào)用的 skill。優(yōu)化思路有幾個(gè)緩存常見(jiàn)結(jié)果同樣的輸入不用重復(fù)調(diào)模型用小模型處理簡(jiǎn)單任務(wù)大模型只用在真正需要的地方批處理把多個(gè)小請(qǐng)求合并成一次調(diào)用。性能方面冷啟動(dòng)是云上部署的常見(jiàn)問(wèn)題。如果 skill 服務(wù)長(zhǎng)時(shí)間沒(méi)被調(diào)用容器可能被回收下次調(diào)用要重新啟動(dòng)延遲會(huì)很高。解決辦法是設(shè)置最小實(shí)例數(shù)或者用預(yù)熱機(jī)制。6. 關(guān)于 skills 的幾個(gè)常見(jiàn)誤解6.1 skills 就是提示詞模板不完全對(duì)。提示詞模板是靜態(tài)的文本替換skills 是動(dòng)態(tài)的能力掛載。skills 包含提示詞但還包括工具聲明、輸出規(guī)范、觸發(fā)條件。而且 skills 是運(yùn)行時(shí)被 Agent 主動(dòng)選擇的不是預(yù)先拼好的。6.2 skill 寫得越詳細(xì)越好前面說(shuō)過(guò)太細(xì)會(huì)死。skill 的詳細(xì)程度要匹配任務(wù)的確定性。確定性高的任務(wù)可以寫細(xì)確定性低的任務(wù)要給模型留空間。判斷標(biāo)準(zhǔn)是如果任務(wù)的正確做法只有一種就寫細(xì)如果有多種合理做法就給原則。6.3 一個(gè) skill 可以搞定所有事這是最危險(xiǎn)的誤解。skill 的價(jià)值恰恰在于專精。一個(gè)什么都干的 skill等于什么都沒(méi)干好。我見(jiàn)過(guò)有人做一個(gè)萬(wàn)能助手 skill結(jié)果在所有任務(wù)上表現(xiàn)都平庸。拆成多個(gè)專精 skill整體效果反而更好。6.4 skills 只適合技術(shù)場(chǎng)景不是。熱搜里有分鏡 skills、寫論文的 skills說(shuō)明非技術(shù)場(chǎng)景一樣適用。任何有固定流程、需要反復(fù)執(zhí)行的任務(wù)都可以做成 skill。關(guān)鍵是任務(wù)要可描述、可復(fù)用、有明確輸出。7. 我個(gè)人的一些實(shí)操心得折騰 skills 這段時(shí)間有幾個(gè)體會(huì)比較深分享出來(lái)。第一先手動(dòng)跑通再封裝成 skill。不要一上來(lái)就寫 skill先用提示詞手動(dòng)把任務(wù)跑幾遍看看流程順不順、輸出穩(wěn)不穩(wěn)。跑通了再封裝能省很多返工。第二skill 要版本化。每次改動(dòng)都記下來(lái)改了什么、為什么改。skills 的效果很依賴細(xì)節(jié)改一個(gè)字可能結(jié)果就變了。沒(méi)有版本記錄出了問(wèn)題根本沒(méi)法回溯。第三建立自己的 skill 庫(kù)。用得順手的 skill 存起來(lái)分類管理。時(shí)間長(zhǎng)了你會(huì)發(fā)現(xiàn)很多任務(wù)其實(shí)是重復(fù)的有現(xiàn)成的 skill 直接掛上就行效率提升很明顯。第四別迷信官方 skill。熱搜里有官方市場(chǎng)、官方下載這類詞官方 skill 質(zhì)量通常有保障但不一定適合你的場(chǎng)景。我的做法是參考官方 skill 的結(jié)構(gòu)但指令體按自己的需求重寫。第五測(cè)試要覆蓋邊界情況。正常輸入跑通不算完要測(cè)空輸入、超長(zhǎng)輸入、格式錯(cuò)誤的輸入、工具調(diào)用失敗的場(chǎng)景。這些邊界情況才是 skill 穩(wěn)定性的真正考驗(yàn)。最后說(shuō)個(gè)觀察skills 這個(gè)方向現(xiàn)在還在快速演化不同平臺(tái)的規(guī)范還在打架。但底層邏輯是穩(wěn)的——把能力模塊化、把流程結(jié)構(gòu)化、把經(jīng)驗(yàn)可復(fù)用化。這個(gè)邏輯不會(huì)變。所以現(xiàn)在投入學(xué) skills不是追熱點(diǎn)是在積累一種會(huì)長(zhǎng)期有用的能力組織方式。至于具體用哪個(gè)平臺(tái)、哪種格式反而是次要的理解了本質(zhì)換平臺(tái)只是改改適配層的事。