使用 Rube MCP 自动化 Metaphor 任务awesome-codex-skills 中的 metaphor-automation Skill 实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本文围绕 awesome-codex-skills 仓库中 composio-skills/metaphor-automation/SKILL.md 所定义的metaphor-automationSkill完整讲解如何通过 Rube MCPComposio为 Codex 接入 Metaphor 工具包、按先发现工具、再校验连接、最后执行的三步模式完成自动化操作并给出可复制的命令骨架与常见陷阱规避方案。读完本文你将掌握在 Codex CLI/API 场景下通过 MCP 方式自动化 Metaphor 任务的完整实操路径包括工具发现、连接管理、批量执行与分页处理。Skill 是什么frontmatter 定义了触发与依赖在 awesome-codex-skills 仓库中每个 Skill 都以独立目录承载一个SKILL.md文件。metaphor-automation的 SKILL.md 顶部 frontmatter 是其元数据核心--- name: metaphor-automation description: Automate Metaphor tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这里包含了三个关键信息nameSkill 的唯一标识即metaphor-automationdescription决定 Codex 何时触发该 Skill。根据仓库 README.md 中 What Are Codex Skills? 一节说明Codex 会依据description元数据判断是否触发匹配的 Skill并仅在触发后才加载正文以保持上下文精简。这里的描述明确点名了 Metaphor tasks 与 Always search tools first始终先搜索工具两条核心约束requires.mcp声明该 Skill 运行时依赖名为rube的 MCP 服务器这提示使用者在安装 Skill 前需先配置好对应的 MCP 端点。换言之这是一个以 Rube MCP 为执行通道、以 Metaphor 工具包为目标的自动化 SkillSkill 本身只提供行为指引真正的动作能力来自 MCP 暴露的工具。前置条件三步确认环境就绪在运行任何工作流之前SKILL.md 要求确认三项前置条件Rube MCP 已连接环境中存在RUBE_SEARCH_TOOLS工具说明 MCP 服务器通信正常Metaphor 连接处于激活状态通过RUBE_MANAGE_CONNECTIONS使用metaphor工具包建立连接且状态为ACTIVE先调用RUBE_SEARCH_TOOLS任何执行前都必须先获取当前工具 schema避免使用过时的工具 slug 或参数。这三条前置条件的顺序本身就是一个良好的防御习惯先确认通道MCP 可达、再确认授权连接 ACTIVE、最后确认契约最新 schema缺一不可。设置步骤接入 Rube MCP 并激活 Metaphor 连接添加 Rube MCP 端点根据文档接入方式极其轻量——在客户端配置中将https://rube.app/mcp添加为 MCP 服务器即可无需任何 API KeyMCP 服务器地址https://rube.app/mcp添加完成后按以下顺序完成连接建立通过确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS工具包参数指定为metaphor若连接状态不是ACTIVE按返回的认证链接完成授权流程在运行任何工作流前再次确认连接状态为ACTIVE。这里的无 API Key特性值得注意Rube MCP 作为聚合入口承载了认证与凭据管理Agent 侧只需要维护 MCP 连接本身这与仓库 connect/SKILL.md 中通过 Composio CLI 连接 1000 应用的思路一脉相承只是接入方式从 CLI 换成了 MCP 端点。首次工具发现推荐在设置完成后执行文档建议设置完成后先做一次全量工具发现为后续工作流建立 schema 基线RUBE_SEARCH_TOOLS queries: [{use_case: Metaphor operations, known_fields: }] session: {generate_id: true}generate_id: true表示本次会话为新建会话由服务端生成会话 ID。该调用的返回内容包含四类关键信息可用工具的 slug、输入 schema、推荐执行计划以及已知陷阱pitfalls后两者是 Rube MCP 区别于普通工具列表的重要能力——它不只是暴露工具还会给出怎么用的指导。核心工作流模式发现 → 校验 → 执行SKILL.md 将整个自动化流程收敛为三步每一步对应一个 Rube MCP 工具形成了清晰的责任划分。Step 1发现可用工具针对当前具体任务重新搜索复用已有会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Metaphor task}] session: {id: existing_session_id}这里与设置阶段的区别在于use_case从宽泛的Metaphor operations收窄为具体任务描述例如搜索网页并提取内容摘要且session从generate_id: true变为复用{id: existing_session_id}。返回结果中的工具 slug 将作为 Step 3 的执行依据。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [metaphor] session_id: your_session_id执行前最后一次确认授权状态。注意此处toolkits是数组形式session_id与 Step 1 的会话保持一致。若返回ACTIVE以外的状态应回到设置步骤重新走认证流程。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id执行阶段的几个要点tool_slug必须来自 Step 1 的搜索结果绝不能凭记忆硬编码arguments必须严格遵循搜索返回的 schema字段名与类型逐一对齐memory参数必须始终携带即使没有需要传递的上下文也要传空对象{}这是文档明确强调的约束tools是数组结构意味着一次调用可以批量执行多个工具适合需要多步串联的场景。批量执行与完整 schema快速参考的补充工具除上述三步外文档的快速参考表还补充了两个进阶工具RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数进行批量操作适合在远端执行环境中编排多步骤任务RUBE_GET_TOOL_SCHEMAS当搜索结果中的工具带有schemaRef引用时用该工具拉取完整 schema 定义适用于需要对参数做精细校验的场景。已知陷阱六个必须遵守的约束SKILL.md 专门列出了一节 Known Pitfalls这些约束直接来源于 Rube MCP 的使用特性逐条展开如下陷阱约束说明原因与建议Always search first严禁不经过RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数工具 schema 会随版本变化搜索是获取当前契约的唯一可靠途径Check connection执行工具前必须确认RUBE_MANAGE_CONNECTIONS返回ACTIVE授权可能过期或被吊销直接执行会得到授权错误Schema compliance参数必须使用搜索结果中的精确字段名与类型schema 不匹配会被拒绝错误信息往往不直观Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须携带memory可为{}该参数是调用契约的固定组成部分缺失会导致调用失败Session reuse同一工作流内复用会话 ID新工作流再生成新 ID会话承载上下文与执行轨迹跨工作流混用会造成状态污染Pagination检查响应中的分页 token持续拉取直到数据完整结果集可能被分页截断忽略分页会得到不完整数据这六条约束实际上勾勒出了 MCP 工具调用的通用最佳实践契约先于执行、授权先于调用、参数严格合规、会话生命周期清晰、分页兜底完整。它同样适用于仓库中其他基于 Rube MCP 的同类 Skill例如 composio-automation 与 composio-search-automation后两者的文档与本文档共享完全相同的六条陷阱清单——从源码结构看这三份文档遵循同一套模板规范区别仅在于use_case、toolkits名称与目标工具包分别为metaphor、composio、composio_search。操作速查表下表浓缩了本 Skill 的五类核心操作及其对应工具可作为日常使用的速查索引OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Metaphor-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitmetaphorExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef在 Codex 中安装与触发本 Skillmetaphor-automation位于仓库的 composio-skills/metaphor-automation/ 目录安装方式遵循仓库通用流程详见 README.md 的 Quickstart 章节复制 Skill 目录将composio-skills/metaphor-automation/整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex使其重新加载 Skill 元数据自然触发在会话中用自然语言描述 Metaphor 相关任务Codex 会根据 frontmatter 中的description自动匹配并加载本 Skill。需要再次强调的是由于本 Skill 在requires中声明了mcp: [rube]使用前必须先在客户端完成 Rube MCP 端点配置仅安装 Skill 而不配置 MCPSkill 中的RUBE_*工具将不可用。结语metaphor-automation展示了一条极具代表性的 Agent 自动化范式Skill 负责何时做、怎么做的决策MCP 负责能做什么、授权在哪的执行能力两者通过先搜索 schema、再校验连接、最后执行的三步协议解耦。对于开发者而言这套模式的价值在于三点其一无需在 Agent 代码中维护脆弱的工具契约——每次执行前动态拉取最新 schema其二授权管理被收敛到 MCP 连接层Agent 无需接触原始凭据其三会话 ID 与 memory 参数提供了多步编排的状态载体使批量、串联的复杂工作流成为可能。当你在 Codex 中需要自动化 Metaphor 或其他由 Composio 托管的工具时完全可以参照本文档的结构原文档复刻这一套发现—校验—执行的稳健流程。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
使用 Rube MCP 自动化 Metaphor 任务：awesome-codex-skills 中的 metaphor-automation Skill 实战指南
使用 Rube MCP 自动化 Metaphor 任务awesome-codex-skills 中的 metaphor-automation Skill 实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills本文围绕 awesome-codex-skills 仓库中 composio-skills/metaphor-automation/SKILL.md 所定义的metaphor-automationSkill完整讲解如何通过 Rube MCPComposio为 Codex 接入 Metaphor 工具包、按先发现工具、再校验连接、最后执行的三步模式完成自动化操作并给出可复制的命令骨架与常见陷阱规避方案。读完本文你将掌握在 Codex CLI/API 场景下通过 MCP 方式自动化 Metaphor 任务的完整实操路径包括工具发现、连接管理、批量执行与分页处理。Skill 是什么frontmatter 定义了触发与依赖在 awesome-codex-skills 仓库中每个 Skill 都以独立目录承载一个SKILL.md文件。metaphor-automation的 SKILL.md 顶部 frontmatter 是其元数据核心--- name: metaphor-automation description: Automate Metaphor tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这里包含了三个关键信息nameSkill 的唯一标识即metaphor-automationdescription决定 Codex 何时触发该 Skill。根据仓库 README.md 中 What Are Codex Skills? 一节说明Codex 会依据description元数据判断是否触发匹配的 Skill并仅在触发后才加载正文以保持上下文精简。这里的描述明确点名了 Metaphor tasks 与 Always search tools first始终先搜索工具两条核心约束requires.mcp声明该 Skill 运行时依赖名为rube的 MCP 服务器这提示使用者在安装 Skill 前需先配置好对应的 MCP 端点。换言之这是一个以 Rube MCP 为执行通道、以 Metaphor 工具包为目标的自动化 SkillSkill 本身只提供行为指引真正的动作能力来自 MCP 暴露的工具。前置条件三步确认环境就绪在运行任何工作流之前SKILL.md 要求确认三项前置条件Rube MCP 已连接环境中存在RUBE_SEARCH_TOOLS工具说明 MCP 服务器通信正常Metaphor 连接处于激活状态通过RUBE_MANAGE_CONNECTIONS使用metaphor工具包建立连接且状态为ACTIVE先调用RUBE_SEARCH_TOOLS任何执行前都必须先获取当前工具 schema避免使用过时的工具 slug 或参数。这三条前置条件的顺序本身就是一个良好的防御习惯先确认通道MCP 可达、再确认授权连接 ACTIVE、最后确认契约最新 schema缺一不可。设置步骤接入 Rube MCP 并激活 Metaphor 连接添加 Rube MCP 端点根据文档接入方式极其轻量——在客户端配置中将https://rube.app/mcp添加为 MCP 服务器即可无需任何 API KeyMCP 服务器地址https://rube.app/mcp添加完成后按以下顺序完成连接建立通过确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS工具包参数指定为metaphor若连接状态不是ACTIVE按返回的认证链接完成授权流程在运行任何工作流前再次确认连接状态为ACTIVE。这里的无 API Key特性值得注意Rube MCP 作为聚合入口承载了认证与凭据管理Agent 侧只需要维护 MCP 连接本身这与仓库 connect/SKILL.md 中通过 Composio CLI 连接 1000 应用的思路一脉相承只是接入方式从 CLI 换成了 MCP 端点。首次工具发现推荐在设置完成后执行文档建议设置完成后先做一次全量工具发现为后续工作流建立 schema 基线RUBE_SEARCH_TOOLS queries: [{use_case: Metaphor operations, known_fields: }] session: {generate_id: true}generate_id: true表示本次会话为新建会话由服务端生成会话 ID。该调用的返回内容包含四类关键信息可用工具的 slug、输入 schema、推荐执行计划以及已知陷阱pitfalls后两者是 Rube MCP 区别于普通工具列表的重要能力——它不只是暴露工具还会给出怎么用的指导。核心工作流模式发现 → 校验 → 执行SKILL.md 将整个自动化流程收敛为三步每一步对应一个 Rube MCP 工具形成了清晰的责任划分。Step 1发现可用工具针对当前具体任务重新搜索复用已有会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Metaphor task}] session: {id: existing_session_id}这里与设置阶段的区别在于use_case从宽泛的Metaphor operations收窄为具体任务描述例如搜索网页并提取内容摘要且session从generate_id: true变为复用{id: existing_session_id}。返回结果中的工具 slug 将作为 Step 3 的执行依据。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [metaphor] session_id: your_session_id执行前最后一次确认授权状态。注意此处toolkits是数组形式session_id与 Step 1 的会话保持一致。若返回ACTIVE以外的状态应回到设置步骤重新走认证流程。Step 3执行工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id执行阶段的几个要点tool_slug必须来自 Step 1 的搜索结果绝不能凭记忆硬编码arguments必须严格遵循搜索返回的 schema字段名与类型逐一对齐memory参数必须始终携带即使没有需要传递的上下文也要传空对象{}这是文档明确强调的约束tools是数组结构意味着一次调用可以批量执行多个工具适合需要多步串联的场景。批量执行与完整 schema快速参考的补充工具除上述三步外文档的快速参考表还补充了两个进阶工具RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数进行批量操作适合在远端执行环境中编排多步骤任务RUBE_GET_TOOL_SCHEMAS当搜索结果中的工具带有schemaRef引用时用该工具拉取完整 schema 定义适用于需要对参数做精细校验的场景。已知陷阱六个必须遵守的约束SKILL.md 专门列出了一节 Known Pitfalls这些约束直接来源于 Rube MCP 的使用特性逐条展开如下陷阱约束说明原因与建议Always search first严禁不经过RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数工具 schema 会随版本变化搜索是获取当前契约的唯一可靠途径Check connection执行工具前必须确认RUBE_MANAGE_CONNECTIONS返回ACTIVE授权可能过期或被吊销直接执行会得到授权错误Schema compliance参数必须使用搜索结果中的精确字段名与类型schema 不匹配会被拒绝错误信息往往不直观Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须携带memory可为{}该参数是调用契约的固定组成部分缺失会导致调用失败Session reuse同一工作流内复用会话 ID新工作流再生成新 ID会话承载上下文与执行轨迹跨工作流混用会造成状态污染Pagination检查响应中的分页 token持续拉取直到数据完整结果集可能被分页截断忽略分页会得到不完整数据这六条约束实际上勾勒出了 MCP 工具调用的通用最佳实践契约先于执行、授权先于调用、参数严格合规、会话生命周期清晰、分页兜底完整。它同样适用于仓库中其他基于 Rube MCP 的同类 Skill例如 composio-automation 与 composio-search-automation后两者的文档与本文档共享完全相同的六条陷阱清单——从源码结构看这三份文档遵循同一套模板规范区别仅在于use_case、toolkits名称与目标工具包分别为metaphor、composio、composio_search。操作速查表下表浓缩了本 Skill 的五类核心操作及其对应工具可作为日常使用的速查索引OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Metaphor-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitmetaphorExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef在 Codex 中安装与触发本 Skillmetaphor-automation位于仓库的 composio-skills/metaphor-automation/ 目录安装方式遵循仓库通用流程详见 README.md 的 Quickstart 章节复制 Skill 目录将composio-skills/metaphor-automation/整个目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex使其重新加载 Skill 元数据自然触发在会话中用自然语言描述 Metaphor 相关任务Codex 会根据 frontmatter 中的description自动匹配并加载本 Skill。需要再次强调的是由于本 Skill 在requires中声明了mcp: [rube]使用前必须先在客户端完成 Rube MCP 端点配置仅安装 Skill 而不配置 MCPSkill 中的RUBE_*工具将不可用。结语metaphor-automation展示了一条极具代表性的 Agent 自动化范式Skill 负责何时做、怎么做的决策MCP 负责能做什么、授权在哪的执行能力两者通过先搜索 schema、再校验连接、最后执行的三步协议解耦。对于开发者而言这套模式的价值在于三点其一无需在 Agent 代码中维护脆弱的工具契约——每次执行前动态拉取最新 schema其二授权管理被收敛到 MCP 连接层Agent 无需接触原始凭据其三会话 ID 与 memory 参数提供了多步编排的状态载体使批量、串联的复杂工作流成为可能。当你在 Codex 中需要自动化 Metaphor 或其他由 Composio 托管的工具时完全可以参照本文档的结构原文档复刻这一套发现—校验—执行的稳健流程。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
