Subagents 只读评审实战

第一次使用 Subagents,建议让多个 agent 分别做架构、代码风险、测试交付、安全权限的只读评审,最后由主线程汇总成决策清单。

Subagents 的价值是并行看问题。第一次实战不要让多个 agent 同时改代码,而是让它们做只读评审。

目标:

让多个 agent 分别从不同角度审查当前项目或当前 diff,最后汇总成可执行的风险清单。

第 1 步:定义评审目标

不要只说“让多个 agent 看看”。要明确评审范围。

请使用 Subagents 做一次只读评审,不要修改文件。

评审目标:
【例如:审查当前未提交 diff / 审查一个新功能方案 / 审查项目结构】

请拆成 4 个方向:
1. 架构和影响范围。
2. 代码质量和可维护性。
3. 测试、构建和交付风险。
4. 安全、权限和敏感信息风险。

要求所有 agent 只读,不修改文件。

第 2 步:给每个 agent 明确职责

请为每个 Subagent 分配职责。

输出格式:
1. Agent 名称。
2. 只读任务范围。
3. 需要重点查看的文件或信息。
4. 不允许做什么。
5. 输出格式。

好的 agent 职责应该互补,而不是四个 agent 都重复看同一件事。

职责拆分示例

Agent重点不做什么
架构 agent模块边界、影响范围不评价文案风格
代码 agent逻辑、可维护性、重复不跑偏做新功能
测试 agent测试缺口、构建风险不直接补测试
安全 agent密钥、权限、隐私不读取真实密钥

第 3 步:统一输出格式

每个 agent 都按同一格式输出,最后才好汇总。

## 已确认事实
- 来自文件、diff、日志或明确需求。

## 推测
- 还需要验证的判断。

## 风险
- 高 / 中 / 低风险。

## 建议
- 只给建议,不修改文件。

分歧处理模板

如果 Subagents 之间有分歧,请主线程统一判断。

请说明:
1. 分歧点是什么。
2. 每个 agent 的依据。
3. 哪个判断证据更强。
4. 是否需要补充只读检查。
5. 当前最小下一步是什么。

第 4 步:主线程汇总

不要接受多份报告堆在一起。让主线程合并成决策清单。

请汇总所有 Subagents 的结果。

要求:
1. 合并共同确认的事实。
2. 标出分歧点。
3. 按高、中、低风险排序。
4. 给出下一步最小动作。
5. 标出现在不建议做的事情。
6. 不要修改文件。

第 5 步:决定是否进入修改

Subagents 评审结束后,不要让所有 agent 继续改。只选择一个主执行路径。

基于 Subagents 评审结果,请给出执行建议。

要求:
1. 哪些问题必须现在处理。
2. 哪些问题可以延后。
3. 如果要修改,应该由主线程还是某个 agent 执行。
4. 修改范围是什么。
5. 验收方式是什么。

适合 Subagents 的场景

不适合:

评审收尾

请输出 Subagents 只读评审最终结论。

请包含:
1. 共同确认的事实。
2. 高风险问题。
3. 可以暂缓的问题。
4. 分歧点和需要确认的信息。
5. 下一步最小动作。

验收结果