如何在 Claude 中创建针对特定项目的自定义指令？

如何在 Claude 中创建针对特定项目的自定义指令？

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

想让 Claude 在处理特定项目时，自动遵循一套专属的规则、格式或流程吗？这完全可以通过创建项目级的自定义指令来实现。下面这套方法，能帮你把通用流程固化下来，确保团队协作时风格统一、效率倍增。

一、在项目根目录创建 commands 文件夹

想让指令只对当前项目生效，关键在于把它放在正确的位置。项目本地的 .claude/skills/ 或 .claude/commands/ 目录就是它们的“家”。Claude Code 启动时会自动识别并加载这些指令，而且项目级指令的优先级高于全局配置，能完美适配你当前代码库的独特结构和规范。

具体操作很简单：

1. 打开终端，导航到你的项目根目录。

2. 执行这条命令来创建技能目录：mkdir -p .claude/skills/project-specific。

3. 完成后，确认目录路径是：./.claude/skills/project-specific/。这就为专属指令准备好了空间。

二、编写带 YAML 头部的 SKILL.md 文件

光有文件还不够，得让 Claude 能“看懂”并“用好”它。这就需要 YAML frontmatter 来声明指令的元信息，比如名称、描述和参数提示。这样一来，指令在调用时就具备了可发现性和上下文感知能力，Claude Code 会解析这些信息，用于命令补全和执行控制。

跟着下面几步走：

1. 在刚才创建的 ./.claude/skills/project-specific/ 目录里，新建一个文件，命名为 api-test.md。

2. 在文件的开头，插入以下 YAML 头部：

---name: api-testdescription: 为当前选中的 Spring Boot Controller 方法生成 MockMvc 集成测试argument-hint: ---

3. 在 YAML 头部下面空一行，开始编写指令的正文。例如，可以这样写：“请为当前打开的 Ja va 类中名为 $ARGUMENTS 的 @PostMapping 或 @GetMapping 方法，生成使用 MockMvc 的集成测试。要求：- 测试类放在 src/test/ja va 对应包路径下；- 使用 @AutoConfigureMockMvc；- 覆盖 200 和 400 状态码场景。” 这里的 $ARGUMENTS 就是留给用户输入方法名的占位符。

三、通过 / 命令直接调用技能

文件保存好后，不需要重启 Claude，它会在下次会话中自动索引到这个新技能。调用方式非常直观——使用斜杠命令。系统会读取对应 .md 文件的内容，并把用户随后输入的文本作为参数注入到指令模板中。

来体验一下：

1. 在 Claude Code 编辑器中，打开一个 Spring Boot 控制器文件。

2. 在聊天输入框里，直接输入：/api-test handleOrder。

3. 接下来，Claude 就会自动定位到控制器中名为 `handleOrder` 的方法，并严格按照 `SKILL.md` 里定义的规则，生成一套完整的测试代码。整个过程一气呵成。

四、使用 CLAUDE.md 绑定项目级默认指令

如果希望团队里的每个成员都能方便地调用这些指令，而不需要记住复杂的路径，那么 `CLAUDE.md` 文件就是你的秘密武器。这个文件是项目级的上下文锚点，可以在里面声明默认启用的指令别名和行为偏好。Claude Code 每次启动时都会强制注入这个文件的上下文，因此它具有最高的执行优先级。

配置方法如下：

1. 首先，检查一下项目根目录下是否存在 CLAUDE.md 文件。如果没有，运行命令 claude /init 可以自动生成一个。

2. 打开 `CLAUDE.md` 文件，在底部添加如下配置区块：

```yamldefault-commands: - alias: /review target: .claude/skills/project-specific/code-review.md - alias: /deploy target: .claude/skills/project-specific/deploy-checklist.md```

3. 保存之后，神奇的事情发生了。在任何会话中，团队成员只需要输入 /review，其效果就等同于执行了 .claude/skills/project-specific/code-review.md 文件里的完整内容。这大大降低了使用门槛。

五、验证指令是否生效

指令配置好了，怎么确认它真的被 Claude 加载了呢？别担心，有内置的诊断命令可以快速验证。Claude Code 提供了实时的索引状态反馈，能有效避免因路径错误或语法问题导致的指令“静默失效”。

验证步骤很简单：

1. 在任意 Claude 会话中输入：/skills list。

2. 观察输出的列表。如果一切正常，你应该能看到类似 project-specific/api-test (loaded) 这样的条目。

3. 如果显示的是 (missing) 或者根本没有列出你的指令，那就需要回头检查一下了。常见的坑包括：文件路径是否含有空格、扩展名是不是 `.md`、或者 YAML 头部是否存在语法错误（比如冒号后面忘了加空格）。