跳转至

EGM Synthesizer 角色(群体编排与输出聚合)

  • 作者: Brian Suchy (@briansuchy)
  • 状态: 当前
  • 日期: 2026-07-31

概述

EGM Synthesizer 角色(synthesizer)是一个中间编排层,负责启动多个子代理并对它们之间的反馈进行去重。它用于整合 EGM 技能所启动的各种子代理的反馈,并防止在支持嵌套子代理的运行时(例如 Antigravity)中发生上下文窗口膨胀。

问题

从主用户对话中直接管理多代理评审群体会面临以下挑战:

  1. 上下文污染与 Token 膨胀:在 Root 会话中直接生成 6 到 12 个并行评审者,会使主上下文窗口充满数千 Token 的原始、冗长的工具输出和中间子代理的闲聊,削弱模型的推理能力。
  2. 冗余与重叠评审意见:多个评审者在检查同一文档时,经常会从略有不同的角度(例如结构 vs. 设计)识别出相同的根本问题。未经过滤的输出会用重复的发现淹没人类工程师。
  3. 不一致的链接格式:无状态子代理经常构造不一致或损坏的相对文件链接。
  4. 聊天流中断:将原始评审轨迹倾倒进用户聊天会违反 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.md Artifact。

代理间通信契约

  1. 输入参数:
    • TargetFile:目标文档的绝对路径。
    • LineRange:目标行范围(或 full file)。
    • Reviewers:评审者角色短名称的数组。
    • Standards:评审者到标准 Markdown 文件的键值映射。
    • GoldfishContext:评审者基线所用的补充阅读列表。
  2. 输出契约:
    • synthesizer 绝不能在聊天中或通过 send_message 输出完整报告文本。
    • 它使用文件写入工具将报告写入磁盘。
    • 它通过 send_message 返回一条消息,包含:
      • 按严重性统计的发现总数。
      • 指向生成 Artifact 的干净链接。

实现文件

文件路径 类型 用途及存在理由
agents/synthesizer.md 角色提示词 synthesizer 编排角色的系统提示词和操作逻辑。
.claude-plugin/agents/synthesizer.md Claude Code 适配器 向 Claude Code 注册 synthesizer,加载角色,并设置其工具权限。

参考

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model