> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

你可以通过制定规则来规范 AI 在 TRAE Work 内的行为，包括代码风格、语言与框架、交互方式等，使 AI 的输出更符合你的个人偏好和项目要求。
## 应用场景 {#52698df2}
规则的主要应用场景如下：

* **提升效率**
   将个人经验和项目要求转化为可复用的规则，一次配置可长期生效，减少与 AI 的沟通成本以及人工审校时间。
* **统一标准**
   将团队规范、项目标准结构化为规则，使所有成员所负责的内容在风格、结构和质量上保持一致，避免偏差。
* **保障质量**
   让 AI 明确项目的核心约束（架构设计、命名规范、代码风格等），避免常见错误。

## 规则类型 {#8d656520}
目前，TRAE Work 仅支持全局规则。你配置的所有规则会跨项目生效。
## 规则的运行环境 {#3662a96b}
<!-- @cols-width: 126,335,256 -->
| | | | \
|**环境类型** |**适用任务** |**适用客户端** |
|---|---|---|
| | | | \
|本地 |仅对本地任务生效。 |TRAE Work 桌面版 |
| | | | \
|云端 |仅对云端任务（及从 GitHub 拉取的项目）生效。 |TRAE Work 网页版、桌面版 |

## 创建规则 {#88d5fe12}
根据实际需求，创建一条或多条规则。步骤如下：

1. 在界面左下角，点击 **头像** > **设置**，进入设置中心。
2. 在左侧导航栏中，选择 **规则**。
   你将进入规则管理面板。
3. (仅 TRAE Work 桌面版) 选择技能所运行的环境：**本地** / **云端**。
4. 点击 **创建** 按钮。
5. 在输入框中输入你的规则。
6. 点击 **保存** 按钮。
   ![Image=1752x555](https://p16-arcosite-sg.ibyteimg.com/tos-alisg-i-k9wyc2ijk0-sg/d536cdb3f2844c6384fa211168ed20c4~tplv-k9wyc2ijk0-image.image)

## AGENTS.md、CLAUDE.md 和 CLAUDE.local.md {#14435a48}
:::tip 提示
仅 TRAE Work 桌面版支持 AGENTS.md、CLAUDE.md 和 CLAUDE.local.md。
:::

* AGENTS.md 是一个位于项目根目录的轻量级 Markdown 文件，用于向 AI 智能体提供行为指引。它通过直观、易读的文本描述，明确智能体在项目中需遵守的指令和规范。AGENTS.md 中定义的规则为项目级规则，仅在当前项目中生效。
   在 TRAE Work 中创建的 AGENTS.md 文件可以在其他支持 AGENTS.md 的 IDE 中复用，反之亦然。
* TRAE 兼容 CLAUDE.md 和 CLAUDE.local.md。
   如果你已在 Claude Code 中创建项目并添加了 CLAUDE.md 和/或 CLAUDE.local.md，当将该项目导入 TRAE Work 时，这些文件会被一并导入。

若要使 AGENTS.md、CLAUDE.md 和 CLAUDE.local.md 文件在 TRAE Work 中生效：

1. 前往 **设置** > **规则**。
2. 在 导**入设置** 处，打开 **将** **AGENTS.md 包含在上下文中** 和 **将** **CLAUDE.md 包含在上下文中** 开关。
   ![Image=1744x391](https://p16-arcosite-sg.ibyteimg.com/tos-alisg-i-k9wyc2ijk0-sg/8ca4e75aeddb470188887ffc62a27040~tplv-k9wyc2ijk0-image.image)

## 最佳实践 {#a66f0180}

* 控制单条规则的内容粒度，避免在一条规则中包含过多信息，使其保持清晰、聚焦、易于理解。
* 各条规则之间不得彼此冲突或相互覆盖。
* 在指定文件路径时，使用相对于项目根目录的相对路径，以确保 AI 能准确定位文件。
* 引用规则时，优先选择与当前对话或任务强相关的规则。
* 新建或修改规则后，建议开启全新的对话再使用，以避免历史上下文与新规则产生冲突。
* 若项目中已有大量不符合规范的代码，模型可能会沿用现有代码风格而非遵循新规则。此时建议：
   * 明确向模型说明当前任务为“重构”；
   * 在特定场景中强制要求 AI 严格遵循新规则；
   * 启动专门的重构项目，逐步提升整体代码质量。

## 示例 {#7b4d7ebd}

:::: tabs
@tab 基础交互
* 所有回答都使用中文表述。
* 如需提供代码，为关键逻辑和可能造成理解困难的部分添加简明的中文注释。
* 当生成的代码超过 20 行时，优先考虑是否可以进行适当的抽象或聚合。

@tab 通用编码
* 避免不必要的对象复制或克隆。
* 避免多层嵌套，提前返回。
* 使用适当的并发控制机制。

@tab 重构
1. 小步重构：
   * 每次只做一个小改动，然后测试。
   * 频繁提交，保持代码随时可工作。
2. 测试保障：
   * 重构前确保有足够的测试。
   * 每次修改后运行测试，确保行为不变。
3. 代码审查：
   * 重构后进行代码审查，确保质量。

@tab 代码可读性
1. 命名约定：
   * 使用有意义的、描述性的名称。
   * 遵循项目或语言的命名规范。
   * 避免缩写和单字母变量（除非是约定俗成的，如循环中的 `i`）。
2. 代码组织：
   * 相关代码放在一起。
   * 函数只做一件事。
   * 保持适当的抽象层次。
3. 注释与文档：
   * 注释应该解释为什么，而不是做什么。
   * 为公共 API 提供清晰的文档。
   * 更新注释以反映代码变化。

@tab 性能优化
1. 内存优化：
   * 避免不必要的对象创建。
   * 及时释放不再需要的资源。
   * 注意内存泄漏问题。
2. 计算优化：
   * 避免重复计算。
   * 使用适当的数据结构和算法。
   * 延迟计算直到必要时。
3. 并行优化：
   * 识别可并行化的任务。
   * 避免不必要的同步。
   * 注意线程安全问题。

::::