跳转至

Muse 集成

Muse 通过其 Claude 兼容插件路径加载 EGM:无需 Muse 原生清单。该插件验证支持全部七个技能和全部十个代理适配器:八个评审者、综合器和引导编排器。

这些技能将 Codex 和 Claude 会话路由到其指南,但不路由 Muse 会话。除非你在此处指明,Muse 会话不会读取此文件。

安装并定位插件

从本地路径安装整个插件,包括其 personas 和 standards:

git clone https://github.com/google/elephant-goldfish-model.git
muse plugins install ./elephant-goldfish-model --scope user
muse plugins approve egm

在此仓库上执行 marketplace add 会发现零个插件:Muse 首先读取 Codex 目录(.agents/plugins/marketplace.json)并跳过其条目,因此永远不会回退到 Claude 目录。请改为从本地路径安装,并保持源码中无符号链接(先移除类似 .venv/ 的临时目录;安装程序会拒绝符号链接条目)。需要一次性批准:插件启用期间,技能无需审查即可保持激活,但十个代理定义需要先执行 approve 才能激活。

安装后启动一个新会话。这些技能以 plugin:egm:egm-* 形式呈现,且仅可由用户调用;使用 muse skills list --source plugin 确认。该命令输出 plugin:// URI,而非文件系统路径;从 muse plugins inspect egm 的 cache= 字段获取已安装路径。不要假设特定的缓存目录、版本或检出位置。

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

无需安装即可进行离线预检查:muse plugins validate <path> 会报告插件有效,支持 7 个技能和 10 个代理。警告是预期的(multiple-manifests 选择 Claude 清单而非 Codex 清单;Claude 专属字段,如呈现元数据、color 和未知的代理 frontmatter 键会被忽略)。单独安装或发现插件并不等同于端到端工作流支持。

新上下文评审者

Muse 将十个 Claude 适配器导入为受支持的代理定义(egm/egm-design、egm/egm-comprehension 等),但所有代理工具投影均不受支持:Claude 工具允许列表并不限制 Muse 评审者,因此不要假定评审者只读。在调度之前检查可用的原生子代理工具 schema;工具名称可能带有命名空间,并随 Muse 版本而变化。

当会话暴露具名评审者代理时,使用它,并传入 persona、standards、目标文档以及明确选定的阅读列表的绝对路径。不要传入父级对话记录、私人推理或该文档应当解释的答案。当具名代理不可用时,回退到先读取 persona 文件的通用子代理。通过 name frontmatter(而非文件名)进行匹配:egm-design 对应 agents/design_critic.md。在 Muse 1.4.14 上,具名 egm/egm-* 定义在插件清单中报告 trusted_enabled,但生成一个会被拒绝(agent_definition_unavailable),因此实际上通用回退是可用的路径。

要求评审者在返回发现之前阅读其 persona、目标和所有提供的 standards。缺失读取或文件不可访问属于不完整评审,而非无问题结果。当宿主暴露原生工具结果时,验证这些结果;由父级编写的完成摘要不是等效证据。

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

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

问题与产物

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

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

验证

使用 pytest tests/unit 运行离线打包检查。端到端工作流 fixture(头脑风暴、草稿,以及通过已安装插件进行的不间断评审)已于 2026-10-30 在 Muse 1.4.14 上通过,使用了上述通用评审者回退。该提示指定了本指南,并以无头模式运行、预先模拟审批,因此技能路由、交互式审批门和聊天链接渲染尚未测试;请参阅 harness 测试记录。单独安装或发现插件并不等同于端到端工作流支持。

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