跳转至

Claude Code 集成

使用 Claude Code 2.1.271 或更高版本以获得 omitClaudeMd 支持。旧版本不得被视为已验证的 Goldfish 隔离环境。

调用与资源

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

使用 claude plugin enable egm@egm 启用已安装的插件。以 /egm:egm-brainstorm、/egm:egm-draft 或 /egm:egm-review 开头发送消息。技能保留 disable-model-invocation: true:它们不出现于自动技能发现中是预期行为。Skill 工具会拒绝这些技能,因此若要运行其他 EGM 技能(例如评审阶段 7 和 9 中的 egm-review-loop 或 egm-resolve),请阅读其 SKILL.md 并在同一线程中遵循其步骤。不要对 EGM 技能使用 Skill 工具。将起草和编排工作保留在主上下文中。 Claude Code 没有工件注释功能。若要请求草稿修订,请直接编辑 design_draft.md 或在其中添加 <!-- --> 注释,或在聊天中给出说明;模型会在每次修订前重新阅读草稿。 将简报、草稿和报告写入用户的工作目录。每会话的临时记录区不是工件目录:它属于单个会话,而交付物必须在其结束后仍然存在。 如果用户的提示或代理指令文件(CLAUDE.md 或 AGENTS.md)中包含一行 EGM artifact directory: <path>,请改为写入该文件夹。相对于工作目录解析相对路径。如果来自指令文件的路径在解析符号链接后指向工作目录之外,请在创建文件夹或写入之前请求用户确认。如果用户拒绝或无人能够确认,则使用工作目录并说明原因。如果文件夹不存在,请创建它。 在 Claude Code 中,egm:egm-synthesizer 可以派生评审者(默认允许最多 3 层嵌套),或者主上下文可以直接分派评审者。在 Claude Cowork 中,子代理无法再派生子代理,因此请直接从主上下文分派评审者,而不是启动合成器子代理。在这两种情况下,都由主上下文收集发现并撰写报告。 保持评审阶段 5、6、7、8 和 9 的顺序执行。仅并行化当前阶段内的评审者。等待该阶段的所有评审者完成,撰写其报告,并在分派下一阶段之前完成所需的补救工作。不间断模式会跳过人工检查点,但不会跳过这些阶段依赖关系。

Claude 会在插件技能和代理主体中替换 ${CLAUDE_PLUGIN_ROOT}。将解析后的绝对根目录用于 agents/、resources/ 和 docs/;将被调用技能的目录用于其 references/。本独立指南作为文件读取,因此此处的占位符仅为说明用途:请使用被调用技能中已解析的根目录。切勿猜测缓存版本或搜索其他已安装副本。评审目标和生成的工件属于用户的工作区,而非插件缓存。向每位评审者传递绝对资源和目标路径。

角色设定和标准位于项目之外的插件缓存中。EGM 不会安装权限批准钩子。请通过 Claude Code 的常规权限提示批准资源读取;当前版本可以在父会话中显示后台评审者提示。对于无头运行,用户必须使用 Claude Code 的权限设置授予对已解析插件的 agents/、docs/、resources/ 和 skills/ 文件夹的读取访问权限。将写入访问权限限制为项目、预期输出目录以及用于临时文件的会话或私有临时目录。mktemp -d 路径无法提前在规则中命名,因此无头运行如果没有针对其父文件夹的规则,就无法使用该路径。不要禁用权限检查或授予对所有已安装插件的访问权限。无法读取其角色设定或标准的评审者必须报告该限制并停止;它并未进行评审。

例如,在解析实际安装的插件目录后,只将其资源文件夹添加到 /permissions 中用户批准的读取规则:

Read(//absolute/plugin/path/agents/**)
Read(//absolute/plugin/path/docs/**)
Read(//absolute/plugin/path/resources/**)
Read(//absolute/plugin/path/skills/**)

在 Windows 上,写入绝对路径时可以使用前导 // 加小写驱动器字母(不带冒号),也可以使用本机路径:

  • Read(//c/Users/<you>/.claude/plugins/cache/egm/egm/<version>/agents/**)
  • Read(C:\Users\<you>\.claude\plugins\cache\egm\egm\<version>\agents\**)

该形式 //C:/Users/... 不匹配,读取仍会被拒绝。

通过市场安装的插件位于版本文件夹中:.../plugins/cache/<marketplace>/egm/<version>/。指定某个版本的规则在更新后将不再匹配。仅将版本段替换为 * 可在各版本间保持匹配,并且仍然只覆盖该插件的文件夹。例如,在 Windows 上:

Read(//c/Users/<you>/.claude/plugins/cache/egm/egm/*/agents/**)
Read(//c/Users/<you>/.claude/plugins/cache/egm/egm/*/docs/**)
Read(//c/Users/<you>/.claude/plugins/cache/egm/egm/*/resources/**)
Read(//c/Users/<you>/.claude/plugins/cache/egm/egm/*/skills/**)

请替换示例路径;不要复制猜测的缓存位置。这些读取规则也会在尽力而为的范围内涵盖对这些文件的 Grep 和 Glob 操作。使用 --add-dir 添加目录也会扩展编辑访问权限,因此它不是只读的替代方案。

Claude Code 警告:默认 agents/ 文件夹被忽略

在 Claude Code 中(/plugin > Errors),您可能会看到以下提示性警告:

Default agents/ folder is ignored because the manifest sets "agents"

EGM 使用显式适配器列表时,出现这条特定提示是预期行为。它并不意味着已注册的适配器加载失败;请单独排查其他错误。

EGM 维护两个代理目录:

  1. agents/:包含由 Antigravity 和其他平台加载的、与平台无关的规范评审者角色设定 Markdown 提示。
  2. .claude-plugin/agents/:包含 Claude Code 适配器。评审者适配器使用 omitClaudeMd: true 和 tools: [Read, Grep, Glob];合成器和引导编排器有各自的工具列表,如下所述。

由于 .claude-plugin/plugin.json 在 "agents" 中明确列出了适配器, Claude Code 会跳过根目录 agents/ 文件夹的自动加载。共享角色(persona)并未声明 Claude 的只读工具限制。如果自动加载它们,反而会丢失适配器特定的限制; 可用工具仍然受宿主权限约束。同时注册两份副本还会导致审查者名称重复。 请保留明确的适配器列表,而不是删除它来消除此提示。

审查者隔离

每次独立审查都应派生一个该插件已注册审查者类型的新原生 Agent, 例如 egm:egm-zoom-out。不要分叉对话,也不要恢复之前的审查者。 只提供任务、目标、角色/标准路径以及显式提供的 Goldfish 上下文; 不要复制父级的思考过程。

.claude-plugin/agents/ 中的 Claude 适配器声明了 tools: [Read, Grep, Glob]、 model: inherit 和 omitClaudeMd: true。每个适配器通过 ${CLAUDE_PLUGIN_ROOT} 从 agents/ 读取其规范角色。不要将 Claude 工具名称放入共享角色的 frontmatter: 其他宿主可以自行解释 tools。审查者无法编辑文件或运行 shell 命令,且未配置 持久化 memory。合成器适配器声明了 tools: [Agent, Read, Grep, Glob, Write], 因此它可以派生审查者并撰写报告,但不能运行 shell 命令或使用会话的 MCP 连接器。 插件子代理的 tools 字段无法将 Write 限制到特定路径,并且 Claude Code 会忽略插件子代理中的 hooks 和 permissionMode。因此, 适配器“仅写入所请求的报告或简报”的规则属于指令,而非宿主强制执行的限制。 写入操作仍然遵循会话的权限规则。当你派生 egm:egm-synthesizer 时, 要在其任务中指明你正在使用的工件目录。否则它永远看不到用户提示词中的任何一行, 并且会把文件夹放到工作目录之外,而该目录名只会出现在 agent 指令中。 它没有 shell,所以会按字面路径检查该目录,且不跟随符号链接。

引导编排器适配器仅允许 Agent、Bash、Read、Grep、 Glob、Write 和 Edit,用于本地发现和文档编写。它会将工作代理路由到 引导 SKILL.md,使它们返回 JSON subtree_index 而不是叙述性文本。 修复由父级负责。Bash 仍然受常规权限规则约束, 它不是文件系统或网络沙箱。 审查者无法打开 URL。不要在 GoldfishContext 中向 Claude 审查者传递 文档 URL:请将原始页面保存为工作区中的文件,然后传递该路径。

普通子代理会排除父级对话历史。omitClaudeMd 还额外 排除用户/项目/本地指令文件,但托管策略仍然适用。 这是上下文和工具隔离,而非文件系统隔离:审查者可以读取 可访问的文件。请显式传递任何所需的审查约束,并将无关的历史、 日志和记忆排除在审查任务之外。

对于本地测试,请使用 claude --plugin-dir <copy> 加载一个名称唯一的副本, 以避免与已安装的 egm 插件混淆。然后使用 claude plugin validate <copy>/.claude-plugin/plugin.json 验证它。

Claude Cowork

Claude Cowork 使用与 Claude Code 相同的 .claude-plugin 包。 从 claude.ai/plugins 或 Cowork 插件面板通过市场 google/elephant-goldfish-model 安装该插件。对于候选包,Customize > Plugins > Add plugin > Upload plugin 接受包含 Claude 清单、适配器和共享运行时文件的 ZIP。 安装它并选择 Try in chat。记录所产生的任务是在本地 还是云端运行;经过测试的桌面端使用的是云任务。 在实际的 Cowork 会话中验证资源解析和审查者工具。 仅安装本身并不能证明 Claude Code 的子代理设置或 ${CLAUDE_PLUGIN_ROOT} 替换在该平台上能够正常工作。 claude --plugin-dir 的本地测试仅在 Claude Code 中受支持。

参考资料:插件路径、 技能调用 和 子代理上下文与工具。

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