agency-agents-zh 的 Trae 集成实战：rule 转换、安装与三种正确激活姿势-北京尧图网络

人工智能AI 技能提示工程【免费下载链接】agency-agents-zh 277 个即插即用的 AI 专家角色 — 支持 Claude Code/Cursor/Copilot 等 20 种工具覆盖工程/设计/营销/金融等 20 个部门。含 64 个中国市场原创智能体小红书/抖音/微信/飞书/钉钉/Qt 上位机/机械设计。搭配编排器 agency-orchestrator一句话即可让多位专家按 DAG 自动协作。项目地址https://gitcode.com/gh_mirrors/ag/agency-agents-zh点击查看免费下载本篇技术指南聚焦 agency-agents-zh 仓库中面向 Trae 的集成方案如何把仓库内的 276 个 AI 智能体角色转换为 Trae 项目级 rule 文件并安装到your-project/.trae/rules/同时彻底讲清楚装了但几乎不自动触发这一常见困惑的成因并给出精选安装、显式调用、alwaysApply三种真正可落地的激活方案。读完本文你将掌握 Trae rule 的完整生命周期——从生成、安装到按需激活与故障排查并能结合 scripts/convert.sh 与 scripts/install.sh 的源码理解其底层机制。Trae rule 与 Cursor.mdc同源的两种落地格式agency-agents-zh 是一个以即插即用 AI 专家角色为核心的仓库全部角色以带 YAML frontmatter 的.md文件组织在 engineering/、marketing/、design/、finance/ 等 20 个部门目录中。要让这些角色在 Trae 中生效需要先经过一次格式转换将仓库内 276 个智能体转换为 Trae 项目级 rule 文件安装到your-project/.trae/rules/。Trae rule 与 Cursor.mdc同源差异仅在于两点维度CursorTrae扩展名.mdc.md安装目录.cursor/rules/.trae/rules/rule 管理面板Cursor Settings → RulesTrae IDE 内置 rule 管理面板两个工具共用同一套 frontmatter 语义description/globs/alwaysApply所以仓库内 Cursor 集成说明中关于激活方式的思路同样适用于 Trae。正因同源转换脚本中对两者的处理几乎一致——从 convert.sh 源码可以看到convert_cursor与convert_trae两个函数生成的 frontmatter 结构完全相同唯一区别是输出扩展名.mdcvs.md与输出目录cursor/rules/vstrae/rules/。标准安装流程两步完成转换与部署Trae 属于**项目级project-scoped**工具因此安装必须在目标项目根目录执行而不是在 home 目录或仓库目录执行。完整流程分两步# 1. 在仓库目录生成 rule 文件 ./scripts/convert.sh --tool trae # 2. 切到目标项目根目录再安装项目级不要在 home 跑 cd /your/project /path/to/agency-agents-zh/scripts/install.sh --tool trae执行后会得到your-project/.trae/rules/agent-slug.md一批文件。第一步convert.sh 做了什么scripts/convert.sh 是一个纯 bash 转换器通过--tool trae只跑 Trae 转换分支。其核心流程在run_conversions主循环中遍历AGENT_DIRS声明的 20 个部门目录academic、company、design、engineering……见 scripts/convert.sh用find递归收集每个目录下的.md文件跳过首行不是---无 frontmatter的文件再用get_field提取源文件的name与description字段。关键转换函数是convert_traescripts/convert.shconvert_trae() { local file$1 local name description slug outfile body name$(get_field name $file) description$(get_field description $file) slug$(slugify_from_file $file) # 文件名去 .md → kebab-case slug body$(get_body $file) # 去掉 frontmatter 保留正文 outfile$OUT_DIR/trae/rules/${slug}.md mkdir -p $OUT_DIR/trae/rules cat $outfile HEREDOC --- description: ${description} globs: alwaysApply: false --- ${body} HEREDOC }三个值得注意的机制slug 直接取文件名slugify_from_file就是basename $file .md所以engineering-code-reviewer.md生成engineering-code-reviewer.md。这意味着 rule 文件名与仓库内角色文件一一对应也决定了后文调用的命名规则。正文原样保留源角色的完整身份、规则、工作流全部透传只有 frontmatter 被重写为标准 rule 三字段。输出目录产物落在仓库的integrations/trae/rules/该目录由 convert.sh 生成已被仓库.gitignore排除属于运行时产物而非版本库内容。转换数量以当前仓库实际角色数为准。原集成文档撰写时约为 215 条而当前仓库经 scripts/check-counts.mjs 校验的角色总数是276 个AGENT-LIST.md 同步记录每次convert.sh --tool trae都会按当下仓库内容全量重新生成。第二步install.sh 如何部署scripts/install.sh 的install_trae函数scripts/install.sh做的工作非常直接install_trae() { local src$INTEGRATIONS/trae/rules local dest${PWD}/.trae/rules ... mkdir -p $dest while IFS read -r -d f; do cp $f $dest/; (( count )) || true done (find $src -maxdepth 1 -name *.md -print0) ok Trae: $count 个规则 - $dest warn Trae: 项目级安装。请在项目根目录运行。 }注意dest${PWD}/.trae/rules—— 目标目录是当前工作目录下的.trae/rules这正是文档强调切到目标项目根目录再安装的原因。如果误在 home 目录运行规则会被装到 home 下的.trae/rules/Trae 项目将完全看不到。这也是 integrations/README.md 中For project-scoped tools such as OpenCode, Cursor, Aider, and Windsurf, run the installer from your target project root所描述的项目级工具通用约束。为什么几乎不自动触发是预期行为不是 bug这是使用 Trae 集成时最容易踩的认知坑仓库已在 issue #59 中专门讨论过。问题的根源在于convert_trae生成的默认 frontmatter--- description: 角色一句话描述 globs: alwaysApply: false ---这是 Cursor / Trae 共同约定的agent-requested rule——模型读完description后自己判断要不要把这条 rule 拉进当前上下文而不是无条件常驻。一旦你install --tool trae把全部 276 条 rule 一次性装进项目就会出现三重问题description 相互稀释276 条描述同时存在于候选集里模型很难判断当前任务应该命中哪一条命中不等于常驻即便某条被命中也只是读一下这条 rule不会变成长期生效的 system prompt上下文预算被挤占全量装载会消耗大量上下文预算IDE 通常会挑选性截断反而影响模型表现。结论默认全装几乎不会自动触发。这是设计决定不是安装失败。理解了这一点下面的三种正确姿势才有意义。三种正确的使用姿势姿势一精选安装强烈推荐只装你真正会用的 10–20 条让自动匹配真正生效。两种做法任选# 先生成 ./scripts/convert.sh --tool trae # 再按需复制rule 文件生成于仓库 integrations/trae/rules/ 下 mkdir -p /your/project/.trae/rules cp integrations/trae/rules/engineering-frontend-developer.md /your/project/.trae/rules/ cp integrations/trae/rules/engineering-code-reviewer.md /your/project/.trae/rules/ cp integrations/trae/rules/engineering-backend-architect.md /your/project/.trae/rules/ cp integrations/trae/rules/engineering-git-workflow-master.md /your/project/.trae/rules/ # ... 按当前项目的语言/框架/职责挑或者更直接先全装再到.trae/rules/把用不上的删掉。筛选时可以参考 AGENT-LIST.md 中每个角色的 ID 与描述例如前端项目挑engineering-frontend-developer、需要代码审查挑engineering-code-reviewer、重视质量门禁挑engineering-git-workflow-master。每挑一条description的稀释程度就低一分自动命中的概率就高一分。姿势二在对话里显式调用即使全装你也可以在 Trae Chat / Builder 里手动指定强制加载某条 ruleengineering-pc-host-engineer 帮我审查这段 QSerialPort 的粘包处理 engineering-code-reviewer 看下这次提交的安全风险后输入rule 文件名去掉.md即可定向加载。这条路径永远生效不依赖模型的自动判断是处理低频但重要的垂直角色的最可靠方式。姿势三把高频 rule 改为 alwaysApply挑 1–3 条绝大多数对话都需要的规则如代码审查标准、git 工作流手动改其 frontmatter--- description: ... globs: **/*.ts,**/*.tsx # 也可按文件类型自动挂载 alwaysApply: true # 始终生效 ---globs支持按文件类型自动挂载——例如只对 TypeScript 文件生效时写**/*.ts,**/*.tsx相当于把这条 rule 变成特定场景下的常驻专家。但务必遵守一条红线⚠️ 不要把所有 rule 都改成alwaysApply: true——会爆上下文且角色之间互相打架。对照表什么时候用哪种场景推荐姿势单一技术栈纯前端 / 纯 Qt / 纯 K8s 运维姿势一精选 5–10 条姿势三核心 1–2 条 alwaysApply多面手项目今天前端、明天后端、后天写文档姿势一精选 15–20 条姿势二按需偶尔用一下某个垂直角色小红书运营 / 直播电商姿势二调用即可不必常驻故障排查.trae/rules/里有文件但 Trae 看不到确认在项目根目录而不是 home 目录重启 Trae 一次扩展名必须是.md不是.mdc。rule-name补全列表里看不到刚装的 ruleTrae 启动时扫描一次目录新装后需要重启窗口。装了一堆但模型还是答得很泛参见上文几乎不自动触发——把.trae/rules/里的文件砍到 10–20 条以内再试。想看每条 rule 的 description直接head -5rule 文件即可frontmatter 一目了然。重新生成与同步修改了源 agentengineering/、marketing/等目录下的.md后需要重新生成并重新安装才能生效./scripts/convert.sh --tool trae # 已经 install 过的项目需要重新跑一次 install --tool trae 才会同步这背后的逻辑与安装步骤完全对称convert.sh负责把源角色重新渲染为integrations/trae/rules/下的新产物install.sh负责把新产物重新复制到项目的.trae/rules/。如果源角色文件本身有变动而忘记重跑两步项目里跑的还是旧版 rule——这也是 scripts/check-counts.mjs 这类自检脚本存在的意义它会在发布前校验文档中声明的角色数与仓库实际角色数一致防止计数悄悄滞后。小结Trae 集成是 agency-agents-zh 多工具适配中的一环其核心心智模型可以浓缩为三句话rule 是 agent-requested 而非常驻的所以默认全装不触发项目级工具必须在项目根目录安装所以cd /your/project是关键步骤10–20 条精选 1–2 条 alwaysApply 按需是黄金组合所以别贪多。掌握了这三条再配合 convert.sh 与 install.sh 的源码理解你就能在这 276 个专家角色中按需取用让 Trae 的自动匹配真正为你工作。赞分享人工智能AI 技能提示工程【免费下载链接】agency-agents-zh 277 个即插即用的 AI 专家角色 — 支持 Claude Code/Cursor/Copilot 等 20 种工具覆盖工程/设计/营销/金融等 20 个部门。含 64 个中国市场原创智能体小红书/抖音/微信/飞书/钉钉/Qt 上位机/机械设计。搭配编排器 agency-orchestrator一句话即可让多位专家按 DAG 自动协作。项目地址https://gitcode.com/gh_mirrors/ag/agency-agents-zh点击查看免费下载相关推荐agency-agents-zh 与 Claude Code 零转换集成指南从安装、激活到源码级原理agency agents zh 与 Claude Code 零转换集成指南从安装、激活到源码级原理本篇技术指南以 integrations/claude人工智能AI 技能提示工程agency-agents-zh 接入 GitHub Copilot 实战指南零转换安装、自然语言激活与源码级原理解析agency agents zh 接入 GitHub Copilot 实战指南零转换安装、自然语言激活与源码级原理解析导读本文以开源仓库 agency a人工智能AI 技能提示工程agency-agents-zh 接入 OpenCode子智能体的安装、激活与 YAML 格式全解析agency agents zh 接入 OpenCode子智能体的安装、激活与 YAML 格式全解析本篇技术指南聚焦 agency agents zh 仓库人工智能AI 技能提示工程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

agency-agents-zh 的 Trae 集成实战：rule 转换、安装与三种正确激活姿势

相关推荐

向量内积在归一化空间中的数学等价性：Dot Product 与 Cosine 性能对比

WAL 预写日志的持久化折中：fsync 刷盘频率与组提交 Group Commit 性能测试

算子融合与计算图优化：FlashAttention-3 内核在最新大模型推理中的集成实践

更多资讯

C#调用USB摄像头实战：DirectShow/AForge/OpenCvSharp选型与避坑指南

中控Java二次开发demo实战：跑通、避坑与封装指南

C# TCP/IP最简例程：TcpClient与TcpListener服务端客户端互通指南

插件加载与激活失败：IAR、web boot与MusicFree排查指南

Chrome DevTools MCP 实战完整教程：把 MCP 配置改到 TaoToken 的调试链路

openrig 配置编排指南：Claude Code 与 Codex 多模型环境装配实践

今日更新

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？