Skill 水平參差不齊,龍蝦之父 Peter 看不下去了。
各位:別把 Skill 描述寫得像本書一樣,亂七八糟的東西都塞進上下文。
為了解決這個問題,他寫了一個給所有 Skill 做體檢的 Skill,給大伙開源出來。

這個觀點在評論區(qū)引發(fā)網友共鳴。
有人提到,寫了 90 多詞的描述 Agent 都不能好好調用技能??车?40 詞以內后,Agent 反而一次選對了技能。

那么,你的 Skill 是不是也該做一次“體檢”了?
龍蝦之父給 Skill 做大掃除
Skill 提示詞的問題,表面看是文案長短,實際影響運行時成本。多加一句描述,Agent 每次調用就要多付一筆 token 賬單。
Agent 看到的信息越多,選擇時的噪聲也越多。延遲、成本、注意力,全都在里面。
龍蝦之父主張 Skill 要像路標。目的是要讓 Agent 找到路,不該把整本說明掛在路標上。
他開源的 skill-cleaner 就用這種風格打了個樣。
Skill.md 只有 56 行提示詞。

調用的腳本足足近千行代碼。

再體會一下,Skill.md 是路標,代碼才是說明書。
這個 skill 有 5 個核心功能。
1、技能提示詞預算審計計算
技能占用的上下文令牌空間,分析預算占用比例,給出預算優(yōu)化方案,避免技能占用過多上下文資源。
2、重復技能檢測
跨 Codex 內置庫、插件緩存、代碼庫、個人技能根目錄,掃描同名技能、描述 / 內容高度相似的重復技能,標記冗余項。
3、未使用技能篩查
基于歷史日志,識別長期未被調用、未被提及、無使用痕跡的閑置技能,提供清理候選清單。
4、技能根目錄審計
統(tǒng)計所有技能的來源根目錄,標注已啟用 / 禁用狀態(tài),梳理技能加載鏈路。
5、描述精簡優(yōu)化
找出冗長的技能描述,推薦通過簡化語法壓縮長度,節(jié)省提示詞預算。
測試運行一下,結果大概這樣:

每個功能的工作流程分為三步。
1、執(zhí)行分析腳本
在技能目錄 / 倉庫根目錄運行 Node.js 腳本(支持自定義參數(shù):時間范圍、日志深度、預算閾值、自定義根目錄等)。
2、查看審計報告
按順序閱讀核心報告:技能預算 → 描述優(yōu)化項 → 重復技能 → 未使用技能 → 根目錄匯總。
3、安全清理 / 編輯
優(yōu)先保留 Codex 內置技能,刪除本地 / 重復副本;保留倉庫核心運維技能;不刪除未確認的無關目錄,修改前驗證保留文件有效性。
腳本里值得分析的細節(jié)還有幾個。
腳本用了 Codex 官方源碼同款提示詞預算核算邏輯。優(yōu)先讀取本地模型緩存配置獲取 GPT-5.5 上下文窗口參數(shù),默認 272ktoken。
嚴格遵循 Codex 計費規(guī)則(UTF8 字節(jié)數(shù) / 4 向上取整),以模型上下文 2% 為默認技能預算基數(shù),結合技能優(yōu)先級排序規(guī)則(系統(tǒng)技能>內置技能>插件技能>倉庫自定義技能),核算全量技能原始占用令牌、最小渲染令牌、預算內可用令牌。
同時可模擬真實運行場景,計算預算不足時的技能描述截斷字符數(shù)、被省略技能數(shù)量,精準輸出預算使用率、剩余預算、上下文占用比例等核心指標,直觀展示技能體系的資源負載情況。
具體到精簡 Skill 描述,也是分為三步
文本預處理,統(tǒng)一格式,全部小寫、剔除標點符號等。
內置預設場景關鍵詞詞庫,識別技能所屬業(yè)務領域
匹配到場景后調用預設的標準化短動作詞組替換原有冗長描述
如,調試類 → debug, inspect, fix
部署發(fā)布類 → deploy, release, verify
檢索歸檔類 → search, sync, summarize
最后看起來就是這樣的。

甚至 Peter 本人在帖子評論區(qū)也開始用這種“穴居人”風格說話:

真是把省 token 刻到骨子里了。
install skill
agent smart
user happy
GitHub:
https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner
廣告聲明:文內含有的對外跳轉鏈接(包括不限于超鏈接、二維碼、口令等形式),用于傳遞更多信息,節(jié)省甄選時間,結果僅供參考,IT之家所有文章均包含本聲明。