Google 开源项目设计插件 elephant-goldfish-model:用于写代码前的设计和文档评审,适用codex和claude-code

本文分享一个能直接落地的 AI 设计评审工作流：用深度上下文 Agent 起草规格文档，再用零上下文子 Agent 对设计文档做对抗式评审。

本文包括安装命令、七个 Skill 的分工、真实使用流程，以及这套方法论背后的核心洞察。

Github源码：

https://github.com/google/elephant-goldfish-model

一、写代码之前的设计阶段，是当下 AI 编码工作流最薄弱的一环。

Google 开源的 Elephant-Goldfish-Model（EGM）解决方案如下：

Elephant（大象）：持有你的项目上下文、需求和历史决策，负责探索问题、起草规格文档，大象记住一切。

Goldfish（金鱼）：一批全新启动的子 Agent，只看文档本身和它引用的源码，完全看不到之前的对话，金鱼只有七秒记忆，所以它不知道作者为什么这么写，只会追问这里为什么这么写。

你：负责架构权衡、批准设计、决定到底建什么。

目前已有数千名 Google 工程师在日常使用这个插件起草和压力测试设计规格，项目以 Apache 2.0 协议开源。

二、它和普通 code review 的边界在哪

它是设计阶段的插件：适合一个功能在写代码前需要做出设计决策的场景。比如：“给项目加 webhook 投递，投递失败怎么办？同一事件重复到达怎么办？”这类问题。

它不是万能流程：README 明确指出，小的、清晰的 bug fix 请走平时的正常编码工作流，别为了仪式感上 EGM。

它不替代测试和人类判断：官方文档明确声明 review 不能取代测试或人工判断，且 Goldfish 评审必须依赖能新建干净子 Agent 的会话环境。如果你的 Agent 无法创建 fresh subagent，EGM 会直接停止评审，绝不降级为“假金鱼”。这是它和很多“伪多 Agent 评审”方案最大的区别。

再强调一次：EGM 评审的是设计与规格文档，不是代码 diff。它在代码落地之前消灭设计缺陷，而不是在 PR 阶段挑代码风格。

三、三个步骤跑通第一个设计

以下用官方 Quickstart 的 webhook 场景演示。在 Antigravity（agy CLI）和 Claude Code 中，命令需要加 /egm: 前缀——agy CLI 1.4.10 会自动补全前缀（#220），但 1.4.8 不会（#196），所以务必手动带上前缀。

第 1 步：Brainstorm 探索想法

/egm-brainstorm Add webhook delivery to this project.

你和 Agent 讨论需求与权衡，Fresh reviewers 会实时挑战你的提案，最终共识被写入 concepts_brief.md。

第 2 步：Draft 起草规格

/egm-draft

Agent 把 brief 转成 design_draft.md，并且每写完一个 section 就暂停，等你在聊天中反馈——不是一口气生成一份没人看的八千字文档。

第 3 步：Review 对抗式评审

/egm-review design_draft.md

（路径以 Agent 实际返回的 draft 路径为准。）全新启动的 Goldfish 评审员从四个维度检查：设计本身、文档清晰度、与代码库的契合度、实现计划的可行性。你逐条挑选要采纳的 findings，批准后让编码 Agent 去实现。批准的规格建议归档到 docs/designs/ 下，形成设计资产沉淀。

四、七个 Skill：可以按需单点使用

EGM 不是强制流水线，七个 Skill 各自独立可用：

其中 Drift report 是被低估的一个：所有团队都经历过“设计文档和代码早就对不上”的窘境，这个 Skill 把设计腐化检测变成了一个可定时执行的检查项。架构细节可参考官方 Architecture 设计文档。

五、安装：三大 Agent 平台全覆盖

EGM 以插件形式分发，安装后会使其 Skills 能读取评审 prompt 和文档标准：

Antigravity CLI：

agy plugin install https://github.com/google/elephant-goldfish-model

Antigravity App 和 IDE（VS Code 扩展）用户运行 /plugin 或查阅安装说明。Claude Code：

claude plugin marketplace add google/elephant-goldfish-modelclaude plugin install egm@egm

Codex：

codex plugin marketplace add google/elephant-goldfish-modelcodex plugin add egm@egm

安装后必须开新会话。Claude Cowork 与 ChatGPT Work 的配置见 [setup guide](docs/harnesses.md)。Brainstorm 和 Review 环节要求会话具备创建全新子 Agent 的能力，这是硬性前置条件，再提醒一次。

六、使用体会与适用判断

从这套工作流的设计里能读出三条工程判断：

Fresh context 是评审质量的护城河：同会话里让 Agent“自我批评”几乎必然软化结论；EGM 用零上下文子 Agent 从机制上规避了这一点，无法创建子 Agent 时宁可拒绝评审。

人类保留否决权：每个 section 暂停、逐条采纳 findings、批准后才进入实现——LLM 提案，人拍板。

设计是文档资产，不是聊天记录：从 concepts_brief.md 到 design_draft.md 再到 docs/designs/，形成可审计、可 drift-check 的沉淀。

局限：

它吃 token（多轮子 Agent 评审）、依赖文档驱动的团队习惯、且明确不覆盖小型修复场景。

一个例子

在codex cli中输入：egm:egm-brainstorm 为「超越百岁」设计一个中文健康寿命主题落地页：纯静态、可离线使用，面向关注健康寿命的中文用户，需要解释品牌理念并引导用户做健康评估。

结语

如果你的团队已经在用 Claude Code、Codex 或 Antigravity 做日常编码，装上它、拿下一个中等复杂度的 feature 试一次 webhook 式的设计决策，是验证这套“大象与金鱼”方法论成本最低的方式。

Design with an elephant. Review with a goldfish. 设计时记得一切，评审时忘掉一切，而权衡永远在你手里。