别盲目全量安装agency-agents-zh配合Cursor/Trae精选安装策略避开2个真实大坑【免费下载链接】agency-agents-zh 277 个即插即用的 AI 专家角色 — 支持 Claude Code/Cursor/Copilot 等 20 种工具覆盖工程/设计/营销/金融等 20 个部门。含 64 个中国市场原创智能体小红书/抖音/微信/飞书/钉钉/Qt 上位机/机械设计。搭配编排器 agency-orchestrator一句话即可让多位专家按 DAG 自动协作。项目地址: https://gitcode.com/gh_mirrors/ag/agency-agents-zhagency-agents-zh 是一套即插即用的AI 专家角色库内置 277 个 AI 专家角色支持 Cursor、Trae、Claude Code 等 20 种 AI 编程工具。这篇文章专门讲新手最容易踩痛点的精选安装如何在 Cursor/Trae 里只装 10–20 个常用专家避开匹配不准和装了从不触发这 2 个真实大坑。为什么全量安装反而更差先懂智能匹配机制agency-agents-zh 把每个专家转换成 Cursor 的.mdc规则或 Trae 的.md规则后默认都是智能匹配模式alwaysApply: false 空globs——AI 每次只读规则的description简介自己判断这个专家跟当前问题相不相关相关才加载。这个机制直接带来两个后果描述互相稀释规则一多200 多条 description 把话题铺得太散模型很难命中该用哪一条上下文被吃掉全量装载会占用大量上下文预算IDE 通常会选择性截断。结论一句话装得越少匹配越准。这就是精选安装的核心原理。大坑1Cursor 一次装满 200 多条规则自动匹配越来越不准官方文档 integrations/cursor/README.md 里就有明确警告一次启用全部 180 条规则会让 Cursor 扫描海量 description影响匹配准确度上下文也吃不消。实际表现是你问帮我审查这个组件的性能问题模型却给了很泛的通用回答完全没命中前端开发者专家——不是安装失败而是规则太多被稀释了。Cursor 精选安装三步走# 1. 获取角色库只需一次 git clone https://gitcode.com/gh_mirrors/ag/agency-agents-zh cd agency-agents-zh # 2. 生成 Cursor 规则文件.mdc ./scripts/convert.sh --tool cursor # 3. 只挑常用的复制到项目目录前端项目示例保留 4 条 cd /your/project mkdir -p .cursor/rules cp /path/to/agency-agents-zh/integrations/cursor/rules/engineering-frontend-developer.mdc .cursor/rules/ cp /path/to/agency-agents-zh/integrations/cursor/rules/engineering-code-reviewer.mdc .cursor/rules/ cp /path/to/agency-agents-zh/integrations/cursor/rules/engineering-backend-architect.mdc .cursor/rules/ cp /path/to/agency-agents-zh/integrations/cursor/rules/engineering-git-workflow-master.mdc .cursor/rules/装完重新打开项目两种方式使用自动触发在 Chat/Composer 正常提问Cursor 按 description 自动匹配专家手动指定在 Chat 里用规则名强制引用某个专家永远生效。 嫌挑文件麻烦也可以先全量安装再删掉.cursor/rules/里用不上的只留 10–20 条。大坑2Trae 规则装满了却几乎从不自动触发Trae 的规则与 Cursor 同源只是扩展名为.md、目录为.trae/rules/。这个坑更隐蔽装完全部规则后专家几乎从不自动触发新手很容易以为装坏了。其实这是设计行为不是 bug转换出的规则默认alwaysApply: false 空globs属于agent-requested rule——模型读完 description 自行决定是否加载。全装 200 多条后description 互相稀释几乎命中不到任何一条。详细说明见 integrations/trae/README.md。Trae 规则正确使用的 3 种姿势姿势怎么做适用场景① 精选安装强烈推荐只留 10–20 条常用规则在.trae/rules/单一技术栈项目想让自动匹配真正生效②显式调用对话里输入engineering-code-reviewer强制加载偶尔用某垂直角色不必常驻③ 核心规则改alwaysApply把 1–3 条高频规则改为始终生效代码审查标准、Git 工作流这类通用底线# Trae 精选安装示例 ./scripts/convert.sh --tool trae cd /your/project mkdir -p .trae/rules cp /path/to/agency-agents-zh/integrations/trae/rules/engineering-frontend-developer.md .trae/rules/ cp /path/to/agency-agents-zh/integrations/trae/rules/engineering-code-reviewer.md .trae/rules/⚠️千万别把所有规则都改成alwaysApply: true——上下文会爆角色之间还会互相打架。1–3 条为宜。精选安装清单该保留哪 10–20 个专家角色太多挑花眼打开 CATALOG.md智能体速查表CtrlF 直接搜中文名对照项目类型挑选前端/后端开发项目前端开发者、代码审查员、后端架构师、Git 工作流大师、安全工程师内容营销类小红书运营专家、抖音策略师、内容创作者架构与质量类软件架构师、数据库优化师、现实检验者比如 engineering/engineering-frontend-developer.md 定义了专家怎么思考、怎么交付engineering/engineering-code-reviewer.md 负责 PR 审查与质量把关marketing/marketing-xiaohongshu-operator.md 则输出完整的小红书种草策略。安装方式上下文占用自动匹配命中率维护成本❌ 全量安装200 条巨大低描述互相稀释高一堆用不上的规则✅ 精选安装10–20 条可控高选项少、易命中低跟着项目挑安装命令速查两步转换 安装工具规则格式安装位置关键命令Cursor.mdc项目目录.cursor/rules/./scripts/convert.sh --tool cursorTrae.md项目目录.trae/rules/./scripts/convert.sh --tool traeClaude Code / Copilot.md免转换全局目录./scripts/install.sh --tool claude-code完整命令与故障排查见 scripts/ 下的 convert.sh、install.sh以及 integrations/README.md 和主文档 README.md。常见问题规则看不到、不触发怎么办Cursor 看不到规则确认.cursor/rules/在项目根目录不是全局目录、扩展名是.mdc而不是.md然后重新打开项目Trae 的补全列表里没有新规则Trae 启动时只扫描一次目录装完要重启窗口规则不少了但模型回答还是很泛把目录里的规则文件砍到 10–20 条以内再试改了源智能体但没同步重跑./scripts/convert.sh已安装的项目再跑一次对应install.sh才会更新。小结全量安装 描述互相稀释 自动匹配几乎失效精选安装10–20 条才是 Cursor/Trae 用户的最优解拿不准装哪些就按项目技术栈 高频角色挑偶尔才用的垂直角色交给显式调用想让多位专家按流程自动协作出方案可继续参考 strategy/QUICKSTART.md 的编排玩法。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考