> **摘要**: 专门给别人仓库做体检的开源工具，自己却从没被系统体检过——这是工具型项目的通病。本文记录用全新 TRAE 多 Agent 并行模式，给一个 Rust workspace 做全量体检的完整过程：4 个 Agent 按错误处理审计、测试覆盖盘点、规范一致性、报告汇总分工，先约输出路径与串并行顺序，再并行执行，19 分 17 秒扫完全库，产出 132 行报告和 7 条修复建议，并当场为找出的零覆盖公开函数补齐测试闭环。体检完再让工具自己的 CLI 扫自己一遍，"Agent 代码质量视角"与"工具仓库健康视角"交叉验证一致。4 Agent 分工话术全文放在文末福利资源包，可直接复用到任何工程。


![需求话术投喂后，TRAE 输出四个 Agent 的任务书、路径约定与时序安排](https://developer.qcloudimg.com/http-save/yehe-2059497/ba0aa2afb9898e50ffa07ab4f1659598.png)

## 写在前面

「仓衡 RepoBalance」是我在某云端研发平台上独立开发并开源的 Rust + Tauri 2 桌面应用，做的事很简单：对本地 Git 仓库做健康度体检，看大文件、僵尸分支、提交习惯、依赖健康、敏感信息残留。代码托管在 AtomGit（G-Star 认证）和 GitHub。

![仓衡 RepoBalance 主界面：纯本地运行，按接入仓库 → 体检扫描 → 报告仪表盘 → 历史对比四步走](https://developer.qcloudimg.com/http-save/yehe-2059497/693ae439bfae552c678ef7b163326b10.png)

它有个尴尬的地方：专门给别人仓库做体检，自己却从没被系统体检过。迭代到现在，`crates/**` 里已经攒了不少 `unwrap()`、零覆盖的公开函数和散落的 TODO，我平时靠人肉抽查，根本查不过来。

正好全新 TRAE 支持多 Agent 并行，我打算把这事交给它：4 个 Agent 按不同维度同时把全库扫一遍。扫完之后顺手做了个更有意思的实验——让仓衡的 CLI 把自己也扫一遍，看看 AI Agent 和体检工具各自能看到什么。本文记录的就是这次折腾的全过程。

## 一、分工设计：先约接口，再放并行

多 Agent 并行最容易翻车的地方，是各扫各的、最后拼不起来。所以我的第一句话术没有直接让它启动，而是先给定分工，再要一份任务书：

- **Agent-1 错误处理审计**：扫 `crates/**` 的 `unwrap()/expect()/panic!`，区分"测试代码可接受"与"生产代码应消除"；
- **Agent-2 测试覆盖盘点**：对比 rb-core 各模块与现有测试文件，找出零覆盖的公开函数；
- **Agent-3 规范一致性**：rustfmt/clippy 执行情况、TODO/FIXME 散落、公开项文档注释缺失；
- **Agent-4 汇总**：等前三个完成后，合并成 `reports/repobalance-health-report.md`。

有两个约定不能少：每个 Agent 的输出文件路径各自独立，免得写冲突；Agent-4 必须等前三个都跑完再动手。串并行结构画出来就是：

![002-repo-balance-4-agent-parallel-health-check 图 1](https://developer.qcloudimg.com/http-save/yehe-2059497/827007e0fc2853c8e01ab1049e2bbad3.png)

TRAE 按这个分工给出了四个 Agent 的任务书和先后安排，我看过没问题才放行。

![K5 输出的阶段 1 并行 / 阶段 2 串行时序安排，及 Agent-1/2 任务书（判定标准带正反例）](https://developer.qcloudimg.com/http-save/yehe-2059497/a68f426790b47acfff9e5aed206fac8e.png)

![Agent-2 测试覆盖盘点与 Agent-3/4 任务书：fmt/clippy 独占执行、汇总 Agent 串行等前三个完成](https://developer.qcloudimg.com/http-save/yehe-2059497/bbbcf0ba374966e938fe32cc5855c6f9.png)

## 二、并行执行实录

前面说过，四个维度如果排队跑，本质上还是串行。这次任务的关键是让多个 Agent 真正同时在跑——从下面两张截图里能看到三个 Sub Coding Agent 同时处于「输出中/思考中」状态，我这边只需要盯进度、等结果。

![并行执行进行中：三个 Sub Coding Agent 同时在跑（输出中/思考中），复现重跑时截取](https://developer.qcloudimg.com/http-save/yehe-2059497/0ea702fe28a7595ad73fca56d4ca71c2.png)

![并行执行动图：三个 Agent 的输出与思考状态实时滚动](https://developer.qcloudimg.com/http-save/yehe-2059497/42a094de0d1015354c3cfb2659c1bdac.gif)

![并行执行收官：任务耗时 19 分 17 秒，四个 Agent 全程无报错，汇总统计表 + TOP 3 问题一览](https://developer.qcloudimg.com/http-save/yehe-2059497/4b2f44a2ee1878ce9781822a27b4f340.png)

跑完一轮下来：Agent-1 扫了 35 个 `.rs` 文件，六种模式命中 179 处（unwrap 176、expect 3），其中生产路径的违规只有 1 条——`main.rs:29` Tauri 入口处的一个 `expect`，风险也低，rb-core 生产代码零命中；Agent-2 盘点出 55 个公开函数，直接覆盖 51 个、间接覆盖 3 个、没覆盖的只有 1 个（98.2%）；Agent-3 报出 fmt 不通过 3 个文件 15 处、clippy 0 warning、TODO 0、缺文档 5 处；最后 Agent-4 把三份中间产物合并成 132 行的报告。整个过程 19 分 17 秒。

关于报错，我在启动话术里加了一条：不许静默跳过，报错就停下把根因告诉我。这轮四个 Agent 全程没报错，这条规矩没派上用场——但踩坑小节的第 2 条说明为什么它必须一直写在话术里。

## 三、体检报告与"自己扫自己"

Agent-4 合并出的报告按模块分组统计，还给了 TOP 10 高频问题排行。比起问题数量，我更看重这个排序：`unwrap()` 集中在哪类模块、零覆盖函数集中在哪次迭代，一眼就能看出来。

![报告汇总：TOP 3 问题（conflict_markers.rs fmt 偏差 12 处、bin/rb.rs 9 个私有函数零测试、git/repo.rs 折行 2 处）与 P0/P1/P2 修复优先级](https://developer.qcloudimg.com/http-save/yehe-2059497/b2d16029af34d197f2bbd63034a69ce3.png)

报告到手后，我又加了一个环节：让仓衡的 CLI 把自己扫一遍。

```bash
cargo run -p rb-core --bin rb scan ./
```

![终端手动执行仓衡自扫（上）：编译 4.47 秒，仓库摘要 35 提交、52373 文件、约 7.2GB](https://developer.qcloudimg.com/http-save/yehe-2059497/d146e5b5f0e4383e98187480ccec2210.png)

![终端手动执行仓衡自扫（下）：体检结论 4 条 finding，含 demo-repo/big.bin 大文件告警（均为演示夹具）](https://developer.qcloudimg.com/http-save/yehe-2059497/dbd896e8f64ddb65a64f4f6e970a5296.png)

两组结果摆在一起看挺有意思：TRAE Agent 扫的是代码质量维度（unwrap、覆盖、规范），仓衡扫的是仓库健康维度（提交习惯、依赖、大文件）。两边视角不重叠，结论也不打架：

![002-repo-balance-4-agent-parallel-health-check 图 2](https://developer.qcloudimg.com/http-save/yehe-2059497/d7efbb6fa8149d9953936e73535fcd6c.png)

这正好说明多 Agent 分工扫的和传统 lint 工具扫的，确实不是一回事。

![仓衡自扫 + Agent 扫仓衡的双视角对比结论（上）：仓衡总分 93/100，双方交叉验证一致](https://developer.qcloudimg.com/http-save/yehe-2059497/c69cd9af78c2215b63924946167a2749.png)

![双视角对比结论（下）：能力矩阵互补、各自暴露的改进线索，以及合并后仅剩 fmt 一项会卡 CI](https://developer.qcloudimg.com/http-save/yehe-2059497/e8e9667cdbf9161498316eb7b6379dc3.png)

具体数字：仓衡自扫 93/100（0 Critical、4 Warning，全是 demo-repo 里故意埋的演示夹具）；Agent 侧报告 132 行，TOP 3 是 conflict_markers.rs 测试模块的 fmt 偏差 12 处（会卡 CI）、bin/rb.rs 9 个私有函数零测试、git/repo.rs 的 2 处折行，报告末尾给了 P0/P1/P2 共 7 条修复项。

这 7 条里我当场处理了一条：Agent-2 盘点出的那个零覆盖公开函数（`VulnEcosystem::label`），顺手补上单元测试，`cargo test` 211 条全过。体检报告如果不落地一两条，那就只是一份好看的成绩单——这也是我坚持在同一个任务里闭环的原因。

![修复闭环：报告追加「修复优先级建议」，零覆盖公开函数 VulnEcosystem::label 补测后 211/211 测试通过（任务耗时 2 分 32 秒）](https://developer.qcloudimg.com/http-save/yehe-2059497/36fea05ce4f2dfa0b5ac004c09d97943.png)

## 四、并行 vs 串行：实测对比

下表「4 Agent 并行」列是本次实测值；人工抽查和单 Agent 串行两列当时没有专门计时，只给量级参考：

| 指标 | 人工抽查 | 单 Agent 串行 | 4 Agent 并行（实测） |
|---|---|---|---|
| 覆盖率 | 小于 100%（抽样） | 100% | 100% |
| 耗时 | 半小时以上 | 半小时到一小时（推算） | 19 分 17 秒 |
| 产出物 | 无记录 | 4 份中间产物 + 1 份报告 | 同左（报告 132 行），且分工可复用 |

### 算一笔账

把 19 分 17 秒放进团队场景——以下按 10 人研发团队、每个迭代（双周）发布前各跑一次全量体检、人力成本 100 元/小时估算（团队规模与频率为估算值，耗时为本文实测值）：

| 指标 | 人工抽查（估计） | 4 Agent 并行（实测） |
|---|---|---|
| 单次全量体检 | 约 2 小时，且覆盖不到 100% | 19 分 17 秒，文件级 100% 覆盖 |
| 10 人团队每月（4 次） | 约 8 小时 | 约 1.4 小时 |
| 每年节省 | — | 约 78 小时，约 7800 元 |

**结论**: 直接人力节省约 7800 元/年，不是最耀眼的数字；真正的价值是覆盖率从"抽样"变成 100%——本轮 179 处 unwrap 命中和那个零覆盖公开函数，人工抽查大概率都漏掉——以及分工任务书可以直接复用到下一个工程。

## 五、踩坑实录

### 1. 两个 Agent 写同一个文件会互相覆盖

**现象**：初版分工让各 Agent 都往一个汇总文件追加，出现内容丢失。

**根因**：并行写同一文件没有协调方。

**解决**：改为各写独立输出文件，Agent-4 单独负责合并。

**教训**：并行的前提是"写空间不重叠"，接口约定先于启动。

### 2. Agent 报错静默跳过比报错更危险

**现象**：某 Agent 扫描中断，若不盯进度，报告会以"缺一个维度"的假完整示人。

**根因**：默认行为是跳过继续跑。

**解决**：话术里明确"报错就停下告诉我根因"。

**教训**：给并行任务立"失败要出声"的规矩，报告可信度才成立。

### 3. 扫描规则的"违规定义"必须给例子

**现象**：Agent-1 把测试代码里的 `unwrap()` 也判为违规，误报一堆。

**根因**：规则只有一句话，没有正反例（"测试代码可接受"没有写进任务书）。

**解决**：补充豁免边界说明后重扫，误报消失。

**教训**：给 Agent 的检查规则要像给同事的评审清单一样带例子。

## 六、边界：Agent 并行做不了什么

这四个维度都是逐文件、规则明确的检查，正是并行最拿手的活。什么任务适合拆给多 Agent 并行，什么任务不适合，判断下来可以画成一棵决策树：

![002-repo-balance-4-agent-parallel-health-check 图 3](https://developer.qcloudimg.com/http-save/yehe-2059497/688dd2d1b5b19d87a8e841926bdc7b83.png)

但有一种事 Agent 做不了：跨模块的语义判断——比如两个检查项对同一类异常的处理策略是否统一，Agent-1 到 Agent-3 各自扫各自的，谁都看不见全局，这类问题还是得人读完报告来裁。并行的价值在于把"机械覆盖"的成本打到接近零，把人留给真正需要判断的地方。

## 七、结论

这次实验跑下来，一套可以直接抄的流程就出来了：先给分工任务书（写清输出路径）→ 说清谁等谁 → 报错必须出声 → 汇总单独交给一个 Agent。4 个 Agent 并行，把一件我一直"排不上日程"的全量体检变成 20 分钟的例行操作，报告落在 `reports/`，以后每次迭代前后各跑一遍，代码质量的变化就不用靠感觉了。

"仓衡扫仓衡"的对比还有个意外收获：工具型开源项目最怕自己照不到自己，现在用 AI Agent 多维并行扫一遍，是我目前找到的成本很低的自检办法。

## 八、福利资源包：4 Agent 体检话术（可直接复用）

下面这段话术就是本文分工方案的原文，除工程路径外，对任何 Rust（或同语言）工程直接可用：

```text
我要对仓衡工程（~/Desktop/activity/repo-balance，Rust workspace）做一次全量体检，
请用多 Agent 并行模式，分工如下：
- Agent-1 错误处理审计：扫 crates/** 的 unwrap()/expect()/panic! 使用，
  区分"测试代码可接受"与"生产代码应消除"，输出违规文件+行号清单；
- Agent-2 测试覆盖盘点：对比 rb-core 各模块与现有测试文件，找出零测试覆盖的
  公开函数，列出清单；
- Agent-3 规范一致性：检查 rustfmt/clippy 配置的执行情况、TODO/FIXME 散落、
  文档注释缺失的公开项；
- Agent-4 汇总：等前三个完成后合并成 reports/repobalance-health-report.md，
  按模块分组统计 + TOP 10 高频问题排行。
开始前先给出四个 Agent 的任务书和输出文件路径约定、并行/串行顺序安排。
我确认后再启动。
```

配套两条铁律（踩坑实录第 1、2 条的来源）：

1. 每个 Agent 的输出文件路径各自独立，汇总单独交给一个 Agent；
2. 话术里写明"报错不要静默跳过，停下告诉我根因"。

仓衡 RepoBalance 源码（含本次体检报告与修复）：https://atomgit.com/dickeryang/repo-balance


**仓衡 RepoBalance**：开源 Git 仓库健康度体检台（Rust + Tauri 2），https://atomgit.com/dickeryang/repo-balance

> 技术改变生活，创新引领未来。欢迎在评论区聊聊：你的工程里哪些维度适合拆给多个 Agent 并行扫？

摘要: 专门给别人仓库做体检的开源工具，自己却从没被系统体检过——这是工具型项目的通病。本文记录用全新 TRAE 多 Agent 并行模式，给一个 Rust workspace 做全量体检的完整过程：4 个 Agent 按错误处理审计、测试覆盖盘点、规范一致性、报告汇总分工，先约输出路径与串并行顺序，再并行执行，19 分 17 秒扫完全库，产出 132 行报告和 7 条修复建议，并当场为找出的零覆盖公开函数补齐测试闭环。体检完再让工具自己的 CLI 扫自己一遍，"Agent 代码质量视角"与"工具仓库健康视角"交叉验证一致。4 Agent 分工话术全文放在文末福利资源包，可直接复用到任何工程。

19 分钟给 Rust 工程做全量体检：4 个 TRAE Agent 并行协作实战（含"仓衡扫仓衡"）

专门给别人仓库做体检的开源工具，自己却从没被系统体检过——这是工具型项目的通病。本文记录用全新 TRAE 多 Agent 并行模式，给一个 Rust workspace 做全量体检的完整过程：4 个 Agent 按错误处理审计、测试覆盖盘点、规范一致性、报告汇总分工，先约输出路径与串并行顺序，再并行执行，19 分 17 秒扫完全库，产出 132 行报告和 7 条修复建议，并当场为找出的零覆盖公开函数补齐测试闭环。体检完再让工具自己的 CLI 扫自己一遍，"Agent 代码质量视角"与"工具仓库健康视角"交叉验证一致。4 Agent 分工话术全文放在文末福利资源包，可直接复用到任何工程。

人工智能

用TRAE多Agent并行模式为Rust仓库做全量体检，4个Agent分工协作，19分17秒完成扫描，产出132行报告和7条修复建议，并补齐零覆盖函数测试。工具自扫验证两种视角一致，节省约78小时/年人力成本。附可直接复用的Agent分工话术。

单元测试

代码解释

GitHub

Agent

2026上云采购 | AI焕新·智启新局

coding

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

19 分钟给 Rust 工程做全量体检：4 个 TRAE Agent 并行协作实战（含"仓衡扫仓衡"）-腾讯云开发者社区-腾讯云

19 分钟给 Rust 工程做全量体检：4 个 TRAE Agent 并行协作实战（含"仓衡扫仓衡"）

19 分钟给 Rust 工程做全量体检：4 个 TRAE Agent 并行协作实战（含"仓衡扫仓衡"）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐