2.6 自定义命令
Claude Code 内置了可通过输入斜杠触发的命令,同时你也可以创建自己的自定义命令,用来自动化你经常执行的重复任务。
创建自定义命令
要创建自定义命令,需要在项目中设置特定的文件夹结构:
1.在项目目录找到 .claude文件夹。
2.在其中创建名为 commands 的新目录。
3.新建一个以命令名命名的 Markdown 文件(例如 audit.md)。
文件名就是命令名——因此 audit.md 会生成 /audit 命令。
示例:审计命令(Audit)
一个实用的自定义命令示例是审计项目依赖的安全性:
该审计命令执行三件事:
1.运行 npm audit 查找已安装包中的漏洞。
2.运行 npm audit fix 应用更新修复。
3.运行测试以验证更新未破坏现有功能。
创建命令文件后,你需要重启 Claude Code,才能识别新的命令。
带参数的命令
自定义命令可以通过 $ARGUMENTS 占位符接收参数,使其更灵活、可复用。
示例:write_tests.md 文件内容可能是:
Write comprehensive tests for: $ARGUMENTS
Testing conventions:
* Use Vitests with React Testing Library
* Place test files in a tests directory in the same folder as the source file
* Name test files as [filename].test.ts(x)
* Use @/ prefix for imports
Coverage:
* Test happy paths
* Test edge cases
* Test error states
你可以用文件路径来运行该命令:
/write_tests the use-auth.ts file in the hooks directory
参数不必是文件路径——也可以是任何你希望传递给 Claude、用于提供任务上下文和方向的字符串。
关键点
1.自动化:将重复的工作流变成单个命令。
2.一致性:确保每次都遵循相同的步骤。
3.上下文:为你的项目提供具体的指令与约定。
4.灵活性:通过参数让命令适配不同输入。
自定义命令对项目特定的工作流尤其有用,如运行测试套件、部署代码,或按团队约定生成样板代码。