AI不止语
785d0a9657
新增 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>
109 lines
4.2 KiB
Markdown
109 lines
4.2 KiB
Markdown
# Trae 集成
|
||
|
||
将本仓库的 215 个智能体转换为 Trae 项目级 rule 文件，安装到 `<your-project>/.trae/rules/`。Trae rule 与 Cursor `.mdc` 同源，差异在于扩展名 `.md` 与 IDE 内置的 rule 管理面板。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
# 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](https://github.com/jnMetaCode/agency-agents-zh/issues/59)。
|
||
|
||
`scripts/convert.sh` 转换出的每条 rule 默认 frontmatter：
|
||
|
||
```yaml
|
||
---
|
||
description: <角色一句话描述>
|
||
globs:
|
||
alwaysApply: false
|
||
---
|
||
```
|
||
|
||
这是 Cursor / Trae 共同约定的 **"agent-requested rule"** —— 模型读完 description 自己判断要不要拉进来。一旦你 `install --tool trae` 把 215 条 rule 全装上：
|
||
|
||
- description 之间相互稀释，模型很难命中"应该用哪一条"；
|
||
- 即便命中也只是"读一下这条 rule"，不会变成长期 system prompt；
|
||
- 全量装载会消耗大量上下文预算，IDE 通常会挑选性截断。
|
||
|
||
**结论**：默认全装 = 几乎不会自动触发。这是设计决定，不是安装失败。
|
||
|
||
## 三种正确的使用姿势
|
||
|
||
### 姿势一：精选安装（强烈推荐）
|
||
|
||
只装你真正会用的 10–20 条，让自动匹配真正生效：
|
||
|
||
```bash
|
||
# 先生成
|
||
./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：
|
||
|
||
```yaml
|
||
---
|
||
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`）后：
|
||
|
||
```bash
|
||
./scripts/convert.sh --tool trae
|
||
# 已经 install 过的项目需要重新跑一次 install --tool trae 才会同步
|
||
```
|