☰
TraeCode CN自定义工作流配置的双层机制(Windows)
2026/10/21 6:33:04 网站建设 项目流程

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)
子智能体 SubagentSubagents - Documentation - TRAE
自定义智能体Create and manage custom agents - Documentation - TRAE
命令 CommandsCommands - Documentation - TRAE
Hook 配置参考Hook 配置详解
添加 MCP Server添加 MCP Server
权限审批权限审批概览
官方社区(含配置 FAQ)TRAE 官方中文社区

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询