命令字典
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
Slash 命令、CLI 子命令、Hook 事件、启动参数的字典与演进史。
重扫 skill 与 command 目录,让会话期间在磁盘上新增或改动的 skill 不必重启即可用;会报告可用/新增/移除数量。需 v2.1.152+。
/reload-skills/reload-skills 是 Claude Code CLI 中的会话内 slash 命令,作用是重新扫描 skill 与 command 目录,让你在会话进行中于磁盘上新增或修改的 skill 不必重启就能用上。
执行后它会报告当前有多少 skill 可用,以及本次新增 / 移除了多少个。
版本门槛:需要 Claude Code v2.1.152 或更高,该命令在 v2.1.152 引入。
它解决的是一个很具体的开发循环痛点:你正在写一个 skill,改完 SKILL.md 想立刻在当前会话里验证,但默认情况下 skill 目录只在 session 启动时扫描一次。/reload-skills 把这一步变成会话内的热刷新。
在会话内,消息开头直接输入:
/reload-skills
无需任何参数。执行后 Claude Code 会重扫 skill 与 command 目录,并把变更刷进运行时,然后回报可用 / 新增 / 移除的数量。
SKILL.md 或新建一个 skill 目录后,在同一会话验证。.claude/skills/,想免重启加载进来。| 约束 | 说明 |
|---|---|
| 版本 | 需 v2.1.152+ |
| 刷新范围 | skill 目录 + command 目录的重扫 |
| 仅限会话内手动触发 | 是 slash 命令,由你在会话里运行 |
/reload-skills 与 /reload-plugins 容易混淆,但它们不是别名,刷新对象不同:
| 命令 | 刷新对象 | 引入版本 | 备注 |
|---|---|---|---|
/reload-skills | skill 目录 + command 目录(重扫) | v2.1.152 | 报告 skill 可用 / 新增 / 移除数 |
/reload-plugins [--force] | 全部活跃插件(skills、agents、hooks、MCP servers 等组件) | v2.1.69 | 当刷新会改变已加载 MCP 工具并使 prompt cache 失效时会警告并跳过,除非 --force |
| 完整重启会话 | 全部(含 monitors、命令解析器索引) | — | 丢失当前会话上下文 |
简单记:改的是散装 skill / 命令文件用 /reload-skills;改的是装好的插件用 /reload-plugins;两者都覆盖不到的(如 monitors、/ 命令解析索引)才需要完整重启。
SKILL.md → 会话内 /reload-skills → 立刻用更新后的 skill 测一遍,不必反复重开会话。.claude/commands/ 调整多个命令文件后,一次 /reload-skills 让会话同步,省去重启。/reload-plugins 搞混:/reload-skills 针对散装 skill / command 目录的重扫;改动插件内部组件(agents、hooks、MCP server)要用 /reload-plugins。两者不是别名。/ 命令解析器索引等仍需完整重启或对应命令。/reload-skills 是一次性操作,运行后即结束,无需"退出"。不想用就不运行;如需让某些 skill 不被加载,应通过 skill 目录管理或相关 settings(如 strictPluginOnlyCustomization)控制来源,而非靠该命令。
重新扫描 skill 目录而无需重启会话