命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
显示已加载技能中未被使用的技能及其占用的 context 成本,便于清理精简
/skill-doctor 是 Claude Code 的诊断类 Slash 命令,用于报告当前会话中已加载的 Skill 里哪些从未被调用过,以及每个 Skill 在每轮对话中占用的 context 成本,帮助用户决定要精简掉哪些 Skill。官方文档明确要求 Claude Code v2.1.252 或更高版本,且在跳过 feature-flag 拉取的会话中不可用。该命令由官方在 v2.1.261(2026年9月4日发布)中新增,changelog 原文为:"Added /skill-doctor to show which loaded skills go unused and what they cost in context, so you can prune them"。
/skill-doctor
命令不带参数,直接在会话中输入即可。
在交互式终端会话中运行,报告会在 /plugin 管理器的 Stats 标签页中打开。
带 -p 参数的非交互调用下,命令会把报告以纯文本形式直接打印出来。
/skill-doctor 本身不写入配置文件,它只是一份只读报告;根据报告结果去关闭某个 Skill,需要用户自己去对应的 Skill 来源(用户设置 / 项目设置 / 插件)里做相应的开关操作。
| 约束 | 原因 |
|---|---|
| 需要 Claude Code v2.1.252 及以上版本 | 官方文档明确的版本门槛 |
| 无法在 Remote Control(手机 / 浏览器远程连接)会话中生成报告 | 该连接类型不支持获取技能使用统计,命令会返回"Skill usage reports are not available on this connection." |
| 统计范围仅覆盖会话中加载的普通 Skill,不包含内置(bundled)与企业(enterprise)Skill | 官方文档限定的统计口径 |
| 在跳过 feature-flag 拉取的会话中不可用 | 官方文档列出的前置条件 |
| 命令 | 定位 |
|---|---|
/doctor | 诊断 Claude Code 安装与设置是否正常(环境层面的健康检查) |
/skill-doctor | 诊断已加载 Skill 的使用率与 context 成本(配置精简层面) |
/plugin | 管理插件本身(安装 / 启停),/skill-doctor 的报告在交互式会话中即挂载在它的 Stats 标签页下 |
显示加载的技能中未使用的技能及其 context 成本,用于清理