Skill 水平參差不齊，龍蝦之父 Peter 看不下去了。
各位：別把 Skill 描述寫(xiě)得像本書(shū)一樣，亂七八糟的東西都塞進(jìn)上下文。
為了解決這個(gè)問(wèn)題，他寫(xiě)了一個(gè)給所有 Skill 做體檢的 Skill，給大伙開(kāi)源出來(lái)。
這個(gè)觀點(diǎn)在評(píng)論區(qū)引發(fā)網(wǎng)友共鳴。
有人提到，寫(xiě)了 90 多詞的描述 Agent 都不能好好調(diào)用技能?？车?40 詞以內(nèi)后，Agent 反而一次選對(duì)了技能。
那么，你的 Skill 是不是也該做一次“體檢”了？
龍蝦之父給 Skill 做大掃除
Skill 提示詞的問(wèn)題，表面看是文案長(zhǎng)短，實(shí)際影響運(yùn)行時(shí)成本。多加一句描述，Agent 每次調(diào)用就要多付一筆 token 賬單。
Agent 看到的信息越多，選擇時(shí)的噪聲也越多。延遲、成本、注意力，全都在里面。
龍蝦之父主張 Skill 要像路標(biāo)。目的是要讓 Agent 找到路，不該把整本說(shuō)明掛在路標(biāo)上。
他開(kāi)源的 skill-cleaner 就用這種風(fēng)格打了個(gè)樣。
Skill.md 只有 56 行提示詞。
調(diào)用的腳本足足近千行代碼。
再體會(huì)一下，Skill.md 是路標(biāo)，代碼才是說(shuō)明書(shū)。
這個(gè) skill 有 5 個(gè)核心功能。
1、技能提示詞預(yù)算審計(jì)計(jì)算
技能占用的上下文令牌空間，分析預(yù)算占用比例，給出預(yù)算優(yōu)化方案，避免技能占用過(guò)多上下文資源。
2、重復(fù)技能檢測(cè)
跨 Codex 內(nèi)置庫(kù)、插件緩存、代碼庫(kù)、個(gè)人技能根目錄，掃描同名技能、描述 / 內(nèi)容高度相似的重復(fù)技能，標(biāo)記冗余項(xiàng)。
3、未使用技能篩查
基于歷史日志，識(shí)別長(zhǎng)期未被調(diào)用、未被提及、無(wú)使用痕跡的閑置技能，提供清理候選清單。
4、技能根目錄審計(jì)
統(tǒng)計(jì)所有技能的來(lái)源根目錄，標(biāo)注已啟用 / 禁用狀態(tài)，梳理技能加載鏈路。
5、描述精簡(jiǎn)優(yōu)化
找出冗長(zhǎng)的技能描述，推薦通過(guò)簡(jiǎn)化語(yǔ)法壓縮長(zhǎng)度，節(jié)省提示詞預(yù)算。
測(cè)試運(yùn)行一下，結(jié)果大概這樣：
每個(gè)功能的工作流程分為三步。
1、執(zhí)行分析腳本
在技能目錄 / 倉(cāng)庫(kù)根目錄運(yùn)行 Node.js 腳本（支持自定義參數(shù)：時(shí)間范圍、日志深度、預(yù)算閾值、自定義根目錄等）。
2、查看審計(jì)報(bào)告
按順序閱讀核心報(bào)告：技能預(yù)算 → 描述優(yōu)化項(xiàng) → 重復(fù)技能 → 未使用技能 → 根目錄匯總。
3、安全清理 / 編輯
優(yōu)先保留 Codex 內(nèi)置技能，刪除本地 / 重復(fù)副本；保留倉(cāng)庫(kù)核心運(yùn)維技能；不刪除未確認(rèn)的無(wú)關(guān)目錄，修改前驗(yàn)證保留文件有效性。
腳本里值得分析的細(xì)節(jié)還有幾個(gè)。
腳本用了 Codex 官方源碼同款提示詞預(yù)算核算邏輯。優(yōu)先讀取本地模型緩存配置獲取 GPT-5.5 上下文窗口參數(shù)，默認(rèn) 272ktoken。
嚴(yán)格遵循 Codex 計(jì)費(fèi)規(guī)則（UTF8 字節(jié)數(shù) / 4 向上取整），以模型上下文 2% 為默認(rèn)技能預(yù)算基數(shù)，結(jié)合技能優(yōu)先級(jí)排序規(guī)則（系統(tǒng)技能＞內(nèi)置技能＞插件技能＞倉(cāng)庫(kù)自定義技能），核算全量技能原始占用令牌、最小渲染令牌、預(yù)算內(nèi)可用令牌。
同時(shí)可模擬真實(shí)運(yùn)行場(chǎng)景，計(jì)算預(yù)算不足時(shí)的技能描述截?cái)嘧址麛?shù)、被省略技能數(shù)量，精準(zhǔn)輸出預(yù)算使用率、剩余預(yù)算、上下文占用比例等核心指標(biāo)，直觀展示技能體系的資源負(fù)載情況。
具體到精簡(jiǎn) Skill 描述，也是分為三步
文本預(yù)處理，統(tǒng)一格式，全部小寫(xiě)、剔除標(biāo)點(diǎn)符號(hào)等。
內(nèi)置預(yù)設(shè)場(chǎng)景關(guān)鍵詞詞庫(kù)，識(shí)別技能所屬業(yè)務(wù)領(lǐng)域
匹配到場(chǎng)景后調(diào)用預(yù)設(shè)的標(biāo)準(zhǔn)化短動(dòng)作詞組替換原有冗長(zhǎng)描述
如，調(diào)試類(lèi) → debug, inspect, fix
部署發(fā)布類(lèi) → deploy, release, verify
檢索歸檔類(lèi) → search, sync, summarize
最后看起來(lái)就是這樣的。
甚至 Peter 本人在帖子評(píng)論區(qū)也開(kāi)始用這種“穴居人”風(fēng)格說(shuō)話：
真是把省 token 刻到骨子里了。
install skill
agent smart
user happy
GitHub：
https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner
廣告聲明：文內(nèi)含有的對(duì)外跳轉(zhuǎn)鏈接（包括不限于超鏈接、二維碼、口令等形式），用于傳遞更多信息，節(jié)省甄選時(shí)間，結(jié)果僅供參考，IT之家所有文章均包含本聲明。