跳转至

宿主环境

EGM 是一套技能与人设。本仓库是每个受支持运行环境的插件来源。任何运行环境都不会单独复制一份技能文本。

安装

运行环境 安装方式
ChatGPT 桌面版 安装已发布的 EGM 插件(仅桌面版列出);个人测试请参阅打包
Codex 桌面版 安装已发布的 EGM 插件(仅桌面版列出)
Antigravity CLI agy plugin install https://github.com/google/elephant-goldfish-model
Antigravity App 运行 /plugin 或参阅安装说明
Antigravity for IDEs 运行 /plugin 或参阅安装说明
Antigravity IDE(独立版) 不支持;请参阅安装说明
Claude Code claude plugin marketplace add google/elephant-goldfish-model && claude plugin install egm@egm
Claude Cowork 从 claude.ai/plugins 或 Cowork 插件面板通过 marketplace google/elephant-goldfish-model 安装
Codex CLI codex plugin marketplace add google/elephant-goldfish-model && codex plugin add egm@egm
ChatGPT 工作区导入 管理 > 插件 > 添加 > 导入 marketplace,仓库 URL https://github.com/google/elephant-goldfish-model,路径 .agents/plugins;云端审核限制仍然适用
omp omp plugin marketplace add google/elephant-goldfish-model && omp plugin install egm@egm
Muse git clone https://github.com/google/elephant-goldfish-model.git && muse plugins install ./elephant-goldfish-model --scope user && muse plugins approve egm

请安装完整插件。仅复制 skills/ 的技能安装器会破坏 EGM,因为技能在运行时会读取 agents/ 和 resources/document_standards/。

Antigravity App 与 Antigravity for IDEs

  • Antigravity App:运行 /plugin、让代理执行 Install https://github.com/google/elephant-goldfish-model,或使用以下命令手动安装到 ~/.gemini/config/plugins/egm/。
  • Antigravity for IDEs(Visual Studio Code 扩展):运行 /plugin、让代理执行 Install https://github.com/google/elephant-goldfish-model,或使用以下命令手动安装到 ~/.gemini/config/plugins/egm/。
  • Antigravity IDE(独立版):目前不支持。虽然插件和技能会从 ~/.gemini/config/plugins/egm/ 加载,但独立版 Antigravity IDE(已在 macOS 和 Linux 上测试)未提供 Goldfish 审查(/egm-brainstorm 和 /egm-review)所需的 fresh-context 子代理工具(invoke_subagent)。

Antigravity App 与 Antigravity for IDEs 共用全局插件目录 ~/.gemini/config/plugins/<name>/。要在没有 agy CLI 的情况下进行全新手动安装,请将完整运行时包复制到 ~/.gemini/config/plugins/egm/(复制到已有插件目录可能会留下过时文件,因此更新时请先删除 ~/.gemini/config/plugins/egm):

git clone https://github.com/google/elephant-goldfish-model.git
cd elephant-goldfish-model
mkdir -p ~/.gemini/config/plugins/egm
cp -R plugin.json README.md LICENSE skills agents resources docs assets ~/.gemini/config/plugins/egm/

重新加载窗口(或重启 Antigravity App),然后确认 egm 出现在插件列表中,且其技能(egm-brainstorm、egm-draft、egm-review)可用。这些技能在 Antigravity App 与 Antigravity for IDEs 中的命令形式尚未验证。

清单

根目录下的 plugin.json 是插件身份、版本、描述和发布者元数据的规范来源。它遵循可移植的 Agent Plugins 1.0.0 格式;其中省略了 $schema 键,因为 omp 会将声明了该键的清单路由到一个严格校验器,而该校验器会拒绝 disable-model-invocation。请先更新那里的共享值,然后更新兼容清单;单元测试会拒绝元数据漂移。在安装测试证明可以移除之前,请将平台特定字段保留在现有清单中。

Marketplace 文件是指向此包的发现目录,而非其技能的副本。具体来说,.agents/plugins/ 包含 Codex 目录,而 agents/ 包含审查人设。所有运行环境共享相同的 skills/、agents/ 和 resources/ 内容。

运行环境 Manifest 技能 子代理
Antigravity plugin.json skills/(默认) agents/(默认)
Claude Code .claude-plugin/plugin.json、.claude-plugin/marketplace.json skills/(默认) plugin.json 的 agents 中列出的 Claude 适配器与编排器
Claude Cowork .claude-plugin/plugin.json、.claude-plugin/marketplace.json skills/(默认) 子代理在 Cowork 内运行;hooks 不适用
Codex .codex-plugin/plugin.json、.agents/plugins/marketplace.json skills 路径 未随附;通用子代理读取人设文件
ChatGPT plugin.json、.codex-plugin/plugin.json;用于工作区导入的 .agents/plugins/marketplace.json skills 路径 检测当前会话中的原生工具;通用代理读取人设
omp .claude-plugin/plugin.json、.claude-plugin/marketplace.json(Claude 兼容回退) skills/(默认) 来自 agents//.claude-plugin/agents/ 的人设会注册为原生 task 代理
Muse .claude-plugin/plugin.json(Claude 兼容回退) skills/(默认) 10 个适配器以代理形式导入;不支持工具投射(tool projections)

人设提示词位于 agents/ 中,即 Antigravity 用来扫描子代理的目录。每个人设都带有 name 和 description 前置数据(frontmatter),因此加载 agents/*.md 的运行环境会将它们注册为具名子代理(egm-design、egm-zoom-out 等)。

当你新增审查人设时,请在 .claude-plugin/agents/ 下添加一个 Claude 适配器,并将其列在 .claude-plugin/plugin.json 中。该适配器会读取共享人设,并设置 Claude 的只读工具和上下文隔离。这样可以避免将 Claude 的工具命名强加给其他运行环境。在 Claude Code 中,/plugin > Errors 会报告默认的 agents/ 文件夹被忽略,因为清单设置了 "agents";此警告是预期且无害的(参阅 Claude 集成)。

委派

技能会说“spawn a subagent”并指定一个角色。每个 harness 都会将该短语映射为自家的工具:

Harness 子代理工具 命名角色 嵌套
Antigravity invoke_subagent 是 是
Claude Code Agent (Task) tool 是 默认最多 3 级
Claude Cowork Cowork subagents 是 子代理在 Cowork 内部运行
Codex 原生 spawn/wait 工具;检查可用的 schema 否 运行时检测;直接派发回退
ChatGPT 当前 Work 会话暴露原生 spawn/wait 工具时 否 运行时检测;直接派发回退
omp task tool 是 是
Muse 原生子代理;检查可用的 schema 在 1.4.14 中,命名生成(named spawn)被拒绝;已验证通用回退方案 运行时检测;直接派发回退

如果某个 harness 没有命名角色,技能会生成一个通用子代理,并让子代理先阅读 agents/<file>.md。如果 harness 无法嵌套子代理,则使用直接派发(direct dispatch)而不是合成器(synthesizer)。

Goldfish 评审需要全新的上下文。如果某个 harness 没有子代理工具,评审技能会停止,而不会在同一个上下文中运行。应检查实际可用的工具,而不是根据产品名称来推断。这适用于独立的 Antigravity IDE,以及那些不提供原生全新上下文委派功能的 ChatGPT 模式。

全新的对话上下文并不意味着宿主会省略其指令文件。Codex 的 fork_context: false 和 fork_turns: "none" 只是隔离父级轮次;它们并不能证明项目或用户指令被排除在外。请将稳定的工作区约定保存在指令文件中。将评审中需要 Goldfish 提出质疑的假设,作为明确的评审标准(review criteria)陈述出来。

工件目录

技能会将简报(briefs)、草稿(drafts)和报告(reports)写入工作目录;如果 harness 有工件目录(artifact directory),则写入该目录。在 Claude Code、Claude Cowork、Codex 和 ChatGPT 中,你可以指定另一个文件夹。将下面这一行添加到你的提示词中,或添加到你的 harness 加载的代理指令文件(CLAUDE.md 或 AGENTS.md,位于项目级或用户级):

EGM artifact directory: .dev/docs

相对路径是相对于工作目录的。如果指令文件中设置的路径在解析符号链接后指向工作目录之外,EGM 会要求你在创建文件夹或向其写入之前进行确认。如果你拒绝,或者无人能够确认(例如在无头(headless)运行中),文件将被写入工作目录。该回答不会被保存,因此新会话会再次询问。提示词中的路径无需确认。设计文档和其他项目文件不会移动。只有当项目没有 CLAUDE.md 时,Claude Code 才会读取项目的 AGENTS.md。

将已批准的规格说明提交到 docs/designs/,将项目规则提交到 AGENTS.md。这样,团队成员和代理就可以使用同一组已提交的文件。只有在批准前需要将临时草稿排除在 git 之外时,才将 .dev/docs 添加到 .gitignore。

支持状态与贡献其他 Harness

Antigravity CLI、Claude Code 和 Codex 通过了自动化安装与端到端工作流测试(fixtures)。评审者隔离的证据范围更窄:父级轮次隔离与宿主指令排除是独立的结果。

Claude 评审适配器会设置 omitClaudeMd: true;参见 Claude 集成。对于 Codex,issue #237 报告称,尽管设置了 fork_turns: "none",Codex CLI 0.166.0 仍提供了项目级和用户级的 AGENTS.md 文件。对于 Antigravity CLI,同一 issue 报告了评审上下文中出现项目级 AGENTS.md 和 GEMINI.md。这些是被报告的宿主指令泄漏(host-instruction leaks),而不是父级对话轮次发生泄漏的证据。Codex 测试和已记录的 Antigravity 运行只检查了父级轮次隔离;两者都没有验证指令文件排除。此处没有对 Codex 或 Antigravity 验证任何特定于宿主的排除控制。

Claude Cowork(#105)和 ChatGPT Work(#106)具有可用的安装路径,但在云端跟踪验证方面仍有待填补的缺口。README 的前缀指导仅涵盖 Antigravity(agy CLI)、Claude Code 和 Codex。对于 ChatGPT 工作区导入,技能通过 @egm 访问(参见 ChatGPT);Claude Cowork 中的命令形式尚未记录。

omp(#186)已有可用的安装路径。技能以 /skill:egm-<command> 形式调用(omp 为每个技能注册一个命令;它没有 /egm-* 命名空间)。已在 omp v18.12.6 上由社区验证:全部七个技能均可被发现并解析,全部九个评审角色均注册为子代理。omp 的端到端工作流测试(fixtures)尚未自动化。

Muse(1.4.14)已有可用的安装路径。muse plugins validate 报告插件有效,支持全部七个技能和全部十个代理适配器;所有代理工具投影(agent tool projection)均不受支持,因此 Claude 工具允许列表不会限制 Muse 评审者。请从本地路径安装;在此仓库上执行 marketplace add 会发现零个插件,因为 Muse 会先读取 Codex 目录。端到端工作流测试(fixtures)已于 2026-10-30 通过(头脑风暴、草稿,以及使用 15 个全新上下文评审者的不间断评审);在该运行时中无法生成命名的 egm/egm-* 代理,因此评审者使用了通用回退方案,先读取已安装的角色。参见 Muse 指南。目前还没有技能将 Muse 会话路由到该指南(#252),因此请将会话指向该指南。

Windsurf(2026-06-02 更名为 Devin Desktop;#376)具有实验性的工作区路由。规则和工作流文件会直接解析共享的 skills/*/SKILL.md、agents/*.md 和 resources/document_standards/*.md 文件,而不会复制技能文本。如果无法进行全新上下文、只读的子代理委派,Goldfish 评审将停止;评审者会在宿主的只读子代理配置(profile)上启动。Devin CLI 3000.12.43 在 2026-11-10 的运行通过了路由、人工暂停、只读评审者和父级标记隔离,且所有文件写入均被拒绝,因此没有工作流运行到最终工件。Devin Desktop 和 Devin CLI 运行同一个代理 Devin Local,它取代了 Cascade。Devin Desktop IDE 仍未经过测试。CLI 不会将 .windsurf/workflows/ 列为斜杠命令;/egm-* 请求通过规则路由。拒绝权限提示会结束宿主的当前轮次且不发送消息;请发送后续消息以继续。证据参见设计文档。

请参阅 集成环境测试记录 了解已测试的界面和限制。

我们欢迎希望帮助验证和扩展集成环境支持的贡献者。

为新的集成环境贡献支持

某个集成环境在 /egm-brainstorm、/egm-draft 和 /egm-review 通过其插件安装端到端运行后,即被视为受支持。要为另一个集成环境贡献支持:

  1. 在仓库根目录添加相应的 manifest 或配置文件(例如,符合该集成环境的插件/扩展标准)。
  2. 在本指南(docs/harnesses.md)中记录安装步骤、manifest 映射和委托机制。
  3. 验证 /egm-brainstorm、/egm-draft 和 /egm-review 能否端到端运行,并在你的 PR 描述中附上验证说明或执行记录(如 PR 模板 所述)。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model