Elephant-Goldfish Model 快速入门:先写清规格,再让全新上下文找漏洞

AI 助手的开源设计插件:Elephant 保留项目背景并起草规格,Goldfish 在新上下文评审文档与引用材料;七项技能覆盖简报、规格、评审、发现处理、代码库说明与漂移检查,人负责取舍和批准。

📅 收录: 2026-11-18 🔄 更新: 2026-11-18

Elephant-Goldfish Model 快速入门

Elephant-Goldfish Model(EGM)是 AI 助手的开源插件,不是一个需要下载权重的新模型。 它把写方案与审方案分开:Elephant 保留项目背景,Goldfish 从新上下文读文档和引用材料,人来决定取舍与批准实施。 适合需求不清、设计文档依赖口头背景、或者代码与文档渐渐偏离的开发团队。 它不替你做架构决策,也不以一份 AI 评审报告替代测试、代码审查与人工验收。

核验日期:2026-11-18。 本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。 本文命令来自官方 README 与 Harnesses 文档,成功判定是供读者复核的目标,不是本站运行结果。

这是什么?适合谁?

  • 已有 Claude Code、Codex CLI 等宿主,希望把讨论沉淀为自包含规格的开发者。
  • 要评审一个现成 README、功能方案或 PR 计划,而不是重新从头写的人。
  • 接手旧代码,需要先梳理目录、再检查设计漂移的维护者。
  • 不建议为一处明确的小修复强行跑完整设计流程;官方允许单独调用任一技能。

项目在 google 组织下公开,但 README 明确写着:不是由 Google 提供官方支持的产品。 站内另一个 Goldfish 指向 goldfish.ai;它不是 egm.dev 对应的这个插件,不能因名字相似混为一谈。

准备工作

  1. 先安装并能正常使用一个受支持的宿主;EGM 不包含模型订阅或 API 额度。
  2. 选择一个测试项目或副本,把可供评审的代码与 Markdown 文档准备好。
  3. 确认当前会话确实能创建新的子代理上下文,而不只是能加载技能。
  4. 文档中写明目标、约束、引用文件和待定问题;别让评审者猜聊天里的前情。
  5. 首次使用只授权测试目录,不把部署、付款或生产修改混进设计任务。

插件采用 Apache-2.0 许可;宿主订阅、模型推理和并行评审的成本另算。 官方没有给出适用于所有模型的固定评审费用,不能把开源理解成调用免费。

官方安装与启用

Claude Code 用户复制以下两行到终端:

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

Codex CLI 用户使用另一组命令,第二行是 add 而不是 install:

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

安装后开启新会话,再查看 EGM 插件与技能是否出现。 必须装完整插件:技能运行时要读取 agents/ 和 resources/document_standards/,只复制 skills/ 会缺依赖。 桌面版 ChatGPT/Codex 则从官方 README 链接的插件页面安装,不能把桌面入口当作 CLI 命令。

Antigravity CLI 的官方命令如下:

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

这里不把所有「支持加载」都说成同等可用:独立 Antigravity IDE 缺少评审需要的新上下文子代理能力,官方标为不支持。

首个任务:评审已有 webhook 方案

先把一份真实的方案保存成 docs/designs/webhooks.md,写明重试次数、重复事件处理和失败后的人工入口。 若项目还没有 webhook,不必假装它已存在;改用你实际要评审的文件路径。 在 Claude Code 或 Antigravity CLI 中调用:

/egm:egm-review docs/designs/webhooks.md

Codex 用户从技能选择器选择 egm-review,并提供同一份文件路径。 不要直接假设 Claude 的斜杠命名空间能原样用于 Codex。

交代任务时可以追加以下限制:

只评审给定方案与其引用的源码,不实施修改。
重点检查重复事件、失败恢复和人工接管是否定义清楚。
每项发现指出文档位置、相关代码或缺失依据;不要把猜测说成事实。

这是建议的任务描述,不是插件额外提供的命令。 成功判定应同时看四件事:

  • 宿主实际启动了新的评审子代理,而不是由作者在原对话里自问自答。
  • 发现能定位到具体段落、代码引用或未写出的约束。
  • 报告区分不清楚、实现风险与需要人决定的取舍。
  • 人逐条决定采纳什么,未批准前不进入实现。

官方称它可以快速评审,但本文没有测量耗时,不承诺一分钟完成。

初级用法

1. 把想法变成概念简报

Claude Code 中可从下面这个请求开始:

/egm:egm-brainstorm 为这个项目增加 webhook 投递,先讨论失败恢复和重复事件。

目标产物是 concepts_brief.md:它应该保留你与代理达成一致的方向,而不是直接堆实现代码。 先检查目标、范围和未决问题,再进入下一步。

2. 分节起草规格

调用 egm-draft,让它把简报或已有笔记转成 design_draft.md。 官方流程会在各节后停下来收集反馈;不要跳过这些停顿把长文一次当作已批准规格。 最终文件路径以代理返回为准,不要凭示例路径去读另一份旧稿。

3. 从评审发现走回决策

用 egm-resolve 逐项讨论需要回应的发现。 对采纳、拒绝和暂缓分别给理由;某条建议看起来专业,不代表适合你的业务约束。 批准后的规格应进入版本管理,再由编码代理按计划实施。

高级玩法

1. 为非软件文档配置 review-loop

egm-review-loop 面向可配置的评审者与标准,不只限于软件规格。 例如活动方案要检查值班、开放时间和职责边界,就把这三项写成标准,而不是套用代码实现检查。 先给出文档和目标,请技能帮助确定评审范围;具体参数以该技能当前说明为准。

2. 用 drift-report 找文档与源码分歧

/egm:egm-drift-report docs/designs/

先限定一个设计目录,核对它报告的引用文件是否存在。 发现差异后由人决定更新代码还是文档;检测到漂移不等于代码一定错误。 不要把这一步自动接到提交、合并或部署。

3. 用 bootstrap 梳理接手的代码库

egm-bootstrap 从叶子目录逐层总结 README,再形成上层结构说明。 适合新维护者建立导航,但它会产生或更新文档,应先在分支或副本内运行。 先审一个叶子目录的说明与源码是否一致,再扩大到整棵目录树。

具体功能学习:七项技能怎样接起来

egm-brainstorm → egm-draft → egm-review → egm-resolve 是设计闭环。 egm-bootstrap 为缺少说明的现有项目补导航,egm-drift-report 则在有文档后检查偏移。 egm-review-loop 用来处理需要自定义评审标准的其他文档。

建议练习同一个 webhook 设计:先用 brainstorm 写出幂等性假设,再用 draft 写成规格,最后检查 review 是否仍能发现遗漏。 如果评审依赖「你刚才说过」,把那条背景补回规格,而不是把整段作者聊天交给评审者。 官方还提醒,新对话上下文与宿主指令排除不是一回事:Codex 和 Antigravity 仍可能加载项目指令文件。 因此别把「Goldfish 看不到之前聊天」扩写成「Goldfish 绝对不知道任何项目规则」。

五个具体踩坑

1. 技能能显示,却找不到评审标准

症状:调用时提示 persona 或文档标准文件缺失。 原因:只安装了技能目录,没有完整运行资源。 解决:按官方完整插件命令重新安装,核对 agents/ 与 resources/ 随包存在,再开新会话。

2. Claude 的命令在 Codex 中不触发

症状:/egm:egm-review 被当作普通文本。 原因:宿主的技能入口不同,不是文档路径错了。 解决:Codex 使用技能选择器;Claude Code 使用 /egm: 前缀,别混用调用形式。

3. 能起草却不能运行 Goldfish

症状:评审停住并说明无法创建新上下文。 原因:会话没有原生子代理工具,或使用不支持的独立 IDE。 解决:检查实际工具可用性,换到官方支持的宿主/模式;不要要求它原地假扮独立评审者。

4. 评审仍然重复项目中的先入之见

症状:报告没有质疑某条宿主指令中的假设。 原因:隔离父对话不保证排除 AGENTS.md 等指令文件。 解决:把需要挑战的假设列成显式评审标准,并核对宿主文档中已知的指令隔离限制。

5. 漂移报告被误当成自动修复计划

症状:代理准备为了匹配旧文档直接改代码。 原因:把「发现不一致」误等同于「文档为准」。 解决:先确认哪个版本代表当前意图,再分别批准代码或文档修正,并运行项目自己的测试。

五个使用技巧

  1. 第一次用现成小文档做 review,不要立刻把全库都交给 bootstrap。
  2. 把输入文件路径写全,检查报告所指的草稿是否是当前版本。
  3. 在每条未决项后写负责人,避免 AI 用默认值替你做业务决策。
  4. 把发现与决策分开保存,保留「为什么不采纳」比只留最终文档更有用。
  5. 限定评审范围和并行规模;多位评审者会增加模型调用,不保证线性提高质量。

常见问题 FAQ

Q1: EGM 是 Google 提供支持的商业服务吗?

A: 不是。代码在 google 组织下,README 同时明确声明不是由 Google 提供官方支持的产品。

Q2: 名称里有 Model,需要下载模型权重吗?

A: 不需要。这里的 Model 指协作方法,安装的是宿主插件,模型由你的宿主提供。

Q3: 不写新规格也能用吗?

A: 可以。官方提供对现有设计、README 和保存为 Markdown 的 PR 计划做评审的入口。

Q4: Goldfish 的意见能当验收结论吗?

A: 不能。它用于发现缺口,仍需人工判断、实现测试和项目自己的质量门槛。

Q5: 免费开源是不是零使用成本?

A: 插件许可免费不等于宿主与模型免费,多子代理评审可能消耗订阅额度或产生 API 费用。

参考链接

📊 评分与标签

核验口径:已按现行口径通过,待按新证据契约复核 · 证据状态:仅公开资料 · 核验日期:

评分说明

总分 7.9/10 · S_入选

核验日期:2026-11-18。评分依据可追溯至官网、官方 README、Setup & Workflow Guide、Harnesses 与 GitHub REST 元数据。 这是资料核验判断,未安装、未创建评审子代理、未比较真实设计缺陷检出率,未完成独立实测。 评分不沿用采集排序值;下面的输出质量分评价的是可核实的流程设计与产物约束,不代表实测准确率。

可观测社区指标

采集日期:2026-11-18。GitHub REST 返回 stars 20,755、forks 1,531、open issues 123(包含 PR),pushed_at 为 2026-11-17T19:41:10Z,未归档。 仓库为 google/elephant-goldfish-model,homepage 为 egm.dev,API 识别 Apache-2.0;README 同时声明不是由 Google 提供官方支持的产品。 这些是关注度和维护快照,不是采用量、效果或供应商支持承诺。

⚙️ 功能完整度 2.2/2.5

  • 证据:七项技能覆盖概念简报、分节草稿、新上下文评审、发现处理、代码库说明、文档漂移和自定义评审循环。来源:README。
  • 竞品对比 1(OpenSpec):OpenSpec 围绕 proposal、specs、tasks 和变更归档组织规格;EGM 更突出作者与新上下文评审者分离,不能因此说两者质量存在已测差距。
  • 竞品对比 2(Aider):Aider 集中在终端内改代码、Git 和 lint/test;EGM 补的是设计审查层,并不代替 Aider 这类实现工具。
  • 扣分:实现、测试、部署仍依赖宿主与项目流程,不是端到端交付系统。

✨ 输出质量 1.8/2.5

  • 证据:简报与规格形成文件,分节反馈后再评审,评审者不读此前对话、但可以读引用材料。来源:工作流指南。
  • 竞品对比 1(OpenSpec):OpenSpec 的 requirements/scenarios 让需求具象化;EGM 用额外评审者发现没写出的假设,两者都是质量控制机制,本文未比较实际缺陷检出率。
  • 竞品对比 2(Aider):Aider 可通过 lint/test 检查实现;EGM 的文档意见仍是模型判断,不能把一份评审报告等同于代码测试通过。
  • 扣分:没有本站基准或产物复核;宿主指令仍可能进入评审上下文,评审意见也可能错误或重复。

🖐️ 易用性 1.2/1.5

  • 证据:Claude Code 与 Codex CLI 各有两条官方安装命令,支持先评审现成文档;但要安装完整资源并重开会话。来源:README 安装。
  • 竞品对比 1(OpenSpec):OpenSpec 通过 CLI 和 init 为项目配置技能;EGM 走宿主插件市场,少一套独立 CLI 但更受宿主插件界面影响。
  • 竞品对比 2(Aider):Aider 的入口是独立终端工具;EGM 要理解宿主的命名空间或技能选择器,已熟悉 Claude/Codex 的人更容易开始。
  • 扣分:/egm: 与 Codex 选择器不可混用;只有技能文件而缺 agents/resources 时会失败。

💰 性价比 1.2/1.5

  • 证据:Apache-2.0 许可,无单独插件订阅报价;实际模型与宿主费用不包含在许可内。来源:README 许可。
  • 竞品对比 1(OpenSpec):OpenSpec 同为公开的规格工具,模型费用仍取决于接入的助手;EGM 的多评审者会增加调用,不能凭免费代码判断哪一个总成本更低。
  • 竞品对比 2(Aider):Aider 也由用户选择云端或本地模型;EGM 聚焦设计阶段,两者预算要按自己的任务长度计算,而非拿安装费用比较。
  • 扣分:缺少统一的 token、时延和费用实测;多轮评审的收益尚需用项目样本验证。

🔒 稳定性 0.8/1.0

  • 证据:仓库近期仍推送,Harnesses 披露安装/流程 fixture 与各宿主验证缺口;没有子代理时应停止评审。来源:Harnesses。
  • 竞品对比 1(OpenSpec):OpenSpec 的 CLI/schema 与 EGM 的插件/宿主组合有不同故障面;不能用其中一方安装成功证明另一方的运行链路。
  • 竞品对比 2(Aider):Aider 独立管理终端编辑流程;EGM 还依赖宿主实际开放的子代理工具与插件版本,兼容性须分别核实。
  • 扣分:部分云端与实验性宿主仍有 trace/端到端验证缺口;本文不把官方 fixture 当本站实测。

🛡️ 隐私安全 0.7/1.0

  • 证据:文档明确评审者应只读,新上下文隔离不等于排除宿主指令;资料仍受所用模型与宿主处理规则影响。来源:隔离与权限说明。
  • 竞品对比 1(OpenSpec):OpenSpec 与 EGM 都把规格放在项目文件中;文件在本地不意味着不会被宿主发给模型,均需独立确认数据路径。
  • 竞品对比 2(Aider):Aider 会读取代码供模型处理;EGM 会读取设计及其引用材料,敏感信息范围不同,但都不应默认等同于离线工具。
  • 扣分:没有本站权限绕过、数据外流或隔离测试;bootstrap 有写文档副作用,不能概括所有技能为只读。

维度求和核对

2.2 + 1.8 + 1.2 + 1.2 + 0.8 + 0.7 = 7.9;JSON 的 rating 与 starRating 同为 7.9。

标签说明

  • 规格驱动开发:简报到规格、批准后再实现是官方核心流程。来源:工作流指南。
  • 设计评审:egm-review 检查设计、清晰度、代码适配与实施计划。来源:README。
  • 多智能体:Goldfish 依赖新上下文子代理,并非原对话里的角色扮演。来源:Harnesses。
  • 开源:仓库代码按 Apache-2.0 许可提供,不代表 Google 官方支持承诺。来源:README。

来源核实与局限

  • 直连读取官网、README、工作流、Harnesses 和 GitHub API;未进行浏览器交互验证。
  • 对照项仅依据已读取的 OpenSpec 与 Aider 官方 README,比的是公开工作方式,不是运行胜率或速度排名。
  • 未独立实测安装、评审隔离、发现准确性、输出时延和真实费用;文档与宿主支持可能继续变化。

同分类推荐

AI编程 分类下的其他工具

)}