多宿主支持:Hermes Agent、OpenClaw 和 Delta¶
- 作者: Sriram (@Seburan)、Sriram Yatham (@yathamsriram243-blip)
- 状态: Stage 1 设计提案;原生契约和实际运行尚未验证
- 更新日期: 2026-10-30
- 参考: #116
1. 问题和目标¶
EGM 在多个宿主之间共享其技能、角色和文档标准。添加另一个宿主必须保留该共享文本,以及起草与 Goldfish 评审之间的全新上下文边界。
本提案定义了 Hermes Agent、OpenClaw 和 Delta 的需求,但并未为其中任何一个建立可运行的支持。
目标:
- 复用规范的
skills/、agents/和resources/内容。 - 为每个具体宿主版本选择有文档记录的安装格式。
- 验证原生委派不会继承父对话上下文。
- 通过宿主控制强制评审者只读访问。
- 在声明支持之前,要求提供安装和工作流证据。
非目标:
- 复制技能文本,或添加运行时翻译服务。
- 添加聊天桥接、注册中心或设备同步。
- 在 Stage 1 中发布推测性的 manifest(清单)或未经测试的安装命令。
- 仅凭离线元数据测试就声称支持。
2. Heilmeier 评估¶
| 问题 | 评估 |
|---|---|
| 我们试图做什么? | 在保留共享提示词和独立评审的前提下,在另外三个宿主上运行 EGM。 |
| 目前是如何实现的? | 宿主指南 记录了现有集成。这三个集成在本提案下没有任何经过验证的原生运行。 |
| 有什么新变化? | 尽可能复用兼容包。仅在某个固定版本的宿主有要求时,添加一个薄宿主适配器。 |
| 谁从中受益? | 目标宿主用户和维护者,否则他们需要维护各自的提示词副本。 |
| 风险是什么? | 不支持的发现路径、继承的项目上下文、可写的评审者,以及过早的支持声明。 |
| 成本是什么? | 贡献者的时间和用于实际探测的模型消耗。运行时和 token 成本尚未测量。 |
| 需要多长时间? | 每个宿主在其契约验证后独立推进。不承诺任何交付日期。 |
| 验收标准是什么? | Stage 1 定义验收门槛。Stage 2 为每个宿主提供 schema、安装、隔离、权限和工作流证据。 |
3. 宿主契约与开放问题¶
以下内容属于研究输入,而非经过测试的 EGM 集成。在将某个输入转化为实现契约之前,请记录宿主版本及配套的文档或源码修订版本。
| 宿主 | 已记录的输入 | 仍需验证的契约 |
|---|---|---|
| Hermes Agent | 当前的委派文档公开了 delegate_task(goal, context)。子任务拥有全新对话,但会继承工具访问权限,并可能收到工作区项目上下文。 |
包发现、实际安装的版本、角色加载、项目上下文抑制,以及强制只读权限。不要假定存在 hermes.spawn 或每次调用的 Claude 风格工具过滤器。 |
| OpenClaw | 这份 manifest 文档 区分了原生 openclaw.plugin.json 插件与兼容包。 |
先探测现有的 EGM 包。否则,记录原生 schema 和包根目录。针对固定版本验证 openclaw plugins install、已加载的插件身份,以及确切的 sessions_spawn schema。仅重命名 JSON 文件并不能证明兼容性。 |
| Delta | #116 将 Delta 列为目标。 | 确认产品、上游仓库、版本、安装格式和委派 API。本提案未指定 delta.spawn、隔离标志、manifest 路径或最低版本。 |
在相应的源码和原生安装探测确定之前,不会选择任何宿主特定的 manifest 路径或最低引擎版本。命名角色发现和嵌套委派也尚未验证。
4. 架构与评审边界¶
现有的根 plugin.json 仍是规范的元数据来源。在能够保留所有运行时资源的前提下,使用现有的兼容包。如果需要适配器,请将宿主特定字段保留在该适配器中。从规范 manifest 中复制共享元数据,并对该宿主 schema 所支持的字段测试完全一致。
每个评审者都会收到其角色、目标文档和所需资源。不要转发父对话。同时检查提交的子提示词和宿主注入的上下文。仅有全新对话并不能证明项目指令或记忆已被排除。
评审者必须无法修改文件或执行能够变更的工具。应使用宿主强制权限,而非提示词指令作为证明。Claude 的 Read、Grep 和 Glob 只是一个宿主特定的例子。其他宿主必须将同样的“禁止变更”要求映射到自身已验证的控制方式。不要假定存在这些字面工具名或通用的 tools 参数。
如果某个宿主无法满足隔离或权限要求,则其 Goldfish 评审集成仍不受支持。应停止评审,而不是在父上下文中或以更宽泛的权限运行它。
5. 备选方案¶
| 选项 | 决策 |
|---|---|
| 现有兼容包 | 当原生安装探测证明其发现机制和资源访问时优先选择。避免重复的元数据。 |
| 薄原生适配器 | 仅在已验证的宿主契约要求时使用。保持提示词内容的规范性。 |
| 推测性的逐宿主 manifest | 拒绝。有效的 JSON 或 YAML 以及元数据一致性并不能证明宿主接受。 |
| 运行时翻译器或复制的技能分支 | 排除,因为它们会增加维护成本和提示词漂移。 |
6. 交付计划¶
Stage 1:设计¶
本 PR 仅包含此提案及其设计索引条目。 它不修改任何运行时清单、安装指南、支持记录或测试。 维护者的设计批准并不证明原生宿主支持。 保持 #116 打开,以继续进行实现和证据收集。
阶段 2:实现并验证一个宿主¶
在实现之前,先获得 AGENTS.md 所要求的 contribution-track 审批。在该设计合并后提交后续 PR。
- 确定宿主产品、确切版本、上游来源和 schema。
- 在添加适配器之前,先探测现有 EGM 包。
- 实现所需的最小适配器和原生委派映射。
- 为实际 schema、元数据和资源路径契约添加离线检查。
- 运行原生安装、隔离、权限和工作流探测。
- 用证据和明确限制更新 harness 指南 和 测试记录。仅将经过测试的宿主提升为受支持状态。
不要发布猜测的安装命令,也不要在缺少所需证据时将宿主标记为受支持。未经核实的结果必须保持明确标注。
7. 验证与验收¶
第 1 阶段运行 pytest tests/unit 和 git diff --check。
链接测试检查相对目标是否存在,以及同文档锚点是否位于隐藏目录和其他排除路径之外。它不验证跨文档片段、外部 URL 或原生插件发现。
第 2 阶段必须对 JSON 清单保持严格的 JSON 解析。仅对需要 YAML 的格式使用 YAML 解析。测试每个选定的 schema,而不是将元数据匹配视为 schema 验证。
为每个宿主附上以下证据:
- 确切的宿主版本和来源、EGM 提交、操作系统和模型配置。
- 干净的安装命令和输出,显示加载了哪个 EGM 包。
- 对技能、角色和文档标准的发现与成功读取。
- 原生子级提示和追踪,显示父对话和不相关的项目上下文均被排除。使用仅包含父级上下文的 canary 探测。
- 有效的子级权限,以及显示修改尝试被阻止的负向探测。仅要求只读行为的提示词并不足够。
- 端到端的
/egm-brainstorm、/egm-draft和/egm-review输出。从追踪中验证审阅者完成情况、必需读取内容和阶段顺序。 - 限制、失败和实测用量。发布前对凭证进行脱敏。
离线检查不能替代原生探测。 如果某个必需的探测失败,请将支持状态保留为“未验证”,并记录失败。
8. 回归与回滚¶
将证据固定到经过测试的发布版本和 EGM 提交。后续宿主版本不会自动继承已验证的结果。如果发现、隔离或权限出现回归,请记录受影响的版本,撤回其支持声明,并修复或回退该宿主的适配器。保留其他可用的集成和共享提示词文本。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 el/elephant-goldfish-model