azuma520 Skill Advisor — Skill 衛生工具
分析已安裝的所有 skill，用語意分析找出重疊和冗餘，產出 Action Cards 引導使用者逐一清理。
執行流程
Step 1: 跑資料收集腳本
掃描所有已安裝的 skill：
node "{THIS_SKILL_DIR}/scripts/analyze-skills.mjs" --json --dir "{HOME}/.claude/skills"
如果使用者有專案級 skill，也一起掃：
node "{THIS_SKILL_DIR}/scripts/analyze-skills.mjs" --json --dir ".claude/skills"
合併兩次的 JSON 結果。
Step 2: 派 subagent 做語意分析
派一個 Sonnet subagent，傳入：
- 所有 skill 的 name + description 全文
- 依賴圖（skillRefs、referencedBy）
- 孤兒標記
請 subagent 分析並回傳 JSON：
{
"actions": [
{
"type": "merge | remove | trim | conflict",
"skills": ["skill-a", "skill-b"],
"reason": "具體原因",
"suggestion": "具體建議動作",
"token_save_estimate": 400
}
]
}
分析任務：
- 語意重疊（merge） — 哪些 skill 功能實質重疊，做的事一樣
- 觸發衝突（conflict） — 哪些 skill 會對同一種 prompt 搶觸發
- 可刪除（remove） — 哪些 skill 功能已被其他 skill 完全涵蓋，且無人引用
- Token 肥大（trim） — 哪些 description 可以精簡但不影響觸發
subagent prompt 要點：
- 不要只看關鍵字，要理解每個 skill 實際做什麼
- 考慮依賴關係：被其他 skill 引用的不建議刪除
- 每個建議必須附具體理由和行動
- 用繁體中文
Step 3: 產出 Action Cards 並逐一互動
將 actions 按 token_save_estimate 由大到小排序。
逐一呈現 Action Card：
📋 Action Card [N/total]：[type 中文名]
[skill name(s)]
原因：[reason]
建議：[suggestion]
預估省 token：~[token_save_estimate] 字
→ 接受 / 跳過 / 修改？
type 中文對照：
- merge → 去重
- remove → 移除
- trim → 精簡
- conflict → 衝突
Step 4: 執行被接受的修改
根據使用者的決定：
- 接受 remove：將 skill 目錄移至
~/.claude/skills/_inactive/（備份，不是真刪） - 接受 merge：修改兩個 skill 的 description，明確分工界線
- 接受 trim：精簡 description，保留觸發能力
- 接受 conflict：在兩個 skill 的 description 加入 disambiguation（NOT for 語句）
- 修改：使用者給方向，Claude 調整後執行
每執行一個修改後，告知使用者完成，再呈現下一張 Card。
Step 5: 總結
全部 Card 過完後，呈現總結：
✅ 完成 skill 清理
執行了 N/M 項建議
移除：X 個 skill（已備份至 _inactive/）
精簡：Y 個 description
解決衝突：Z 個
預估省 token：~W 字/session
注意事項
- 不直接刪除 skill：移除操作是搬到 _inactive/ 備份，使用者可隨時搬回來
- 語意分析用 Sonnet：需要理解力判斷重疊，Haiku 不夠
- 不改 skill 的功能邏輯：只改 description 和 trigger，不碰 SKILL.md body
- 使用者有最終決定權：每個修改都要使用者確認