Elephant-Goldfish Model: Google's open-source "Elephant Drafting, Goldfish Reviewing" specification design plugin, 21.1K starsElephant-Goldfish Model:谷歌开源「大象起草、金鱼评审」规格设计插件,21.1K 星
The biggest pitfall when writing software specifications is "reviewing your own work": the context is too saturated, and blind spots cannot be seen. EGM uses the "Elephant" role to hold all the project context and draft the specifications, and then uses the "Goldfish" reviewer, who has zero context, to pick out flaws with fresh eyes and identify unstated assumptions and oversights. Supports mainstream coding agents such as Claude Code, Codex, and Antigravity.
写软件规格时最大的坑是「自己审自己」:上下文太满,盲区看不见。EGM 用「大象」角色握住全部项目上下文起草规格,再用零上下文的「金鱼」评审员带着新鲜眼光挑毛病,把没说出口的假设和遗漏揪出来。支持 Claude Code、Codex、Antigravity 等主流编码 Agent。

Elephants and Goldfish: Explaining How It Works in One Sentence大象与金鱼:一句话讲清工作原理
The "Elephant" is the main agent that holds all the context of your project: it has read the codebase, discussed the requirements, remembers all the decisions, and is responsible for drafting the specification document. The advantage is that it writes comprehensively, but the disadvantage is that it can easily be led astray by inertia.
The "Goldfish" reviewer is a sub-agent with deliberate amnesia: for each review, they only receive the draft and the cited source files, without any memory of previous conversations. Without the "author filter", it is actually easiest to see that "X is assumed here, but it was never clearly stated".
You are responsible for making architectural trade-offs and approving specifications before implementation: EGM does not make decisions for you; it ensures that the documents presented to you are versions that can withstand scrutiny from fresh eyes.
「大象」(Elephant)是握有你全部项目上下文的主代理:它读过代码库、聊过需求、记得所有决策,负责起草规格文档——优点是写得全,缺点是容易被惯性带偏。
「金鱼」(Goldfish)评审员则是刻意失忆的子代理:每次评审只拿到草稿和被引用的源文件,不带之前任何对话记忆。没有「作者滤镜」,反而最容易看出「这里默认了 X 但从没说清楚」。
你本人负责做架构取舍并在实现前批准规格:EGM 不替你做决定,它保证送到你面前的文档是经得起新鲜眼光审视的版本。

Four core capabilities covering the entire lifecycle of specifications四类核心能力,覆盖规格全生命周期
Brainstorming (egm-brainstorm): When starting a new design, I first talk to you to gather requirements and produce a structured draft. This is suitable as a starting point for situations like "I want to add a webhook retry mechanism but haven't figured out the details yet".
Review loop (egm-review-loop): The draft is sent to multiple reviewers with no context, who scrutinise it point by point against different criteria (clarity, alignment with the codebase, feasibility of the implementation plan) and compile a list of changes.
Drift Report (egm-drift-report): Compares the document directory with the current source code and reports which design documents have diverged from the code – the bane of document rot.
Scope of application: The built-in workflow is for software specifications; other types of documents (proposals, READMEs, PR plans) can use /egm-review-loop to select reviewers and standards.
头脑风暴(egm-brainstorm):开新设计时先和你对话收拢需求,产出结构化草案,适合「我想加个 webhook 重试机制但还没想清楚细节」的起点。
评审循环(egm-review-loop):把草稿丢给多个零上下文评审员从不同标准(清晰度、与代码库的契合度、实现计划可行性)逐条挑刺,汇总成修改清单。
漂移报告(egm-drift-report):对比文档目录与当前源码,报告哪些设计文档已经和代码分道扬镳——文档腐烂的克星。
适配范围:内置工作流针对软件规格;其他类型文档(方案书、README、PR 计划)可用 /egm-review-loop 自选评审员与标准。
Installation Method (Select Based on the Agent You Use)安装方式(按你用的 Agent 选)
Claude Code: Run claude plugin marketplace add google/elephant-goldfish-model and then claude plugin install egm@egm.
Codex CLI: codex plugin marketplace add google/elephant-goldfish-model, then codex plugin add egm@egm.
Antigravity CLI: agy plugin install https://github.com/google/elephant-goldfish-model; The adaptation files for Cursor, Gemini, and OpenCode are also in the corresponding directories within the package.
Be sure to start a new session after installation. Commands in Claude Code and the agy CLI must be prefixed with /egm: (e.g., /egm:egm-review). For Codex, select it from the skill selector.
Claude Code:依次执行 claude plugin marketplace add google/elephant-goldfish-model 和 claude plugin install egm@egm。
Codex CLI:codex plugin marketplace add google/elephant-goldfish-model,再 codex plugin add egm@egm。
Antigravity CLI:agy plugin install https://github.com/google/elephant-goldfish-model;Cursor、Gemini、OpenCode 的适配文件也都在包内对应目录。
装完务必新开会话;Claude Code 与 agy CLI 中命令要带 /egm: 前缀(如 /egm:egm-review),Codex 则从技能选择器里选。

60-Second Test: Review Existing Documents60 秒试一把:审查已有文档
There's no need to write a new specification first. Simply tell the Agent "/egm:egm-review docs/designs/webhooks.md", and it will ask a fresh reviewer to check the clarity of this design, its alignment with the code, and the implementation plan.
Try /egm:egm-drift-report docs/designs/ again to see which documents in the entire directory are out of date. Many teams are shocked the first time they run it: more than half of the design documents no longer reflect the current situation.
It is recommended to incorporate EGM into the team's process: any PR should go through a review cycle before code is written, which will significantly reduce the rework rate.
不需要先写新规格。直接对 Agent 说 /egm:egm-review docs/designs/webhooks.md,它会拿新鲜评审员检查这份设计的清晰度、与代码的契合度和实现计划。
再试 /egm:egm-drift-report docs/designs/,看整个目录里的文档哪些已经过时。很多团队跑完第一次都吓一跳:一半以上的设计文档早就不反映现状了。
建议把 EGM 固定进团队流程:任何 PR 计划先过一遍评审循环再动手写代码,返工率会明显下降。
Use reminder使用提醒
The brainstorming and review cycle requires a session that can create sub-agents in order to run; agy CLI 1.4.8 and below do not support automatic completion of the /egm: prefix. Please add the prefix manually. The plugin package that accompanies this article can be found via the download button above. Once installed, you can view all the review criteria offline.
头脑风暴与评审循环需要能创建子代理的会话才能运行;agy CLI 1.4.8 及以下不支持自动补全 /egm: 前缀,请手动带前缀。本文配套插件包见上方下载按钮,安装后即可离线查阅全部评审标准。
⬇ Download · 点击下载:Elephant-Goldfish Model 完整插件包(含全部评审技能与文档标准)
Apache-2.0 许可 · 谷歌官方仓库源码 · 支持 Claude Code / Codex / Antigravity / Cursor / Gemini
阅读与点赞数据保存在你的浏览器本地,欢迎留下你的想法。
今日正能量学一点,用一点;今天种下的种子,会长成明天的能力。去免费下载专区 →广告
评论 文明发言,让讨论更有价值