1. 痛点突围:它究竟击穿了什么工程死穴?

大模型在参与长期软件设计时,长上下文往往会带来灾难性的“确认偏误”。代理在和开发者多轮讨论后,会不知不觉地内化那些未曾明言的错误假设,并顺着既定思路生成充满隐患的架构草稿。开发者在疲惫状态下肉眼审查,极易放过底层的边界条件缺陷与并发陷阱。

google/elephant-goldfish-model(简称 EGM)引入的开创性解耦范式,将生成与审查分配给不同的认知实体。大象(Elephant)负责吞噬项目全量上下文,锚定业务需求并起草规约;金鱼(Goldfish)则被剥离全部历史对话记忆,仅凭设计文档与原始代码库进行冷眼空降审查。这种认知隔离直接撕开了 AI 长期对话带来的思维惯性。

💡 架构核心洞见:通过人为制造代理间的记忆断层,EGM 强迫审查者以绝对客观的零历史视角,直接切中隐藏在冗长交互背后的逻辑盲区。

2. 核心架构与底层数据流向解析

EGM 在工程实现上本质是一个基于插件体系的工作流调度器。它依靠多子代理(Subagent)上下文隔离机制,把设计阶段拆分为连续的三个状态机节点:需求探索、草稿生成、零基审查。数据在不同记忆边界的流动受控于具体的调用指令。

[ Project Context ] ---> [ Elephant Agent ] ---> [ concepts_brief.md / design_draft.md ]
                                                          │
                                                          ▼
[ Source Code Base ]  ---> [ Goldfish Agent ] <--- [ Isolated Reviewer Context ]
                                                          │
                                                          ▼
                             [ Architectural Trade-offs & Approvals ]

在底层数据流转中,Elephant 维持全量项目感知,将交互收敛为 concepts_brief.md 与 design_draft.md。而当执行审查动作时,调度器会显式销毁上下文关联,强制生成一个毫无历史包袱的 Goldfish 子代理。该子代理直接读取落地文件和源码,使用硬编码的规范标准对草稿进行地毯式扫描,过滤掉所有虚假的心理安慰和盲目认同。

3. 技术选型与性能横向硬核对比

选型维度 本方案 (elephant-goldfish-model) 传统单代理对话模式 人工代码评审 (PR Review) 静态代码分析工具 (SonarQube)
记忆隔离度 绝对隔离(通过多子代理动态蒸馏) 零隔离(承载全量历史聊天记录) 视人类疲劳度与领域经验而定 基于固定语法树规则(AST)
设计阶段覆盖 需求探索、草稿起草、漂移检测全覆盖 仅限单轮会话,极易遗忘早期约束 滞后于编码实现阶段,成本高昂 仅限编码完成后的静态合规检查
盲区捕获率 高(强制打破确认偏误) 低(倾向于迎合用户初始直觉) 中等(取决于审阅者专注程度) 极低(无法识别架构设计意图)
工具生态集成 Antigravity、Claude Code、Codex CLI 依赖特定大模型聊天界面 强绑定 Git 托管平台 依赖 CI/CD 流水线集成

从技术选型对比不难看出,EGM 填补了静态检查工具与人类架构师之间的真空地带。它不替代测试框架,也不替代人类最终决策,但在架构落地前夜提供了一道高强度的红蓝对抗防线。

4. 手把手极客实操:从零构建最小闭环

在本地开发环境中集成 EGM 插件,以 Claude Code 运行环境为例,执行以下终端命令完成安装:

# 将谷歌官方 EGM 插件市场源添加至 Claude Code 插件列表
claude plugin marketplace add google/elephant-goldfish-model

# 在当前工作空间安装 egm 核心技能包
claude plugin install egm@egm

安装完成后,启动新的终端会话,进入具体的代码仓库。以下是通过 Brainstorm 技能发起新功能设计的最小闭环实操命令:

# 激活头脑风暴,探索为当前项目增加 Webhook 异步分发机制的边界条件
/egm:egm-brainstorm Add webhook delivery with retry backoff and idempotency key.

当代理通过交互将共识写入 concepts_brief.md 后,继续执行草稿生成与隔离审查命令:

# 将讨论简报转化为结构化的架构规约草稿
/egm:egm-draft

# 派遣金鱼审查员对生成的草稿进行零基冷启动审查
/egm:egm-review design_draft.md

系统运行预期将输出针对该草稿的尖锐质疑报告,例如指出未定义重复事件到达时的幂等处理逻辑,或指责重试退避算法缺少上限保护。开发者在修复这些盲区后,方可将规约正式归档至 docs/designs/ 目录。

5. 生产落地踩坑指南与避坑建议 (Gotchas)

在大规模工程团队中推行此套规范时,由于代理对运行环境和子代理创建能力的强依赖,需要特别注意底层调用约束。

⚠️ 避坑预警 [子代理环境限制]:如果当前编码代理的宿主环境不支持动态派生新鲜子代理,EGM 会直接熔断并终止审查流程。请确保在运行前升级客户端版本(如 Antigravity CLI 1.4.10 以上版本),避免因版本落后导致命令前缀解析失效或子代理创建失败。

⚠️ 避坑预警 [状态漂移过载]:当代码库长期迭代导致 docs/designs/ 内的规约严重滞后于源码时,切忌盲目全量执行 /egm-drift-report。面对庞大的代码树,单次对比容易触发 Token 窗口溢出或返回流式截断。建议分模块、分目录逐步运行漂移检测,及时归档过时文档。