Claude Code 实战-2.6 自定义命令

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.灵活性:通过参数让命令适配不同输入。

自定义命令对项目特定的工作流尤其有用,如运行测试套件、部署代码,或按团队约定生成样板代码。

发表回复