龍蝦之父教你省錢：用 skill 給 skill 做體檢瘦身

你到底俾你嘅 Codex 或者 Claude Code 裝咗幾多個技能？或者話你裝咗嗰啲技能，有幾多係你真係有用緊㗎？估計你一時三刻都答唔出嚟。

我最近就俾龍蝦之父 Peter 嘅一條推文點醒咗。

佢話佢見到而家社區入面有太多人將技能描述寫到好似一本書咁，一大堆說明、流程、註釋全部塞曬入去，然後呢啲嘢會喺每次 AI 啟動嗰陣完整加載入上下文。

佢原話係咁樣嘅：

呢條推文出咗之後，兩日唔夠，收咗接近 5,000 個讚好，分享超過 6,000+ 次，瀏覽次數超過 30 萬。

呢個說明呢個問題戳中咗好多人嘅痛點。

佢日常喺多個項目入面深度使用 AI Agent，同時佢亦都維護住一個公開嘅智能體配置倉庫，入面放咗佢自己用嘅各種技能同腳本，任何人都可以攞去用。

倉庫地址：
https://github.com/steipete/agent-scripts

我哋先將呢件事嘅背景講清楚，因為只有搞清楚呢個問題有幾嚴重，你先至會明 Peter 點解要專登做呢個工具。

譬如話你裝咗一個技能或者自己創建咗一個，為咗令 AI 知道呢個技能係做乜嘅，你需要俾佢寫一段描述，即係「description」。

AI 就係靠呢段描述嚟決定要唔要調用呢個技能嘅。

聽落好合理，啱唔啱？但問題在於，好多人寫寫嚇就會將呢段描述寫長咗，越寫越長，將使用說明、調用示例、注意事項全部塞曬入去。

咁會帶嚟兩個你可能冇意識到嘅損失。

第一個係錢嘅問題

呢段描述唔係淨係你調用呢個技能嗰陣先加載，而係每次 AI Agent 啟動嗰陣就已經成個加載入上下文嘅。

每一個多餘嘅字，都會喺每一次運行時多用你啲 token。按照計費規則，一段由 90 個詞精簡到 40 個詞嘅描述，直接可以慳返接近一半嘅描述成本。

如果你嘅 Agent 入面裝咗幾十個技能，每個描述都寫咗一大堆，呢筆帳加起嚟就唔細㗎喇。

第二個更加隱蔽同嚴重

AI 揀技能靠乜嘢？靠用你講嘅話（自然語言）去匹配技能嘅描述，然後決定調用邊一個。

描述越長、信息越雜，AI 反而越難揀啱。

社區入面就有人分享過自己嘅親身經歷：一個技能寫咗 90 幾個詞嘅描述，AI 完全揀唔中，換咗好幾次指令都冇用；後來將描述砍到 40 個詞以內，一次就揀啱咗。

你花時間裝好或者整好嘅技能，因為描述寫得太長，AI 根本唔知要用佢，呢個技能就等於白裝咗。

Peter 嘅解法係做一個專登俾 skill 做體檢嘅 skill，叫「skill-cleaner」。睇落係咪有啲似 Anthropic 公司出品嘅 skill-creator。

呢個工具本身都係一個 skill，亦都符合 Agent Skills 嘅通用標準。

佢做到五件事：

第一，計出你當前所有技能描述一共食咗幾多 token 預算，仲剩返幾多空間；

第二，揾出邊啲描述寫得太長，俾出精簡建議；

第三，掃瞄所有技能目錄，睇下有冇重複安裝嘅同名技能或者內容高度相似嘅技能；

第四，根據歷史使用日誌，揾出啲裝咗好耐但從來冇被調用過嘅閒置技能；

第五，列出你所有技能嚟自邊啲根目錄，幫你搞清楚加載鏈路。

關於 Peter 搭建嘅呢個 skill，入面有一個細節我覺得好值得講下。

呢個 skill-cleaner 本身嘅描述檔案得 56 行，而佢背後嘅分析腳本接近 1,000 行。提示詞極簡，代碼極詳細。

呢個正正係 Peter 自己一直倡導嘅原則：技能描述係路標，唔係說明書。

路標嘅作用係令人揾到路，唔係將成張地圖印喺路標上面。

我自己拎到呢個工具之後，先用 Claude Code 將佢完整分析咗一次，我發現呢個 skill 並唔係喺所有兼容 Agent Skills 標準嘅代理系統入面都用得到。

雖然佢呢個 skill 搭建嘅標準係通用嘅，但佢入面嘅路徑、預算計算規則、日誌格式，全部 hard code 指向咗 Codex 呢個系統嘅內部結構。

呢個都好理解，畢竟 Peter 已經加入咗 OpenAI，平時用得最多嘅 Coding Agent 一定係 Codex。

連我哋呢啲普通用戶都知道 Codex + GPT-5.5 呢個組合喺開發上好給力，更何況 Peter 就身在其中呢。

但如果你平時常用嘅係 Claude Code，呢個 skill 直接裝上嚟用係行唔到嘅，或者話入面有啲功能係唔會俾你任何輸出反饋嘅。

但 Peter 呢個 skill 嘅審計思路係完全通用嘅。

Peter 透過呢個 skill 想解決嗰幾個問題，你用 Claude Code 一樣會遇到。

譬如話描述寫太長、重複安裝咗同名技能、裝咗一堆從來冇點用過、唔知道呢啲技能到底從邊幾個目錄加載過嚟...

所以我就基於 Peter 呢個審計思路，並結合佢呢個 skill-cleaner，自己幫 Claude Code 做咗一個對應嘅版本，叫「cc-skill-cleaner」。

功能上，我完整保留咗三個完全基於檔案掃瞄嘅審計維度。

重複技能檢測，掃瞄所有技能目錄，透過名稱標準化加內容哈希比對嚟發現同名或內容近似嘅重複技能，路徑已經適配到 Claude Code 嘅目錄結構。

長描述候選，標記描述超過 150 個字符嘅技能俾出警告、超過 250 個字符嘅俾出嚴重提示，並建議截斷到 120 個字符以內。

根目錄摘要，列出所有掃瞄到嘅技能根目錄，標註邊啲係內置技能、邊啲係你自定義嘅。

對於未使用候選呢個維度，Peter 係靠讀取 Codex 嘅真實歷史日誌嚟判斷，但 Claude Code 冇對外公開等價嘅日誌機制，所以我改用咗「啟發式規則」嚟推測，例如命名係咪過時、係咪喺禁用目錄入面，呢個維度嘅結果只能夠參考，唔可以百分百信賴。

仲有一個功能我冇做，就係 Skill Budget 預算計算。

Peter 呢個功能其實做得好完整，佢讀取嘅係 Codex 內部嘅模型緩存檔案嚟精確計算你嘅技能描述用咗幾多預算空間。

而 Claude Code 冇公開呢個機制嘅文檔，如果我強行實現，計出嚟嘅數字係冇意思嘅，只會誤導你。

所以我寧願選擇唔做，雖然少一個功能，但唔會俾你睇假數據。

Peter 原版 skill 生成嘅報告係英文嘅，我將 cc-skill-cleaner 輸出嘅報告默認改咗做中文版，一個 HTML 可視化嘅審計頁面，卡片總覽加數據表格，字符數超標嘅會有徽章標註，打開就睇得明。

如果你用緊 Claude Code，想知道自己裝咗嗰啲技能有冇上面講嘅呢啲問題，可以直接用 cc-skill-cleaner 嚟分析檢查。

我已經將 cc-skill-cleaner 封裝好咗，你只需要關注公眾號之後，點擊私信，喺最下面嘅輸入框輸入關鍵詞「cc技能審計」，就可以拎到完整嘅技能打包檔案，使用方法入面都有說明。

寫喺最後

我覺得 Peter 提醒嘅呢件事都幾有意義，值得所有用緊 AI Agent 嘅人記住。

技能係路標，唔係說明書。

你俾技能寫描述嗰陣，佢嘅唯一目的就係令 AI 喺啱嘅時刻揀中佢。

其他所有嘅說明、流程、注意事項，都應該放喺技能嘅執行檔案入面，唔應該掛喺描述上。

如果你常用 Codex，直接裝 Peter 嘅原版 skill-cleaner 技能就得，技能地址係：

https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner

直接叫 Agent 幫你安裝就得。

如果你常用 Claude Code，咁就可以用我改裝嘅 cc-skill-cleaner 嚟定期做分析審計。

總之，按照你嘅需求自己揀就得，兩個都裝都得。

既然睇到呢度，如果覺得唔錯，順手幫手㩒個「讚好」、「在看」、「分享」三連；如果想第一時間收到推送，都可以幫我加個星標★，非常感謝！

你到底給你的 Codex 或者 Claude Code 裝了多少個技能？或者說你裝的那些技能，有多少是你真的在用的呢？估計你一時半會也不可能馬上答出來。

我最近就被龍蝦之父 Peter 的一條推文給點醒了。

他說他看到現在社區裏有太多人把技能描述寫得像一本書，一大堆說明、流程、註釋全都給塞了進去，然後這些東西會在每次 AI 啓動的時候被完整加載進上下文。

他的原話是這樣的：

這條推文發出來後，兩天不到，收了將近 5,000 個點贊，轉發超過 6,000+ 次，瀏覽量超過 30 萬。

這說明這個問題戳到了很多人的痛點。

他日常在多個項目裏深度使用 AI Agent，同時他也維護着一個公開的智能體配置倉庫，裏面放了他自己用的各種技能和腳本，任何人都可以拿去用。

倉庫地址：
https://github.com/steipete/agent-scripts

我們先把這件事兒的背景說清楚，因為只有搞清楚這個問題有多嚴重，你才會明白 Peter 為什麼要專門做這個工具。

比如你裝了一個技能或者自己創建了一個，為了讓 AI 知道這個技能是幹嘛的，你需要給它寫一段描述，也就是「description」。

AI 就是靠這段描述來決定要不要調用這個技能的。

聽起來很合理，對吧。但問題在於，很多人寫着寫着就會把這段描述寫長了，越來越長，把使用說明、什麼調用示例、注意事項全都塞了進去。

這會帶來兩個你可能沒有意識到的損失。

第一個是錢的問題

這段描述不是隻在你調用這個技能的時候才被加載，它是在每次 AI Agent 啓動的時候就被整個加載進上下文的。

每一個多餘的字，都會在每一次運行時多花你一點 token。按照計費規則，一段從 90 個詞精簡到 40 個詞的描述，直接能夠省掉將近一半的描述成本。

如果你的 Agent 中裝了幾十個技能，每個描述都寫了一大堆，這筆賬加起來可就不小了。

第二個更隱蔽也更嚴重

AI 選技能靠的是什麼？靠的是用你說的話（自然語言）去匹配技能的描述，然後決定調用哪一個。

描述越長、信息越雜，AI 反而越難選對。

社區裏就有人分享過自己的親身經歷：一個技能寫了 90 多個詞的描述，AI 完全選不中，換了好幾次指令都沒用；後來把描述砍到 40 個詞以內，一次就選對了。

你花時間裝好或者建好的技能，因為描述寫的太長，AI 根本不知道該用它，這個技能就等於白裝了。

Peter 的解法是做一個專門給 skill 做體檢的 skill，叫「skill-cleaner」。看着是不是有點兒類似於 Anthropic 公司出品的 skill-creator。

這個工具本身也是一個技能，也符合 Agent Skills 的通用標準。

它能做五件事：

第一，算出你當前所有技能描述一共吃掉了多少token預算，還剩多少空間；

第二，找出哪些描述寫得太長，給出精簡建議；

第三，掃描所有技能目錄，看看有沒有重複安裝的同名技能或者內容高度相似的技能；

第四，根據歷史使用日誌，找出那些裝了很久但從來沒被調用過的閒置技能；

第五，列出你所有技能來自哪些根目錄，幫你搞清楚加載鏈路。

關於 Peter 搭建的這個 skill，裏面有一個細節我覺得很值得說一下。

這個 skill-cleaner 本身的描述文件只有 56 行，而它背後的分析腳本將近 1,000 行。提示詞極簡，代碼極詳細。

這正是 Peter 自己一直在倡導的原則：技能描述是路標，不是說明書。

路標的作用是讓人找到路，不是把整本地圖印在路標上。

我自己拿到這個工具之後，先用 Claude Code 把它完整分析了一遍，我發現這個 skill 並不能在所有兼容 Agent Skills 標準的代理系統中使用。

雖然，他這個 skill 搭建的標準是通用的，但它裏面的路徑、預算計算規則、日誌格式，全部硬編碼指向了 Codex 這個系統的內部結構。

這也很好理解，畢竟 Peter 已經加入了 OpenAI，平時用的最多的 Coding Agent 肯定是 Codex。

連我們這些普通用戶都知道 Codex + GPT-5.5 這個組合在開發上很給力，更何況 Peter 就身在其中呢。

但如果你平時常用的是 Claude Code，這個 skill 直接裝上拿來用是跑不起來的，或者說裏面的一些功能是不會給你任何輸出反饋的。

但 Peter 這個 skill 的審計思路是完全通用的。

Peter 通過這個 skill 想解決的那幾個問題，你用 Claude Code 一樣會遇到。

比如描述寫太長、重複安裝了同名技能、裝了一堆從來沒怎麼用過的、不知道這些技能到底從哪幾個目錄加載過來的...

所以我就基於 Peter 的這個審計思路，並結合他這個 skill-cleaner，自己給 Claude Code 做了一個對應的版本，叫「cc-skill-cleaner」。

功能上，我完整保留了三個完全基於文件掃描的審計維度。

重複技能檢測，掃描所有技能目錄，通過名稱標準化加內容哈希比對來發現同名或內容近似的重複技能，路徑已經適配到 Claude Code 的目錄結構。

長描述候選，標記描述超過 150 個字符的技能給出警告、超過 250 個字符的給出嚴重提示，並建議截斷到 120 個字符以內。

根目錄摘要，列出所有掃描到的技能根目錄，標註哪些是內置技能、哪些是你自定義的。

對於未使用候選這個維度，Peter 是靠讀取 Codex 的真實歷史日誌來判斷的，但 Claude Code 沒有對外公開等價的日誌機制，所以我改用了「啓發式規則」來推測，比如命名是否過時、是否在禁用目錄裏，這個維度的結果只能作為參考，不能百分百信任。

還有一個功能我沒有做，就是 Skill Budget 預算計算。

Peter 這個功能其實做得很完整，它讀取的是 Codex 內部的模型緩存文件來精確計算你的技能描述用掉了多少預算空間。

而 Claude Code 沒有公開這個機制的文檔，如果我強行實現，算出來的數字沒有意義，只會誤導你。

所以我寧願選擇不做，雖然少一個功能，但不會給你看假數據。

Peter 原版 skill 生成的報告是英文的，我把 cc-skill-cleaner 輸出的報告默認改成了中文版，一個 HTML 可視化的審計頁面，卡片總覽加數據表格，字符數超標的會有徽章標註，打開就能看懂。

如果你在用 Claude Code，想知道自己裝的那些技能有沒有上面說的這些問題，可以直接用 cc-skill-cleaner 來分析檢查。

我已經把  cc-skill-cleaner 封裝好了，你只需要關注公眾號之後，點擊私信，在最下方的輸入框內輸入關鍵詞「cc技能審計」，就可以拿到完整的技能打包文件，使用方法裏面也有說明。

寫在最後

我覺得 Peter 提醒的這個事兒還是蠻有意義的，值得所有在用 AI Agent 的人記住。

技能是路標，不是說明書。

你給技能寫描述的時候，它的唯一目的就是讓 AI 能在對的時刻選中它。

其他所有的說明、流程、注意事項，都應該放進技能的執行文件裏，不該掛在描述上。

如果你常用 Codex，直接裝 Peter 的原版 skill-cleaner 技能就行，技能地址是：

https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner

直接讓 Agent 幫你安裝即可。

如果你常用 Claude Code，那就可以使用我改裝的  cc-skill-cleaner 來定期做分析審計。

總之，按照你的需求自己選就行，兩個都裝也可以。

既然看到這兒了，如果覺得還不錯，幫忙隨手點個「贊」、「在看」、「轉發」三連；如果想第一時間收到推送，也可給我加個星標★，非常感謝！