治理 · 调优与冲突

你已经按 03 选型 装了一套 Skill，现在 Skill 变多、触发错乱、/doctor 报警——读本章。
安装与验证流程见 02 管理架构与快速上手。

装多少合适

描述预算

Claude Code 每轮把已安装 Skill 的 name + description（+ when_to_use）载入 listing，默认 skillListingBudgetFraction: 0.01（占模型 context window 的 1%，非「剩余 context」）。单条上限 1536 字符（可调 maxSkillDescriptionChars）。

数量	经验
~10 个	通常安全
~15 个	接近上限
20+	后部 description 可能被截断或 dropped

调优顺序（按推荐）

1. /skills 禁用低频 Skill（零 token 成本，首选）。在列表中 Space 循环状态，Enter 写入 skillOverrides
2. /doctor 看 truncated / dropped
3. 精简 description，触发词放前 100–150 字
4. skillOverrides 四态（Plugin 内 Skill 不受此影响，需 /plugin disable；/skills 中 Space 循环后 Enter 写入 settings）：

值	对 Claude listing	/ 菜单
on	名字 + description	可见
name-only	仅名字	可见
user-invocable-only	不进 listing	可见（仅手动）
off	不进 listing	隐藏

5. 提高 skillListingBudgetFraction（治标，默认 0.01）

// ~/.claude/settings.json
{
  "skillListingBudgetFraction": 0.02,
  "maxSkillDescriptionChars": 1536,
  "skillOverrides": {
    "rare-skill": "name-only"
  }
}

保留标准

1. 过去一周至少用 3 次
2. 每次有明显效率提升
3. 属于核心工作流，不是「也许某天会用」

---

组合冲突

多个 Skill 的 description 相似时，Claude 可能选错。

手段	用法
差异化 description	写清唯一触发场景与关键词
disable-model-invocation: true	仅手动 /；description 不进 listing
paths frontmatter	只在匹配路径下激活
/skills 禁用其一	二选一保留
定期 /doctor	发现 dropped 与误触发

---

CC Switch 与多 Provider

• 换 Provider 不删 Skill 文件；习惯上 cc-switch skills sync
• CC Switch 管理的 Skill 在 ~/.cc-switch/skills/，同步到 ~/.claude/skills/
• 若 CLI 列表空：MCP 用 mcp import --app claude；Skill 用 scan-unmanaged + import-from-apps <目录> → sync（勿裸跑 import-from-apps）

---

更新与清理

/plugin update <plugin>
npx skills update
cd ~/.claude/skills/<name> && git pull

Plugin 更新后：/reload-plugins。
卸载：Plugin 用 /plugin 界面；npx 装的可 npx skills remove <skill> 或删目录 / cc-switch skills uninstall。

资料来源：Claude Code Skills 文档