TraeWork 的 Rules：把规矩写死，AI 才不会跑偏

2026-08-17

一、你每天都在重复交代的那几句话

用 AI 干活久了，会发现有一类话你每次开新对话都得重说一遍：回答用中文、注释写在关键逻辑上、别一口气生成两百行没结构的代码、命名别用单字母。说一次两次不烦，一天说八次就开始怀疑人生——更糟的是，你稍微忘了说一句，输出的东西就往另一个方向跑了，回头还得人工审一遍再让它改。

TraeWork 把这件事抽出来做成了 Rules。官方文档对它的定义写得很直白：通过制定规则来规范 AI 在 TraeWork 内的行为，包括代码风格、语言与框架、交互方式等，使输出更符合个人偏好和项目要求。文档给的三个应用场景分别是「提升效率」（把个人经验和项目要求转化为可复用的规则，一次配置长期生效，减少沟通成本与人工审校时间）、「统一标准」（把团队规范、项目标准结构化，让所有成员负责的内容在风格、结构和质量上保持一致）、「保障质量」（让 AI 明确项目的核心约束，如架构设计、命名规范、代码风格）。

值得注意的是文档自己的归类：在官方文档的导航里，规则（Rules）不是单独一个大类，而是挂在「上下文」这一组下面，和技能（Skills）、记忆、命令、MCP 是同级。这只是文档自身的目录归类，官方并没有解释为什么这么分组，我们也不替它引申。但把它和「记忆」「命令」放在同一组这件事本身值得记一笔——后面第三节会看到，官方在最佳实践里对规则的效力留了明确的余地。

二、官方文档写明它怎么用

两类规则，两个目录

文档写明可以配置两类规则：

全局规则：基于个人使用习惯和需求定制，在所有项目中生效。
项目规则：针对当前项目，仅在所配置的项目中生效。

存放位置文档也给了确切路径，注意 Windows 和 macOS/Linux 是分开写的：

规则类型	系统	目录
全局规则	macOS/Linux	`~/.trae-cn/user_rules`
全局规则	Windows	`%userprofile%/.trae-cn/user_rules`
项目规则	不分系统	项目所在路径下的 `.trae/rules/`

目录名是 .trae-cn，不是 .trae；而项目规则那个才是 .trae/rules/。这两个名字长得像但不一样，翻文档的时候容易看串。

本地和云端是两套，别指望互通

这是我觉得整页里最容易被忽略、又最容易咬人的一张表。官方文档专门列了「规则的运行环境」：

环境类型	适用任务	适用客户端
本地	仅对本地任务生效	TraeWork 桌面版
云端	仅对云端任务（及从 GitHub 拉取的项目）生效	TraeWork 网页版、桌面版

两行都写了「仅」。也就是说，你在本地环境下配的规则，按文档口径不会作用于云端任务；反过来也一样。如果你既在桌面版本地跑、又用网页版跑云端任务，那同一套规矩得配两遍。

创建全局规则的步骤

官方文档给出的步骤是：从头像进入设置中心，在左侧导航栏中选择「规则」，进入规则管理面板；仅 TraeWork 桌面版这一步需要选择运行环境（本地／云端）；然后点击「创建」，在输入框中输入规则，点击「保存」。

这里有一处文档措辞值得记一笔：这一步在原文里写的是「选择技能所运行的环境」，而这一节讲的是规则。文档里出现的是「技能」二字，我们照实抄出来，至于两者是否共用同一个环境开关，官方文档在这一页没有说明，不做推断。

创建项目规则的两种方式

方式一，手动创建：在目标项目的 .trae/rules/ 目录下创建 Markdown 格式的文件，把希望 AI 遵守的规则写进去并保存。文档没有对文件名、文件数量、单文件长度提出要求，也没有说明是否支持子目录——这些官方文档没有说明。

方式二，导入外部规则。这是对从别的工具迁过来的人最实用的一条：文档写明可以复用两类位于项目根目录的规则文件，它们同样属于项目级规则，仅在当前项目中生效。

AGENTS.md：面向 AI 的项目规则文件，用直观易读的文本描述项目内需遵守的指令和规范。文档自述它是跨工具的通用规范，在 TraeWork 中创建的 AGENTS.md 可在其他支持该规范的 IDE 中复用，反之亦然。
CLAUDE.md 和 CLAUDE.local.md：Claude Code 的项目规则文件，文档写明 TraeWork 与其兼容，从 Claude Code 迁移项目到 TraeWork 时，这些文件会随项目一并导入。

但这条路有两个前置条件，漏掉任何一个都等于没配：

文件必须在项目根目录。AGENTS.md 需要你手动放到项目根目录下；CLAUDE.md 和 CLAUDE.local.md 是在项目迁移时自动带入的。
必须去设置里把开关打开。文档写明路径是「设置 > 规则」，在「导入设置」处打开「将 AGENTS.md 包含在上下文中」和「将 CLAUDE.md 包含在上下文中」两个开关。

换句话说，把 AGENTS.md 丢进项目根目录这个动作本身不构成生效，开关是独立的一步。这是本页里最具体、也最容易漏的一处，你可以直接去官方文档「规则（Rules）」这一页的「方式二：导入外部规则」小节核对原文。

三、边界在哪：文档写死的限制，和文档没说的部分

这一段是本文的重点。Rules 听起来像「写下来就一定被遵守」，但官方文档自己划了几道线。

第一，AGENTS.md / CLAUDE.md / CLAUDE.local.md 只有桌面版支持。 文档里有一条独立的提示：仅 TraeWork 桌面版支持这三个文件。也就是说，网页版这条复用路径按文档口径是走不通的。加上前面那张运行环境表——本地任务只在桌面版、云端任务才涉及网页版——如果你的工作流以网页版为主，那么按文档写明的口径，这三个文件在网页版上就不在支持范围内；至于网页版是否另有等价的替代做法，官方文档在这一页没有说明。

第二，官方文档明说了「不保证」的那一处。 最佳实践里有这么一句：若项目中已有大量不符合规范的代码，模型可能会沿用现有代码风格而非遵循新规则。这是官方自己写下来的、承认规则可能不生效的场景，含金量比一堆功能介绍都高。文档同时给了三条应对建议：明确向模型说明当前任务为「重构」；在特定场景中强制要求 AI 严格遵循新规则；启动专门的重构项目，逐步提升整体代码质量。三条都是让人去补充说明或换打法，而不是承诺规则一定压得住既有代码风格。

第三，规则冲突由你负责，不是由系统负责。 最佳实践里写的是「各条规则之间不得彼此冲突或相互覆盖」——这是对写规则的人提的要求。至于当全局规则与项目规则同时存在、或两条规则打架时，系统按什么优先级处理、谁覆盖谁，官方文档在这一页没有说明。你不能默认「项目规则一定压过全局规则」，文档里没有这句话。

第四，改了规则不会自动追认已经开着的对话。 文档的建议是：新建或修改规则后，建议开启全新的对话再使用，以避免历史上下文与新规则产生冲突。这句话本身是「建议」，文档没有说明旧对话中规则的实际生效情况，我们也不替它下结论。

第五，一批常见问题官方文档在这一页没有说明，我按被问得多的顺序列出来，省得你去猜：单个项目或账号能配多少条规则、单条规则的长度上限、规则是否消耗积分、规则是否每一轮对话都会注入、能否让某条规则只对特定文件类型或特定目录生效、能否把规则打包分享给团队成员、项目规则文件的写法是否支持任何特殊语法——这些在本页文档里都没有写。另外，我们拿到的文档页顶部带有一条公告文字「重磅更新：以积分为核心的计费模式正式上线」，但本页正文没有涉及规则与积分的关系，所以计费口径请以官方最新公告与定价页为准。

第六，官方给的示例只能当范文，不能当保证。 文档「示例」一节列了五组标签：基础交互、通用编码、重构、代码可读性、性能优化，条目包括「所有回答都使用中文表述」「当生成的代码超过 20 行时，优先考虑是否可以进行适当的抽象或聚合」「避免多层嵌套，提前返回」「注释应该解释为什么，而不是做什么」「避免缩写和单字母变量（除非是约定俗成的，如循环中的 i）」等等。这些是示范怎么写规则，不是系统内置的检查项——文档没有说明模型对这些条目的遵守程度。

四、什么时候值得配，什么时候不必开

值得配的情况，基本都符合「同一句话你已经说过三次以上」这个特征：

你有固定的输出偏好，比如回答语言、注释密度、单个函数的规模。文档把这类归在全局规则——一次配置，所有项目生效。
团队有成文规范，希望不同人产出的东西风格一致。文档给的场景「统一标准」说的就是这个，对应的是项目规则，放在 .trae/rules/ 里跟着仓库走。
你从 Claude Code 或其他支持 AGENTS.md 的工具迁过来，手上已经有现成的规则文件。这时优先走方式二，别重写一遍——但记得桌面版才支持，且要去「导入设置」把对应开关打开。

不必急着开的情况：

你只是偶尔用一次，需求一次性。写规则本身是有维护成本的，最佳实践里那几条（控制单条规则的粒度、规则之间不得冲突、指定文件路径时使用相对于项目根目录的相对路径、引用规则时优先选择与当前任务强相关的规则）都是要人持续维护的。
你的项目里存量代码本身就不符合新规范。按文档自述的那句话，这种情况下模型可能沿用现有风格，此时更该做的是按文档建议明确声明这是「重构」任务，而不是指望多写几条规则把局面扳回来。
你主要在网页版上用云端任务。导入 AGENTS.md / CLAUDE.md 这条路文档写明只有桌面版支持，本地规则也不作用于云端任务，先把自己在哪个环境上跑这件事搞清楚，再决定规则配在哪一侧。

最后提醒一句：TraeWork 是仍在快速迭代的产品，文档页面本身也在更新，上面提到的目录名、开关名称、运行环境划分和最佳实践条目都可能随版本变动。真要动手配之前，去官方文档「规则（Rules）」这一页对一遍原文，尤其是那两个「包含在上下文中」的开关名和 .trae/rules/ 这个路径。

本文依据 TraeWork 官方文档（docs.trae.cn）于 2026-08-17 的公开内容整理。 我们没有开通付费账号，也没有实际操作过该产品，因此不涉及界面外观、操作手感与生成质量的任何描述。该产品仍在快速迭代，功能与计费口径随版本变动，文中涉及积分与套餐的表述均为复述官方文档原文，请以官方最新公告与定价页为准。