h30190/2026_tut_interior_with_ai_course/skill-usage-audit

skill 使用稽核

回答一個問題：我養的這些 skill，哪些真的在用？ 但它不會直接告訴你「刪這個」，因為零次有四種完全不同的原因，處置相反。

跑法

node scripts/稽核.js          # 人看的報告
node scripts/稽核.js --json   # 給程式吃的
node scripts/測試.js          # 改過解析邏輯後必跑

資料來源與它們的極限

只有「Skill 工具被顯式呼叫」會被算成一次。skill 名字出現在對話文字裡不算—— 路由表每個 session 都會被注入，天真的字串比對會把 interior-boq-quote 算成 216 次。 測試.js 有一條測試專門守這件事。同一筆呼叫（同一個 tool_use id）寫進多個逐字稿檔也只算一次。

2026-10-03 王品洋交叉稽核後的修正（這個工具的結論是「建議刪哪些」，誤判成可刪比崩潰更危險）：

• 統計表沒有原型，skill 叫 constructor、__proto__ 也不會讓整支崩潰
• description 支援 YAML 多行寫法（>-、|、縮排續行），季節性字眼不會再漏讀
• 路由表比對要完整名稱：ledger 不會被 interior-ledger 算成有指名
• 沒有 SKILL.md 的資料夾（_archive、node_modules）不評估，列在「略過」
• 壞掉的符號連結不會靜默消失，歸「連結已失效」並在資料來源列出

分類怎麼讀

判斷零次時要先問的三件事

1. 這件事你最近做過嗎？做過但顯示零次 → 工作被直接做掉、沒走 skill。

問題在觸發條件或路由表，刪掉只會讓下次更沒章法。

1. 它是不是一年才用一次？交屋手冊、保固通知、口試準備本來就低頻，

用兩個月的資料判它死刑不合理。

1. 路由表把它換掉了嗎？例如 interior-vendor-db 目前零次且無人指名，

因為 CLAUDE.md 已改成走 company-tools MCP 的 vendor_search。 這種是真的功成身退，可以刪——但要確認 MCP 真的涵蓋了原本的功能。

邊界

• 只讀不刪。這支腳本不會動任何 skill 檔案，刪除一律由 Jason 手動執行。
• `D:/Claude/skills` 是龍蝦的地盤，這裡只讀取與列出，不得修改或刪除。
• 樣本太少時不要硬給結論。2026-09-19 首次執行時，兩個月內全部只有 4 次呼叫紀錄，

這種樣本量撐不起刪除決策——要有把握的話得先讓用量資料累積起來。