跳转至

Codex 集成

安装并定位插件

对于桌面应用,请安装已发布的 EGM 插件。该列表仅适用于桌面端。

对于 Codex CLI,请安装整个插件,包括其角色和标准:

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

安装后请启动一个新会话。从可用技能中选择已安装的 egm 技能。使用其发现的绝对 SKILL.md 路径;不要假设特定的缓存目录、版本或检出位置。

从 <plugin>/skills/<skill>/SKILL.md 中,插件根目录位于该文件向上三级的父目录。相对于该根目录解析捆绑的 agents/、resources/ 和 docs/ 路径。相对于当前活动技能的目录解析 references/。相对于用户的工作目录解析用户文档和生成的产物。切勿用用户项目中名称相似的文件替代捆绑的角色或标准。

如果用户的提示词或代理指令文件(AGENTS.md)中包含一行 EGM artifact directory: <path>,请将简报、草稿和报告写入该文件夹。相对于工作目录解析相对路径。如果来自 AGENTS.md 的路径在遵循符号链接后解析到工作目录之外,请先请求用户确认再创建该文件夹或写入内容。如果他们拒绝或无人可以确认,则使用工作目录并说明原因。如果文件夹不存在,请创建它。

在 ChatGPT Work 中,技能可能通过云资源标识符暴露,而支持文件位于已安装的本地捆绑包中。对于这些文件,请使用技能清单或安装元数据提供的已安装路径;不要为任意支持路径构造云资源标识符。如果没有可用的已安装路径,请报告缺失的功能,而不是猜测缓存位置。从捆绑包中读取评审器文件名和 frontmatter:诸如 egm-design 之类的角色映射到 agents/design_critic.md,而不是 agents/design.md。派遣前确认每个已解析的路径。

全新上下文评审器

检查可用的原生子代理工具模式。工具名称可能带有命名空间,并因 Codex 版本而异。当 spawn_agent 暴露 fork_context 时,请为每个 Goldfish 显式设置 fork_context: false。当模式改为暴露 fork_turns 时,请使用 fork_turns: "none"。这也适用于由合成器启动的评审器。使用通用代理,并传递角色、标准、目标文档及明确选择的阅读列表的绝对路径。不要传递父级对话记录、私有推理或文档本应解释的答案。

要求评审器在返回发现之前阅读其角色、目标和提供的每一项标准。未完成阅读或文件不可访问属于不完整的评审,而非干净的结果。当宿主暴露原生工具结果时,请验证这些结果;由父级编写的完成摘要并非等效证据。

在实际评审器完成后再综合发现。传播失败和超时;已启动的评审器不等于已完成的评审。如果嵌套不可用,则直接从父级派遣评审器,同时保持相同的隔离性。如果可用工具无法建立全新上下文,请停止 Goldfish 评审并报告该限制。

全新的对话上下文并不能隔离文件系统、已配置的记忆服务或项目指令。不要检索对话历史或记忆来补充缺失的设计上下文。隔离测试应使用仅父级持有的唯一标记,并检查实际的子级结果,而非父级的声明。

fork_context: false 和 fork_turns: "none" 这两个选项所涉及的是父级对话轮次。它们并不能证明 Codex 排除了宿主指令文件。Issue #237 报告称,尽管设置了 fork_turns: "none",Codex CLI 0.166.0 仍注入了项目和用户的 AGENTS.md 文件。除非单独的子上下文探针针对所测试的宿主版本确认了指令文件排除行为,否则应将其视为未经验证。

问题与产物

共享技能的问题负载描述的是预期交互,而非字面上的 Codex API。仅当结构化问题工具在当前模式下可用且被允许时,才使用它,并映射到其实际模式。否则,请提出一个纯文本问题并等待回答。保留技能的就绪检查和章节批准门控;工具不可用不等于批准。

使用绝对路径的 Markdown 链接指向生成的产物,例如 design draft。对于包含空格的路径,请使用 [design draft](</absolute/my project/design_draft.md>)。不要在 Codex 聊天中使用 file:// 链接。

验证

使用 pytest tests/unit 运行离线打包检查。有关可选的(opt-in)原生工作流测试,请参阅 TESTING.md。这些测试需要经过身份验证的 Codex CLI,并会消耗模型用量。仅安装或发现插件并不能确立端到端的工作流支持。

ChatGPT

在 ChatGPT 桌面应用中安装已发布的 EGM 插件。该列表仅适用于桌面端;它并不确立对云端 Work 会话的支持。

测试本地包

如需个人测试,请在 ChatGPT 中打开 Plugins > Add > Upload plugin archive。从仓库根目录打包运行时文件:

python3 scripts/pack_plugin.py --target openai --output /tmp/egm-chatgpt

使用全新的输出目录。上传 /tmp/egm-chatgpt/egm-openai.zip 并在 ChatGPT 桌面应用中安装该插件。在本地运行的新线程中使用 Try in chat。TESTING.md 中早期的云端 Work 测试早于本包的桌面端专属声明。将仓库市场目录和开发文件保留在该压缩包之外。OpenAI 目录包声明本地执行,因为引导(bootstrap)使用 shell 命令。其列表使用可移植清单中的 OpenAI 扩展;Codex 兼容性清单保留了匹配的元数据,以用于原生安装。将 .claude-plugin/ 保留在 OpenAI 压缩包之外:其代理适配器属于 Claude Code 集成。公共目录插件不能包含钩子。

Enterprise、Business 和 Edu 工作区可通过 Admin > Plugins > Add > Import marketplace 导入该插件。将仓库 URL 设置为 https://github.com/google/elephant-goldfish-model,插件市场路径设置为 .agents/plugins。技能可通过 @egm 访问,用于直接交互。在开始 Goldfish 审查之前,请检查当前对话中的原生工具。某些 ChatGPT Work 会话会暴露带有 fork_turns: "none" 的原生 spawn_agent。当这些工具可用时,请使用上文中的全新上下文说明。如果这些工具不可用,请停止操作并报告隔离功能不可用;切勿在父上下文中模拟审查者。某个 Work 会话中的可用性并不代表所有 ChatGPT 模式或账户都支持该功能。

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