第 2 章 · 04 内置命令速查与最佳实践

第 2 章 · 04 内置命令速查与最佳实践

本节摘要:系统内置 55+ 个斜杠命令,本节给出常用速查(会话管理/上下文/导航/工具类),并总结命令设计的最佳实践(命名清晰动作导向、description 写清触发条件、单任务聚焦、副作用命令加保护、不硬编码敏感信息)与故障排查步骤(检查文件位置、frontmatter、重启会话、/help)。最后给出原书建议:不要为一次性任务建命令。

学习目标

阅读完本节,你应当能够:

1. 说出至少十个常用内置命令及其用途。
2. 背出命令设计最佳实践五条与禁忌三条。
3. 按步骤排查"命令不出现/不生效"的问题。

一、常用内置命令速查

会话与上下文:/help(帮助)、/clear(清空会话)、/compact(压缩上下文)、/rewind(回退,第 9 章)、/fork(复制到新独立后台会话,v2.1.212+)、/subtask(派生继承完整对话的 forked subagent,v2.1.212+)、/resume、/rename。

状态与信息:/status(当前状态)、/cost(费用)、/context(上下文占用)、/insights、/usage、/config(配置,输出样式等)、/doctor(诊断)、/version。

扩展:/memory(记忆编辑器,第 3 章)、/agents(子代理列表,第 5 章)、/skills(技能列表)、/hooks(钩子)、/mcp(MCP 管理,第 6 章)、/plugin(插件,第 8 章)、/keybindings(自定义快捷键)、/tasks(任务列表)、/sandbox(沙盒)、/export、/copy、/teleport(远程会话恢复)、/desktop(桌面应用)。

值得强调的小命令:/btw(不写入上下文的插话问题)、/fast(快速模式)、/upgrade(升级)。

注意:/review 已弃用改插件、/output-style 已移除改 /config → Output style、/vim 已弃用——以 /help 实际输出为准。

二、最佳实践(原书整理)

应做:

1. 命名清晰、动作导向(如 /fix-issue 而非 /issue);
2. description 写清触发条件,让模型知道何时该用;
3. 单任务聚焦,一条命令只做一件事;
4. 副作用命令加保护(disable-model-invocation);
5. 用 !` 注入动态上下文,让命令"看见"现状;
6. 配置入库版本管理,团队共享。

不做:

1. 不为一次性任务建命令;
2. 不硬编码敏感信息(用 ${ENV_VAR} 或占位符);
3. 不假设 Claude 知道当前状态(该注入就注入)。

三、故障排查

1. 检查文件位置(.claude/skills/<name>/SKILL.md 或 .claude/commands/<name>.md);
2. 检查 frontmatter 的 name 是否正确;
3. 重启会话(新文件需要重新加载);
4. /help 查看可用命令;
5. 同名 skill 与 command 冲突时,skill 优先——想用旧行为就删掉 skill。

小结

内置命令覆盖会话管理、上下文、状态与扩展入口;自定义命令的最佳实践可以浓缩为一句话:让命令像好的函数一样——单一职责、显式依赖、有安全边界。下一章从"快捷操作"进入"长期记忆":CLAUDE.md 与记忆系统。