EGM Synthesizer 角色(群体编排与输出聚合)¶
- 作者: Brian Suchy (@briansuchy)
- 状态: 当前
- 日期: 2026-07-31
概述¶
EGM Synthesizer 角色(synthesizer)是一个中间编排层,负责启动多个子代理并对它们之间的反馈进行去重。它用于整合 EGM 技能所启动的各种子代理的反馈,并防止在支持嵌套子代理的运行时(例如 Antigravity)中发生上下文窗口膨胀。
问题¶
从主用户对话中直接管理多代理评审群体会面临以下挑战:
- 上下文污染与 Token 膨胀:在 Root 会话中直接生成 6 到 12 个并行评审者,会使主上下文窗口充满数千 Token 的原始、冗长的工具输出和中间子代理的闲聊,削弱模型的推理能力。
- 冗余与重叠评审意见:多个评审者在检查同一文档时,经常会从略有不同的角度(例如结构 vs. 设计)识别出相同的根本问题。未经过滤的输出会用重复的发现淹没人类工程师。
- 不一致的链接格式:无状态子代理经常构造不一致或损坏的相对文件链接。
- 聊天流中断:将原始评审轨迹倾倒进用户聊天会违反 Artifact-First UX 原则。
系统架构与数据流¶
sequenceDiagram
autonumber
participant Elephant as Root Elephant Context
participant Synth as Synthesizer Persona (Intermediate Orchestrator)
participant Swarm as Goldfish Swarm (A/B Parallel Subagents)
participant Artifact as Artifact File (goldfish_review_report.md)
Elephant->>Synth: invoke_subagent (TargetFile, Reviewers, Standards)
Note over Synth: Inspect Mode: REVIEW vs BRAINSTORM
Synth->>Swarm: invoke_subagent (Concurrent A/B Subagents)
Note over Swarm: Independent Audits in Zero-Context Windows
Swarm-->>Synth: Return raw findings & critiques
Note over Synth: Deduplicate, Triage (Blocker/Major/Nit), Normalize Links
Synth->>Artifact: write_to_file (goldfish_review_report.md)
Synth-->>Elephant: send_message (Completion summary & artifact link)运行模式¶
synthesizer 角色根据调用上下文以两种不同模式运行:
1. Mode: REVIEW(文档审计)¶
- 冗余子代理生成(A/B 采样):为每个请求的评审者启动两个独立实例(例如
Hostile Design Critic A和Hostile Design Critic B),以最大化发现召回率并消除非确定性评估缺口。 - 角色标题强制:子代理角色严格以
Auditor、Reviewer或Critic作为后缀,以便在执行仪表板中实现清晰的可观测性。 - 严重性分级:将所有聚合的发现分为三个等级:
- 🔴 Blocker:架构缺陷、未处理的 SPOF、缺失的文件目标或无法解决的依赖项。
- 🟡 Major:不完整的错误处理、未说明的扩展假设或缺失的验证计划。
- 🟢 Nit:轻微的清晰度问题、术语不一致或格式差异。
- 链接规范化:为所有被引用的行构建干净的 Markdown 链接:
[path:Lstart-end](path#Lstart-Lend)。 - Artifact 输出:将整合后的报告写入
goldfish_review_report.md(或zoom_out_report.md/comprehension_report.md)。
2. Mode: BRAINSTORM(概念构思)¶
- 7-Lens Swarm(七视角群体):跨七个视角启动并行头脑风暴者:
Skeptical Architect、Codebase Grounding Auditor、UX & Ergonomics、Naive Comprehension、Implementation Feasibility、Structural Design和Inventive Catalyst (Contradiction Resolution)。 - 概念综合:聚合不同的想法、突出隐藏风险、识别现有基础设施的复用机会,并汇总出统一的
concepts_brief.mdArtifact。
代理间通信契约¶
- 输入参数:
TargetFile:目标文档的绝对路径。LineRange:目标行范围(或full file)。Reviewers:评审者角色短名称的数组。Standards:评审者到标准 Markdown 文件的键值映射。GoldfishContext:评审者基线所用的补充阅读列表。
- 输出契约:
- synthesizer 绝不能在聊天中或通过
send_message输出完整报告文本。 - 它使用文件写入工具将报告写入磁盘。
- 它通过
send_message返回一条消息,包含:- 按严重性统计的发现总数。
- 指向生成 Artifact 的干净链接。
- synthesizer 绝不能在聊天中或通过
实现文件¶
| 文件路径 | 类型 | 用途及存在理由 |
|---|---|---|
agents/synthesizer.md |
角色提示词 | synthesizer 编排角色的系统提示词和操作逻辑。 |
.claude-plugin/agents/synthesizer.md |
Claude Code 适配器 | 向 Claude Code 注册 synthesizer,加载角色,并设置其工具权限。 |
参考¶
- Dave Rensin, Elephants, Goldfish, and the New Golden Age of Software Engineering (Medium, 2026).
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model