SkillMap

Oct 28, 2026

用 Elephant-Goldfish Model 让零上下文评审者给设计文档挑刺

EGM 是 google GitHub 组织下的 3k 星标 Apache-2.0 插件：带完整上下文的 Elephant 起草规格文档，全新的零上下文 Goldfish 子 agent 评审它以暴露未言明的假设，由你在写任何代码之前批准设计——七个 skill，支持五种编码 agent，包括 Antigravity、Claude Code 和 Codex。

#tutorial#architecture#engineering

一份设计文档如果由写它的那个 agent 来评审，就会继承对话里所有被固化的假设。Elephant-Goldfish Model（EGM）是 google GitHub 组织下发布的 3k 星标 Apache-2.0 插件，它把角色拆开：拥有完整项目上下文的 Elephant 负责起草，完全不知道那段对话的 Goldfish 评审者负责检查草稿，而决定权在你。

为什么这个 Skill 重要

README 自己的框架是一张三个角色的表。Elephant 持有你的项目、需求和先前决策，负责起草规格文档。Goldfish 评审者只看到文档及其引用的源材料，不带先前的对话，README 说这有助于暴露未言明的假设和盲点。你负责权衡取舍、批准设计、决定要构建什么。README 声明有数千名 Google 工程师在使用 EGM，其许可证部分又补充说这不是 Google 官方支持的产品。这套思路来自 Dave Rensin 关于大象与金鱼的文章，README 给出了链接。

按 README 的原话，当一个功能在实现前需要做设计决策时用它；对于小而明确的 bug 修复，用你平常的编码流程。

安装

选择你的编码 agent。README 要求安装完整插件，因为这些 skill 会读取评审者提示词和文档标准；harness 指南明确指出，只复制 skills/ 目录的纯 skill 安装器会让 EGM 无法工作，因为这些 skill 在运行时要读取 agents/ 和 resources/document_standards/。

# Antigravity
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
codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm

安装后开启一个新会话。Claude Cowork 和 ChatGPT Work 在 docs/harnesses.md 里有各自的设置指南；按该指南，Antigravity、Claude Code 和 Codex 通过了自动化的安装、评审者隔离和端到端工作流测试，而 Claude Cowork 和 ChatGPT Work 已有可用的安装路径，但云端轨迹验证仍有未关闭的缺口。

实战：设计 webhook 投递

README 的快速上手是给一个项目添加 webhook 投递——投递失败时该怎么办，同一事件到达两次又该怎么办？下面的命令是 Antigravity 的写法；在 Claude Code 里用 /egm: 前缀（例如 /egm:egm-brainstorm），在 Codex 里从 skill 选择器中选取 EGM skill。头脑风暴和评审都要求会话能够创建全新的子 agent。

  1. 探索想法。 与 agent 讨论需求和取舍；全新的评审者会质疑提案，agent 把达成一致的方向保存到 concepts_brief.md。
/egm-brainstorm Add webhook delivery to this project.
  1. 起草规格文档。 agent 把简报转成 design_draft.md，每写完一节就暂停，在聊天中等你反馈。
/egm-draft
  1. 评审草稿，使用 agent 返回的草稿路径。全新的评审者检查设计本身、清晰度、与代码的契合度以及实现计划。由你选择要处理哪些发现。
/egm-review design_draft.md

批准设计后，让你的编码 agent 去实现。入门指南补充了快速上手没有明说的两步：把设计以 pull request 的形式交给另一个人评审，因为 EGM 不取代人工监督；并且要预期评审会按设计返回大量反馈——取你认为相关的，其余忽略。

七个 Skill

README 的 skill 表列出七个，并说明你不必走完整个序列：

Skill用途
Brainstorm检验一个想法并写出概念简报
Draft把简报或已有笔记变成设计文档
Resolve逐条处理评审发现并就修改达成一致
Bootstrap为现有代码库创建或更新文档
Review用全新的 agent 分五个阶段评审一份设计
Review loop针对特定评审任务运行一组配置好的评审者
Drift report把已提交的文档与当前源代码做比对

按入门指南，Bootstrap 是自底向上工作的：先为每个叶子目录生成 README.md，再逐级向上汇总父目录，最后把根目录 README 编译成系统的全貌图。同一份指南建议每周运行一次 drift report，并把分歧当作需要人来决定的事——改文档，或者改代码。

技巧

  • Goldfish 评审要求全新的子 agent 上下文；如果你的 agent 无法创建，EGM 会停止评审，而不是在同一上下文里硬跑。
  • 要让简报、草稿和报告不落在工作目录里，harness 指南给出了一行可写进提示词或 CLAUDE.md / AGENTS.md 的配置：EGM artifact directory: .dev/docs。
  • 入门指南建议建一个可选的 <project>-elephant skill，告诉 LLM 你的项目是什么，并链接你认为最相关的上下文。
  • 在推荐的目录布局里，草稿落在 docs/designs/ 下，并附带一个 SITEMAP.md 索引。

何时不用这个 Skill

README 说得很直白：评审不取代测试和人的判断，小而明确的 bug 修复应该走你平常的编码流程。整套模型依赖一个能派生全新子 agent 的 harness——没有这个工具，评审类 skill 会直接停止。

查看 排行榜 了解更多 skill。