github-featured/jnmetacode--agency-agents-zh

Files

T

AI不止语 785d0a9657 feat: 新增机械设计工程师 + 完善 Trae 集成文档 (closes #60 #59 )

新增 1 个原创智能体（214→215，原创 49→50，工程部 34→35）：
  engineering/engineering-mechanical-design-engineer.md
  - 通用机械产品设计专家：方案选型、传动/机构/结构件/连接设计
  - 计算校核四件套（强度/刚度/疲劳/振动）—— 振动按 issue #60
    要求作为重中之重单列，给出避开共振 ±20% 的硬指标
  - DFMA 检查清单（零件数/对称化/防呆/标准件占比）
  - GB/ISO/JIS 标准件优先 + GB/T 1800/1804/3480/T 17450 等国标体系
  - 8 段技术交付物示例：齿轮接触强度、轴疲劳合成、螺栓预紧、
    振动模态、流体压力损失、BOM 与图纸交付清单等

针对 issue #59「Trae 装好了几乎不自动触发」补齐文档：
  integrations/trae/README.md（新增）
  - 解释 alwaysApply: false + 空 globs = "agent-requested rule"
    的设计行为，全装 215 条 description 互相稀释是预期不是 bug
  - 给出三种正确姿势：精选安装 / @ 显式调用 / 改 alwaysApply
  - 三种姿势对照表（按使用场景推荐）+ 故障排查清单
  README.md / README.zh-TW.md
  - Trae 折叠区从 7 行扩成 ~25 行，与 Cursor 区块对齐

索引同步：AGENT-LIST/CATALOG/README/README.zh-TW/package.json
全部对齐到 215/50 原创/工程 35；package.json 1.2.0 → 1.2.1。

参考 issue #60 中 @H-i-m-s 给出的能力大纲（传动/结构件/运动机构/
连接/流体气动液压/材料热处理 + 计算校核 + DFMA + 国标），#59
由 @liliy886 提出的"装好了不触发"反馈定位为文档缺失。

Co-Authored-By: H-i-m-s <H-i-m-s@users.noreply.github.com>
Co-Authored-By: liliy886 <liliy886@users.noreply.github.com>

2026-05-06 14:55:41 +08:00

4.2 KiB

Raw Permalink Blame History

Trae 集成

将本仓库的 215 个智能体转换为 Trae 项目级 rule 文件，安装到 <your-project>/.trae/rules/。Trae rule 与 Cursor .mdc 同源，差异在于扩展名 .md 与 IDE 内置的 rule 管理面板。

安装

# 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 一批文件。

关于"几乎不自动触发"——这是预期行为，不是 bug

对应 issue #59。

scripts/convert.sh 转换出的每条 rule 默认 frontmatter：

---
description: <角色一句话描述>
globs:
alwaysApply: false
---

这是 Cursor / Trae 共同约定的 "agent-requested rule" —— 模型读完 description 自己判断要不要拉进来。一旦你 install --tool trae 把 215 条 rule 全装上：

description 之间相互稀释，模型很难命中"应该用哪一条"；
即便命中也只是"读一下这条 rule"，不会变成长期 system prompt；
全量装载会消耗大量上下文预算，IDE 通常会挑选性截断。

结论：默认全装 = 几乎不会自动触发。这是设计决定，不是安装失败。

三种正确的使用姿势

姿势一：精选安装（强烈推荐）

只装你真正会用的 10–20 条，让自动匹配真正生效：

# 先生成
./scripts/convert.sh --tool trae

# 再按需复制
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/ 删掉用不上的（更直接）。

姿势二：在对话里显式 @ 调用

即使全装，你也可以在 Trae Chat / Builder 里手动指定：

@engineering-pc-host-engineer 帮我审查这段 QSerialPort 的粘包处理
@engineering-code-reviewer 看下这次提交的安全风险

@ 后输入 rule 文件名（去掉 .md）即可定向加载。这条永远生效，不依赖模型的自动判断。

姿势三：把高频 rule 改为 alwaysApply

挑 1–3 条绝大多数对话都需要的（如代码审查标准、git 工作流），手动改其 frontmatter：

---
description: ...
globs: "**/*.ts,**/*.tsx"   # 也可按文件类型自动挂载
alwaysApply: true            # 始终生效
---

⚠️ 不要把所有 rule 都改成 alwaysApply: true——会爆上下文，且角色之间互相打架。

对照表：什么时候用哪种

场景	推荐姿势
单一技术栈（纯前端 / 纯 Qt / 纯 K8s 运维）	姿势一（精选 5–10 条） + 姿势三（核心 1–2 条 alwaysApply）
多面手项目，今天前端、明天后端、后天写文档	姿势一（精选 15–20 条） + 姿势二（按需 @）
偶尔用一下某个垂直角色（小红书运营 / 直播电商）	姿势二（@ 调用即可，不必常驻）

故障排查

.trae/rules/ 里有文件但 Trae 看不到：确认在项目根目录而不是 home 目录；重启 Trae 一次；扩展名必须是 .md，不是 .mdc。
@<rule-name> 补全列表里看不到刚装的 rule：Trae 启动时扫描一次目录，新装后需要重启窗口。
装了一堆但模型还是答得很泛：参见上文"几乎不自动触发"——把 .trae/rules/ 里的文件砍到 10–20 条以内再试。
想看每条 rule 的 description：直接 head -5 rule 文件即可，frontmatter 一目了然。

重新生成

修改了源 agent（engineering/、marketing/ 等目录下的 .md）后：

./scripts/convert.sh --tool trae
# 已经 install 过的项目需要重新跑一次 install --tool trae 才会同步

4.2 KiB Raw Permalink Blame History Unescape Escape