TRAE SOLO 规则

你可以通过制定规则来规范 AI 在 TRAE SOLO 内的行为，包括代码风格、语言与框架、交互方式等，使 AI 的输出更符合你的个人偏好和项目要求。

应用场景

规则的主要应用场景如下：

• 提升效率

  将个人经验和项目要求转化为可复用的规则，一次配置可长期生效，减少与 AI 的沟通成本以及人工审校时间。

• 统一标准

  将团队规范、项目标准结构化为规则，使所有成员所负责的内容在风格、结构和质量上保持一致，避免偏差。

• 保障质量

  让 AI 明确项目的核心约束（架构设计、命名规范、代码风格等），避免常见错误。

规则类型

目前，TRAE SOLO 仅支持全局规则。你配置的所有规则会跨项目生效。

规则的运行环境

创建规则

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

1. 在界面左下角，点击 头像 > 设置，进入设置中心。

2. 在左侧导航栏中，选择 规则。

   你将进入规则管理面板。

3. (仅 TRAE SOLO 桌面版) 选择技能所运行的环境：本地 / 云端。
4. 点击 创建 按钮。
5. 在输入框中输入你的规则。

6. 点击 保存 按钮。

   

AGENTS.md、CLAUDE.md 和 CLAUDE.local.md

💡提示
仅 TRAE SOLO 桌面版支持 AGENTS.md、CLAUDE.md 和 CLAUDE.local.md。

• AGENTS.md 是一个位于项目根目录的轻量级 Markdown 文件，用于向 AI 智能体提供行为指引。它通过直观、易读的文本描述，明确智能体在项目中需遵守的指令和规范。AGENTS.md 中定义的规则为项目级规则，仅在当前项目中生效。

  在 TRAE SOLO 中创建的 AGENTS.md 文件可以在其他支持 AGENTS.md 的 IDE 中复用，反之亦然。

• TRAE 兼容 CLAUDE.md 和 CLAUDE.local.md。

  如果你已在 Claude Code 中创建项目并添加了 CLAUDE.md 和/或 CLAUDE.local.md，当将该项目导入 TRAE SOLO 时，这些文件会被一并导入。

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

1. 前往 设置 > 规则。

2. 在 导入设置 处，打开 将 AGENTS.md 包含在上下文中 和 将 CLAUDE.md 包含在上下文中 开关。

   

最佳实践

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

示例

基础交互

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

通用编码

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

重构

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

代码可读性

1. 命名约定：

   • 使用有意义的、描述性的名称。
   • 遵循项目或语言的命名规范。
   • 避免缩写和单字母变量（除非是约定俗成的，如循环中的 i）。

2. 代码组织：

   • 相关代码放在一起。
   • 函数只做一件事。
   • 保持适当的抽象层次。

3. 注释与文档：

   • 注释应该解释为什么，而不是做什么。
   • 为公共 API 提供清晰的文档。
   • 更新注释以反映代码变化。

性能优化

1. 内存优化：

   • 避免不必要的对象创建。
   • 及时释放不再需要的资源。
   • 注意内存泄漏问题。

2. 计算优化：

   • 避免重复计算。
   • 使用适当的数据结构和算法。
   • 延迟计算直到必要时。

3. 并行优化：

   • 识别可并行化的任务。
   • 避免不必要的同步。
   • 注意线程安全问题。