内置命令不够用?自己造
内置斜杠命令是「官方快捷键」。但你的工作有自己的重复动作——比如每次都让 Claude Code「按项目规范审查一遍」。这时候,把这一长串指令存成你自己的斜杠命令,以后敲一个 / 就触发。
思路:凡是你反复用、规则固定的操作,都值得固化成自定义命令。
todo 造一个 /review-todo 命令,把「审查 todo 代码」的固定套路固化下来——这正是自定义命令最典型的用法。什么是自定义斜杠命令
自定义命令把「一长段固定指令」绑定到一个简短的 /名字 上。调用它,就等于把那段指令完整发给了 Claude Code。
适用例子:
/review:按团队规范做代码审查/commit:按规范写提交信息/clean:清理没用的 import 和注释
怎么定义
自定义斜杠命令通常以配置文件的形式定义。以 Claude Code 的 .claude/commands 目录为例,你新建一个文件,文件名就是命令名:
.claude/commands/
review.md # 对应 /review
commit.md # 对应 /commit
文件内容就是你要固定下来的那套指令:
---
description: 按团队规范做一次代码审查
---
请以资深工程师身份,对本次改动做代码审查:
1. 检查逻辑错误、边界情况、异常处理
2. 指出可读性和性能问题
3. 只输出「必须改 / 建议改 / 可不改」三档,简短直给
保存后,在 Claude Code 里敲 /review,就会执行这套审查指令。
设计好命令的三个原则
- 规则固定:指令要能重复执行,别写一次性的东西
- 目标明确:命令只干一件事,别塞一堆
- 团队共享:把命令放进 Git 仓库,全组都能用
落地练习:给 todo 造一个 /review-todo
在 todo-app 里建自定义命令,让 Claude Code 以后每次按固定套路审查 todo:
- 建目录:
mkdir -p .claude/commands - 新建
.claude/commands/review-todo.md,内容:
---
description: 审查 todo 代码的规范与边界情况
---
审查这个 todo 工具的代码:
1. 是否处理了「没有待办」时的空状态
2. 待办名称是否允许为空,不允许的话有没有提示
3. 有没有遗漏的边界情况(超长名称、重复项等)
4. 按「必须改 / 建议改 / 可不改」三档输出,简短直给
- 在 Claude Code 里敲
/review-todo,执行这套审查
怎么判断做对了?——敲
/review-todo后,Claude Code 开始按这四条规则审查代码,而不是你临时描述。这就实现了「一次定义、反复复用」。
卡住了怎么办? 敲 /review-todo 没反应?文件路径或文件名拼错了,检查是不是 .claude/commands/ 下、文件名是 review-todo.md。命令弹出来了但内容不对?打开文件核对内容。
常见坑:把「一次性指令」固化成命令
新手容易把一次性的、带具体文件名的指令存成自定义命令,结果下次复用就过时了。
自定义命令应该是规则而不是个案。比如「审查 todo 代码」是可复用的规则;而「把 05 行改成 xxx」是一次性的。只固化规则,别固化个案。 否则命令用一两次就失效了。
小结
- 自定义命令 = 把固定指令绑定到
/名字 - 存在配置目录,文件名即命令名
- 规则固定、目标明确、团队共享
- 固化「规则」、别固化「个案」
- 我们给 todo 造好了
/review-todo
下一节,用 CLAUDE.md 让 Claude Code 长期记住你的偏好。