EGM：用Elephant与Goldfish审查软件设计文档
一个给AI编程代理做软件设计和文档复审的插件，Elephant记住上下文，Goldfish隔离对话找盲点。
GitHub google/elephant-goldfish-model 更新 2026-11-14 分支 main 星标 18.6K 分叉 1.4K
Python JavaScript AI编程代理 软件规格设计 Claude Code Codex CLI Antigravity CLI

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你用Claude Code、Codex CLI或Antigravity，并有README、PR计划或设计文档要复审
    README的“Try a 60-second review on existing code”列出/egm:egm-review和/egm:egm-drift-report；Install章节列出三种代理
  • 你正在设计类似webhook delivery的功能，需要Brainstorm、Draft和Review分步处理取舍
    README的“Try your first design”以webhook delivery示例展示/egm-brainstorm、/egm-draft和/egm-review
  • 你希望复审者不继承早期对话，以发现未声明假设和盲点
    README正文说明Goldfish只读取文档及其引用源材料，不带earlier conversation

不适合，如果你

  • 你的代理不能创建fresh subagents，却需要运行Goldfish Review
    README的“How it works”明确写道：Goldfish reviews require fresh subagent contexts；无法创建时EGM stops the review
  • 你要把EGM Review当作测试或人工架构判断的替代品
    README的“How it works”明确写道：A review does not replace tests or human judgment
  • 你只使用Antigravity CLI 1.4.8并计划省略/egm:前缀
    README说明agy CLI 1.4.8不会像1.4.10一样把未加前缀的名称补全为带前缀命令

前置条件

  • 需要选择支持的coding agent，并安装完整插件，以便skills读取reviewer prompts和document standards。
  • Brainstorming和Review需要能够创建fresh subagents的session。
  • Antigravity CLI可执行：agy plugin install https://github.com/google/elephant-goldfish-model
  • 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
  • 安装后需要Start a new session after installation。

第一步命令（README 原文）

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

要注意

  • Codex不会使用README中的/egm:文本命令，而是要从skill picker选择对应EGM skill
    README的“Try a 60-second review on existing code”和“Try your first design”均说明Codex使用skill picker
  • Review现有文档时，/egm:egm-review需要传入设计文档或PR计划的Markdown路径
    README命令示例为/egm:egm-review docs/designs/webhooks.md，并说明路径可指向Markdown文档
  • 批准设计后仍需让coding agent实现，EGM不会自动替代实现流程
    README的“Try your first design”写道：When you approve the design, ask your coding agent to implement it

材料未说明

  • docs/harnesses.md中的完整支持环境、代理能力和已知限制未在材料中展开。
  • TESTING.md中的具体检查项、执行记录格式和验证限制未提供。
  • 材料没有说明EGM使用的具体基础模型、模型供应商或推理成本。
  • 材料没有给出Review、Drift report或完整设计流程的运行耗时和资源需求。
  • 材料没有说明项目文档或源代码是否会发送到外部模型，以及数据隐私和网络要求。
  • 材料没有提供与其他设计评审工具的功能、性能或结果对比。

💡 深度解析

6
适合 我在 Claude Code 中维护一个已有代码库，想先审查 `docs/designs/webhooks.md` 与当前代码是否一致，再决定是否实施；EGM 是否适合我的流程？
适合读者： 使用 Claude Code、维护已有软件代码库并希望在编码前完成设计评审的开发者

适合，因为 EGM 可以直接审查已有设计文档，并把文档与源代码的匹配度纳入评审，而不要求先重新创建规格。

  • README 的“Try a 60-second review on existing code”明确支持 /egm:egm-review docs/designs/webhooks.md，评审会检查设计清晰度、代码适配性和实施计划。
  • Goldfish 使用不继承早期对话的新鲜子代理上下文，输入是设计文档及其引用的源材料，有助于发现未声明假设。
  • 评审不会自动替代测试或人工判断；你仍需选择处理哪些 findings，并批准设计后再让编码代理实施。
  • Claude Code 的安装方式和命令已在 README 中列出，但安装后必须启动新会话。
  • Try a 60-second review on existing code：`/egm:egm-review docs/designs/webhooks.md`
  • How it works：Goldfish reviews the document and its referenced source material, without the earlier conversation
  • How it works：A review does not replace tests or human judgment
  • Install：Start a new session after installation
/egm:egm-review docs/designs/webhooks.md
材料未说明：README 未说明评审能发现多少实际缺陷，也未给出大型代码库的性能或上下文规模上限。；未说明 Claude Code 使用的具体底层模型、调用成本和单次评审延迟。
适合 我使用 Codex CLI，希望把一个新功能先经过 brainstorm、draft、review，再由编码代理实现；但我不想被强制执行完整流程，EGM 是否适合？
适合读者： 使用 Codex CLI、希望采用规格驱动开发并在批准后再让代理编码的个人开发者

适合，因为 EGM 的技能可以单独调用，同时仍支持从概念探索到批准规格的完整流程。

  • README 的“Choose a skill”说明 Brainstorm、Draft、Resolve、Review 等技能可按需使用，不必遵循完整序列。
  • Brainstorm 会保存 concepts_brief.md，Draft 将简报或已有笔记转换为 design_draft.md，Review 再针对该文档执行独立评审。
  • Codex CLI 使用 skill picker 选择对应 EGM skill，而不是照搬 Claude Code 的 /egm: 命令；这避免了宿主命令格式混用。
  • 最终架构取舍和规格批准仍由你负责，项目不会把代理生成结果直接视为可实施方案。
  • Choose a skill：You can use each skill when you need it. You do not have to follow the full sequence.
  • Try your first design：the agent saves the agreed direction in `concepts_brief.md`
  • Try your first design：the agent turns the brief into `design_draft.md`
  • Try your first design：In Codex, select the corresponding EGM skill from the skill picker
codex plugin marketplace add google/elephant-goldfish-model
材料未说明：README 未说明 Codex CLI skill picker 中显示的确切名称或不同版本的界面差异。；未说明批准规格能否自动触发 Codex 的实现任务。
适合 我们把已批准的规格保存到 `docs/designs/`，代码持续迭代，想定期找出文档与当前实现的差异；EGM 能否支持这个维护约束？
适合读者： 维护中大型代码库、已将设计文档存放在 `docs/designs/` 并担心文档与实现逐渐偏离的工程团队

适合，因为 EGM 提供专门的 drift report，用当前源代码对登记文档进行比对，并把修复方向留给团队决定。

  • README 的“Check for drift”示例直接使用 /egm:egm-drift-report docs/designs/，代理会比较目录中的每份文档与当前源代码。
  • Getting started 流程建议把批准规格保存到 docs/designs/，因此该目录结构与持续维护场景是匹配的。
  • Drift report 只报告文档和实现在哪里发生偏差，不自动判断应修改文档还是代码；这保留了架构决策责任，但不能当作自动同步机制。
  • 项目仍是 v0.1.1、只有两个 release，README 没有证明它在大型、多仓库或复杂权限环境中的长期稳定性。
  • Try a 60-second review on existing code：`/egm:egm-drift-report docs/designs/`
  • Try your first design：saving approved specifications under `docs/designs/`
  • Common pitfalls：You decide whether to update the document or the code
  • 项目数据：latest release v0.1.1；release count 2
/egm:egm-drift-report docs/designs/
材料未说明：README 未说明 drift report 的扫描规模、运行时间、误报率或多仓库支持。；未说明文档引用路径失效时报告如何处理，也未说明是否能集成 CI/CD。
视情况 我所在项目固定使用 Antigravity CLI 1.4.8，想运行 EGM 的 brainstorm 和 review；由于这个版本不会自动补全命令前缀，我应该采用 EGM 吗？
适合读者： 使用 Antigravity CLI 1.4.8、需要在旧版本环境中运行独立评审的开发者

视情况；只要团队能接受始终使用 /egm: 前缀且该会话支持 fresh subagents，Antigravity CLI 1.4.8 仍可尝试，否则独立评审无法正常工作。

  • README 明确指出 agy CLI 的命令应使用 /egm: 前缀；1.4.8 不会像 1.4.10 那样自动补全，因此不能依赖无前缀输入。
  • Brainstorming 和 review 要求会话能够创建 fresh subagents；Goldfish 若无法创建新上下文，EGM 会停止评审。
  • 安装命令是 agy plugin install ...，且安装后需要开启新会话。
  • README 没有承诺 Antigravity 1.4.8 的完整能力矩阵，因此是否可用取决于实际宿主是否提供子代理能力。
  • Try your first design：agy CLI and Claude Code should use the `/egm:` prefix
  • Try your first design：agy CLI 1.4.10 auto-completes the prefix, but 1.4.8 does not
  • Try your first design：Brainstorming and review require a session that can create fresh subagents
  • How it works：If your agent cannot create them, EGM stops the review
agy plugin install https://github.com/google/elephant-goldfish-model
材料未说明：README 未明确列出 Antigravity CLI 1.4.8 是否支持 Goldfish 所需的 fresh subagents。；未说明 Antigravity CLI 旧版本的插件安装、权限和模型调用限制。
视情况 我不只审查软件规格，还要审查产品需求和运营流程文档；希望自己选择 reviewer 和 standards，而不是套用默认 design-review，EGM 是否适合？
适合读者： 需要审查产品需求、运营流程等非软件规格文档，并计划使用自定义评审者和标准的技术负责人

视情况；EGM 支持可配置的 review loop，但默认 draft 和 design-review 工作流主要面向软件规格，非软件文档需要你自行配置评审者与标准。

  • README 明确说明默认工作流针对 software specifications，其他文档应使用 /egm-review-loop 选择 reviewers 和 standards。
  • “Choose a skill”列出 Review loop，可为特定 review task 运行配置过的 reviewer group。
  • 这使 EGM 能承载更广泛的文档评审，但项目没有提供产品、运营或组织治理领域的内置标准清单。
  • Bootstrap 和 drift reporting 适用于 software codebases，不能据此推断非软件文档也能获得代码对照能力。
  • README opening：The built-in draft and design-review workflow targets software specifications
  • README opening：For other documents, choose reviewers and standards with `/egm-review-loop`
  • Choose a skill：Review loop runs a configured group of reviewers for a specific review task
  • README opening：Bootstrap and drift reporting apply to software codebases
/egm-review-loop
材料未说明：README 未说明自定义 reviewer 和 standard 的配置文件格式、字段和验证方式。；未说明非软件文档评审是否支持与软件规格相同的五阶段流程。
视情况 我在 ChatGPT Work 或 Claude Code 中处理包含受限业务信息的代码库，想用 EGM 评审设计文档；在没有明确数据治理说明前，我是否应该采用？
适合读者： 在受限代码库中使用 ChatGPT Work 或 Claude Code、需要评估源代码和敏感信息是否会被代理读取的开发者

视情况；EGM 的评审确实需要读取项目上下文、设计文档及引用的源材料，但 README 没有给出 ChatGPT Work 或 Claude Code 的数据保留、模型访问和敏感信息处理承诺。

  • Elephant 使用项目上下文、需求和既有决策起草规格，Goldfish 使用文档及其引用的源材料进行评审，因此代码访问范围是决策前提。
  • README 提供 ChatGPT Work 和 Claude Code 的 setup 入口，但没有说明企业数据是否离开本地环境、如何脱敏或是否支持权限隔离。
  • 项目是 Apache 2.0，降低了内部定制的许可障碍，但许可证不能替代模型服务的数据治理控制。
  • 对受限代码库而言，是否采用取决于组织对宿主、模型、代理权限和敏感资料流向的批准，而不是仅凭插件功能判断。
  • How it works：Elephant receives your project, requirements, and earlier decisions
  • How it works：Goldfish receives the document and its referenced source material
  • Install：For Claude Cowork and ChatGPT Work, see the setup guide
  • License：Apache 2.0
材料未说明：README 未说明 ChatGPT Work、Claude Code 或其他宿主的数据保留、训练使用和跨境传输策略。；未说明 EGM 是否提供敏感信息脱敏、路径白名单、细粒度权限控制或审计日志。

✨ 核心亮点

  • Elephant保留项目上下文并起草规格，Goldfish隔离对话复审文档
  • 支持/egm:egm-review与/egm:egm-drift-report两类现有文档检查
  • 覆盖Brainstorm、Draft、Resolve、Review等独立技能
  • 项目仅有10位贡献者和2个版本，最新为EGM v0.1.1

🔧 工程化

  • 用/egm-brainstorm探索方案，再由/egm-draft生成design_draft.md
  • Goldfish跨五个阶段检查设计清晰度、代码匹配度和实现计划
  • Bootstrap与Drift report可为代码库创建或检查文档一致性

⚠️ 风险

  • 代理无法创建fresh subagents时，Goldfish复审会直接停止
  • README明确说Review不替代测试或人工判断，验证边界需看TESTING.md
  • Antigravity CLI 1.4.8不会补全前缀，需保留/egm:命令前缀

👥 适合谁？

  • 使用Claude Code、Codex CLI或Antigravity的代码团队
  • 需要审查design_draft.md、PR计划或docs/designs/的工程师
  • 希望让项目上下文与新鲜复审视角分离的软件规格作者