夜雨聆风学习资料网

ARTICLE · 1360988

EGM-金鱼审的不是设计,是你的文档

EGM-金鱼审的不是设计,是你的文档

AI OPEN SOURCE · 开源项目

谷歌开源的 EGM,让零上下文的“金鱼”评审设计稿。多数人盯着“失忆”,但我更在意的是:让金鱼先复述——复述不出来,文档就不合格。

项目:EGM 分类:AI 编程 / 设计评审 阅读约:5 分钟

写设计文档最尴尬不是被同事挑出漏洞,而是他看了半天问:“你到底想改哪里?”AI 评审也有同样的问题。同一个会话里,模型先帮你写、再帮你评,它评的往往是自己已存在的上下文,而是上下文里的假设。上下文越多,越容易替自己圆场,这就是常说的AI幻觉。10 月下旬,谷歌开源了 EGM(Elephant-Goldfish Model),把评审者换成了零上下文的“金鱼”。中文报道里,常见的是“金鱼治幻觉”和“先设计后编码”两种说法;但真正值得拆的,是金鱼协议的第一关:复述。

先说结论:EGM 不是 AI 架构评审专家,更像一台文档可读性编译器。它最值钱的地方,不是替你判断设计对不对,而是把“文档有没有被读懂”变成不能反驳的评审项——复述失败,直接判 Blocker。适合要写规格、带团队、用 coding agent 的人;想靠它证明架构正确,会失望。

本文目录

01 项目是什么?02 核心功能与亮点03 技术架构与运行原理04 安装部署与快速体验05 优点、局限与风险06 适合哪些人使用?07 最终评价与项目信息

01 · PROJECT INTRODUCTION

一、项目是什么?

EGM 是谷歌开源的 Agent 插件,Apache-2.0,10 月下旬在 Google Open Source Blog 发布。仓库今年 9 月创建,截至 11 月 15 日约 1.95 万星,本周新增约 5,500 星。官方称,谷歌内部已有数千名工程师每天用它交付生产代码;同时注明:这不是谷歌官方支持的产品。

它的理念来自 Dave Rensin 的文章《Elephants, Goldfish, and the New Golden Age of Software Engineering》,核心一句是 Design is the new code。

它把参与方分成三个角色:

• 大象:带着完整项目上下文聊需求、写设计稿,但不写代码;• 金鱼:零上下文、无状态,只读设计稿和它引用的材料,专门找没说出口的假设;• 人:拍板架构取舍,批准后才让 Agent 动手。

一句话:大象负责想清楚,金鱼负责挑毛病,人负责签字。

它属于 Spec-Driven Development(规格驱动开发)的一派:设计文档不是写完就归档的 Word,而是进仓库、进 PR、跟着代码一起活的资产。

项目档案
项目信息
项目名称
Elephant-Goldfish Model(EGM)
项目定位
设计先行的 Agent 评审工作流
技术栈
Agent Skills + 子代理 persona + Markdown 标准
开源协议
Apache-2.0
运行方式
Antigravity、Claude Code、Codex、Claude Cowork、ChatGPT Work 插件
项目地址
github.com/google/elephant-goldfish-model

02 · KEY FEATURES

二、核心功能与亮点

真正让它区别于“AI 代码评审”的,不是金鱼的比喻,而是四套机制:复述闸门、五道评审、结案规则和漂移检查。

亮点一:复述检查——先证明读懂,再谈对错

金鱼协议的第一件事不是挑错,是复述。负责这一关的 comprehension 角色,设定是一个“刚加入项目、没有任何背景”的新人。它要先用白话说两件事:这份文档提议做什么?按文档描述,现有系统怎么运作?

规则很硬:• 复述不出来 → 该章节直接判 Blocker;• 复述错了 → 本身就算一条 finding;• 只列出“这个术语没定义”不算数,把各部分串起来讲一遍才算;• 理解类问题不能被反驳,严重级别也不能改——作者只能回去改文档。

这就是“编译器”的含义:理解关不判断你的设计优不优雅,只判断这份文档能不能被正确解析。解析失败,后面所有评审都没有意义。

亮点二:五道关,不是一只金鱼包打天下

有的介绍把它简化成“三步”,那其实是三个命令(brainstorm / draft / review);评审本身分五关,每关换不同的评审人格(前四步在构思阶段,所以评审从 Step 5 开始编号):

关卡
谁在看,看什么
Step 5 战略评审
架构师 + TRIZ:YAGNI、重复造轮子、技术矛盾
Step 6 理解测试
天真读者:术语、前置知识、自包含
Step 7 批评评审
设计批评 + 结构 + 文风:单点故障、扩展瓶颈、失败模式
Step 8 回看
架构师:前两关新增的复杂度
Step 9 实施就绪
技术负责人 + 代码审计:文件路径、函数签名、测试计划

8 个评审人格由 synthesizer 并行拉起、汇总去重。先砍过度设计,再查文档歧义,再压架构风险,再清一次新增复杂度,最后确认“能不能照着干”。

亮点三:评审要“结案”,不是列清单

很多 AI 评审死在“给你 47 条建议,你自己看着办”。EGM 的 egm-resolve 要求每条意见必须被归类:

• PROPOSE FIX:成立,给出具体改法;• CONTEST:不成立,但必须引用评审者能读到的证据;• ESCALATE:文档内证明不了,交给人;• DECLINE:只是小毛病,记录不改。

理解类缺口不允许 CONTEST;两轮连续没有未解决的 Blocker/Major 才算干净;到第 5 轮会停下来,让人决定继续还是回到起草。评审的价值不在意见数量,而在每条意见都有归宿。

亮点四:文档会腐烂,所以要定期体检

egm-drift-report 把 docs/designs/ 里的设计稿和当前代码逐份对比,报告哪里漂移;改文档还是改代码,由人决定。官方建议每周跑一次。

这解决的是另一个老问题:设计文档写完就过期,后来的 Agent 拿着一份三年前的规格继续写代码。

03 · HOW IT WORKS

三、技术架构与运行原理

EGM 的结构可以拆成四层:

1. Skills 层:7 个斜杠命令,负责具体动作;2. Personas 层:8 个无状态评审角色 + synthesizer,决定“谁来看”;3. Document Standards 层:版本化的评审标准,决定“按什么尺子看”;4. Living Documentation 层:docs/designs/ 里进仓库的活规格。

需求讨论

↓

大象起草(不写代码)

↓

金鱼复述 → 五道评审

↓

egm-resolve 结案 → 人工 PR

↓

按规格实现 → 每周漂移检查

示意图:根据官方架构文档整理,不是官方原图。

最关键的工程约束是:金鱼必须是全新的子代理上下文。如果宿主环境不能创建 fresh subagent,EGM 会直接停止评审,而不是退化成同会话自评。这一点比提示词写得多漂亮都重要——零上下文是架构约束,不是语气要求。

另外,所有长内容都写进侧栏 artifact 或工作区文件,不往聊天窗口里倒。官方称之为 artifact-first,目的是避免“聊天记录被几页评审意见污染”。

04 · QUICK START

四、安装部署与快速体验

EGM 以插件形式分发,支持 Antigravity、Claude Code、Codex、Claude Cowork 和 ChatGPT Work。前提是你的宿主能创建新的子代理会话。

第一步:安装插件(Claude Code)

TERMINAL · 示例命令

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

第二步:拿现成文档试评审

TERMINAL · 开新会话后执行

/egm:egm-review docs/designs/your-feature.md

其他宿主

TERMINAL · Codex / Antigravity

codex plugin marketplace add \  google/elephant-goldfish-modelcodex plugin add egm@egmagy plugin install \  https://github.com/google/elephant-goldfish-model

最轻的体验不是从头写规格,而是找一份 README、设计稿或 PR 计划,直接跑 egm-review;或者对 docs/designs/ 跑一次 egm-drift-report,看看文档和代码已经差多远。

注意两点:Claude Code 和 Antigravity 的命令要带 /egm: 前缀;插件需要新会话才能加载。

05 · PROS & CONS

五、优点、局限与风险

值得肯定的地方

✓ 复述闸门让“复述不出来”直接变成不可反驳的 Blocker,可执行、可复现✓ 五道关 + 8 个评审人格,分工明确,不是一只金鱼包打天下✓ CONTEST 必须引用证据,防止作者嘴硬✓ 文档进仓库 + 每周漂移检查,规格是活资产✓ Apache-2.0,插件形态,能接进现有 coding agent

需要注意的问题

! 审的是文档,不是设计正确性;垃圾规格进,自信评审出! 零上下文看不见隐性约束,误报和漏报都要人兜底! 依赖宿主创建全新子代理,不是所有环境都支持! 安全评审默认不在关卡里,别把它当安全门禁! 反馈量大,官方明说“按需取用”,需要判断力! 不是谷歌官方支持产品,长期维护存在不确定性

开源协议与商用提醒

代码是 Apache-2.0。但用云端模型时,评审会把设计文档内容发给模型厂商,数据合规要自己评估;仓库里的 skill 和脚本,运行前先看一眼。本文不构成法律意见。

06 · WHO SHOULD USE IT

六、适合哪些人使用?

适合三种人:

1. 用 Claude Code、Codex 或 Antigravity 写规格、带项目的工程师;2. 团队里设计文档经常“只有作者看得懂”的人;3. 想把评审左移、在写代码前设一道闸的 Tech Lead。

不着急的也有:只想修个小 bug 的人,官方自己都说别硬套设计流程;想找“一键判断架构对错”的人,也会失望——它给的是文档体检报告,不是架构判决书。

我的建议:先别装全套。拿一份现有设计文档跑一次 /egm:egm-review,只看理解关能不能复述出来;复述失败的地方,就是你文档最该补的地方。这比读完所有官方文档更快。

07 · FINAL VERDICT

七、最终评价

FINAL VERDICT

金鱼不是裁判,是文档的编译器。

EGM 把设计评审拆成了五道可执行的关,但最值得带走的不是八只金鱼,而是第一道复述闸门:评审者先证明自己读懂了,再谈设计对错。它适合把规格当资产、愿意在写代码前多花半小时的人;如果你指望它替你拍板,它会很诚实地告诉你——它只负责测文档,不负责证明你对。其实这总处理事物的思想才是最重要的。

感谢阅读 · AI 开源观察

我是codeXF,热衷于分享 AI 观察与干货。

如果你觉得今天这篇有收获,欢迎 点赞、分享、关注,我们下篇见。

说明:本文内容基于公开资料与文中注明的文档来源整理。项目版本、功能、许可证和社区数据可能发生变化,请以项目官方仓库及文档为准。

#Agent #AI编程 #开源

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料