TraeCode CN是国内易获取的一款智能体编程开发(agent coding)平台。Agent coding指让AI智能体直接参与编码工作流它自主读取代码、调用工具终端、文件系统、外部服务、多步执行任务人只负责下达意图和审查结果。要让这套流程稳定、高性能地完成复杂任务最新Harness Engineering不局限于一次性提示词而进一步把“AI 该怎么做”写成文件配置。这些配置常包括以下几类规则是约束“永远先跑测试再提交”每次对话全量注入技能是操作手册“做代码审查的具体步骤”模型判断任务相关才读取子智能体是独立上下文的专职角色规划者、审查者由主智能体自动调度命令是/xxx形式的手动快捷指令钩子是工具调用前后自动执行的检查如保存即 lintMCP则负责把外部工具接入模型(如网页搜索)。这六类机制(规则、技能、子智能体、命令、钩子、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子智能体 SubagentSubagents - Documentation - TRAE自定义智能体Create and manage custom agents - Documentation - TRAE命令 CommandsCommands - Documentation - TRAEHook 配置参考Hook 配置详解添加 MCP Server添加 MCP Server权限审批权限审批概览官方社区(含配置 FAQ)TRAE 官方中文社区