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 窗口溢出或返回流式截断。建议分模块、分目录逐步运行漂移检测,及时归档过时文档。
