TraeCode CN是国内易获取的一款智能体编程开发(agent coding)平台。Agent coding指让AI智能体直接参与编码工作流:它自主读取代码、调用工具(终端、文件系统、外部服务)、多步执行任务,人只负责下达意图和审查结果。要让这套流程稳定、高性能地完成复杂任务,最新Harness Engineering不局限于一次性提示词,而进一步把“AI 该怎么做”写成文件配置。这些配置常包括以下几类:规则是约束(“永远先跑测试再提交”),每次对话全量注入;技能是操作手册(“做代码审查的具体步骤”),模型判断任务相关才读取;子智能体是独立上下文的专职角色(规划者、审查者),由主智能体自动调度;命令是/xxx形式的手动快捷指令;钩子是工具调用前后自动执行的检查(如保存即 lint);MCP则负责把外部工具接入模型(如网页搜索)。
这六类机制(规则、技能、子智能体、命令、钩子、MCP)在 TraeCode CN 中都有“全局(用户级)-项目”的双层结构,可见范围、优先级等较为复杂,本文进行了整理。
六个机制的设置文件路径与加载方式
| 机制 | 项目级路径 (项目路径下) | 全局级路径 (通常在 C:/用户/{用户字段}/) | UI创建方式 | 加载方式 |
|---|---|---|---|---|
规则 Rules | \.trae\rules\*.md | %userprofile%\.trae-cn\user_rules\ | 设置-规则与记忆-创建-项目/全局 | 每次对话注入全局+本项目规则,按设定生效, 优先级:用户输入>自定义Agent Prompt>全局规则>本项目规则 |
技能 Skills | .trae\skills\<名>\SKILL.md | %userprofile%\.trae-cn\skills\ | 设置-技能与命令-创建-项目/全局 | 根据技能内容由模型按需加载,全局技能对所有项目可见,项目技能仅对当前项目可见 |
| 子智能体 Subagents | .trae\agents\*.md | %userprofile%\.trae-cn\agents\*.md | - | 全局agent所有该用户项目可调用,项目agent仅当前项目可调用,由内置Agent按description字段自动调度,独立上下文 |
| 命令 Commands | .trae\commands\*.md | %userprofile%\.trae-cn\commands\ | 设置-技能与命令-命令-创建-项目/全局 | 全局命令所有该用户项目可触发,项目命令仅当前项目可触发,显式 /xxx 触发 |
钩子 Hooks | .trae\hooks.json | %userprofile%\.trae-cn\hooks.json | 设置-Hooks-项目/全局-创建 | 全局钩子对该用户所有项目工作区生效,项目钩子仅对当前项目工作区生效,工具调用前/进行中/后自动执行 |
| MCP | .trae\mcp.json | 官方文档未说明 | 项目:- 全局:设置-MCP | 全局MCP对所有项目生效,项目MCP仅对当前项目生效 |
注意:在安全机制上,TraeCode CN还有一项“权限审批”(permission mode),可在设置-权限审批-权限模式配置(需要“设置-Beta-新权限体系-启用权限系统”保持开启)。自定义配置的全局级配置的文件路径是%userprofile%\.trae-cn\permission\global.json;无项目级配置。当权限审批与钩子均有配置时,拦截规则采取两者并集,放行规则采取两者并集。
注意:使用子智能体,需要在设置-Beta-“启用Subagents目录”保持开启;子智能体需用文件创建,和“自定义智能体”(设置-智能体-创建)不是同一概念;仅内置智能体 “Agent” 可调用子智能体;项目级子智能体会覆盖同名全局子智能体,同级子智能体中如有同名,先加载的覆盖其他;启用项目级MCP须在设置-MCP中启用;全局和项目级子智能体以及项目级MCP可以通过文件配置,目前无UI;通过文件配置的机制会自动扫描,无需额外“注册”,如无法使用,可尝试重启会话或重启TraeCode CN,启用的全局级技能需保证在“设置-技能与命令-技能”中开关保持打开状态,启用的全局级MCP须在“设置-MCP-已配置的MCP Servers-MCP Servers管理”中开关保持打开状态,启用全局或项目级钩子需在“设置-Hooks”中配置钩子后“已配置的Hooks”保持开启;检查机制配置是否加载成功,一个简单的办法是直接问会话AI。
区分:自定义智能体 ≠ 子智能体
TRAE 有两个功能英文都叫 agent,中文分别译为"自定义智能体"和"子智能体",完全是两回事:
| 自定义智能体 | 子智能体 Subagent | |
|---|---|---|
| 创建 | UI 创建(对话框输入@或设置-智能体) | 自己写 .md 文件,无创建按钮 |
| 存储 | 应用内部状态,官方未公开文件位置 | 明确文件路径(见上表) |
| 上下文 | 与当前对话共享 | 独立上下文,过程不污染主对话 |
| 调用 | @提及 | 按 description 自动匹配,仅内置 Agent 触发 |
| 迁移 | 分享链接导入导出 | 直接拷文件,天然 git 版本化 |
配置建议
全局仅配置各项的"最大公约数",其余在各项目配置。
尽可能避免同名子智能体、命令,避免矛盾的规则、钩子。
子智能体、技能description字段清晰明确,说明调用场景。
官方文档链接
| 规则 Rule | 规则(Rule) |
| 技能 Skill | 技能(Skill) |
| 子智能体 Subagent | Subagents - Documentation - TRAE |
| 自定义智能体 | Create and manage custom agents - Documentation - TRAE |
| 命令 Commands | Commands - Documentation - TRAE |
| Hook 配置参考 | Hook 配置详解 |
| 添加 MCP Server | 添加 MCP Server |
| 权限审批 | 权限审批概览 |
| 官方社区(含配置 FAQ) | TRAE 官方中文社区 |