使用 Rube MCP 在 Codex 中自动化 Hyperise 操作hyperise-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-skillsHyperise 营销自动化是许多运营团队的高频场景而 awesome-codex-skills 仓库提供的hyperise-automationSkill通过 Rube MCPComposio 的统一 MCP 网关让 Codex Agent 能够直接发现、连接并调用 Composio 的 Hyperise 工具集。读完本文你将掌握从 Rube MCP 接入、连接授权、工具发现到批量执行的完整自动化链路并了解 schema 漂移、连接状态校验、会话复用等关键避坑经验。一、Skill 定位它在整个仓库中扮演什么角色本 Skill 位于仓库的 composio-skills/hyperise-automation/SKILL.md隶属于composio-skills目录下数百个通过 Rube MCP 自动化某第三方服务的同类 Skill 家族。其元数据声明如下--- name: hyperise-automation description: Automate Hyperise tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---name是 Codex 识别 Skill 的唯一标识description决定了 Codex 何时触发该 Skill——它明确要求Always search tools first先搜索工具再执行这是整个文档一以贯之的核心原则requires.mcp声明该 Skill 强依赖名为rube的 MCP 服务器意味着使用前必须完成 Rube MCP 的接入。对比仓库内其他成员如 composio-skills/composio-automation/SKILL.md、composio-skills/exa-automation/SKILL.md可以看到它们共用同一套搜索工具 → 校验连接 → 执行工具的骨架唯一的差异是把 toolkit 名替换为各自的服务hyperise/composio/exa。也就是说你掌握本文的流程后即可无障碍迁移到仓库中任意其他*-automationSkill。二、工作原理Rube MCP 与四个核心方法Rube MCP 是 Composio 提供的统一 MCP 端点它把 1000 第三方集成的工具以标准 MCP 协议暴露给 Codex 等 Agent。本 Skill 围绕以下五个方法组织全部工作流方法作用RUBE_SEARCH_TOOLS按 use_case 检索可用工具返回工具 slug、输入 schema、推荐执行计划与已知坑点RUBE_MANAGE_CONNECTIONS管理创建/检查与 Hyperise 的连接返回授权链接与连接状态RUBE_MULTI_EXECUTE_TOOL批量执行一个或多个已发现的工具RUBE_REMOTE_WORKBENCH在远端沙箱中运行批量/复杂操作如run_composio_tool()RUBE_GET_TOOL_SCHEMAS获取带schemaRef工具的完整 JSON Schema这一设计的本质是把工具能力发现与工具执行解耦Agent 永远先询问 Rube 当前 Hyperise 工具集长什么样再按返回的 schema 精确传参从而避免因服务端更新导致硬编码失效。三、前置条件与 Setup三步完成接入在运行任何工作流之前必须满足以下前置条件直接取自原文档Rube MCP 必须已连接RUBE_SEARCH_TOOLS可用已通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为hyperise的 ACTIVE 连接始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema。接入 Rube MCP 本身非常简单在你的 MCP 客户端配置中添加https://rube.app/mcp作为 MCP 服务器端点即可无需任何 API Key——添加端点即生效。随后按以下 4 步完成连接初始化通过确认RUBE_SEARCH_TOOLS有响应来验证 Rube MCP 可用以 toolkithyperise调用RUBE_MANAGE_CONNECTIONS若连接状态不是 ACTIVE则按照返回的认证链接完成授权设置在运行任何工作流之前确认连接状态已变为 ACTIVE。第 4 步是强约束而非建议连接未 ACTIVE 时执行工具必然失败提前校验可以省去大量无谓的调试时间。四、工具发现先搜索再执行Skill 强调Always discover available tools before executing workflows执行工作流前始终先发现可用工具。首次接入时推荐使用如下调用RUBE_SEARCH_TOOLS queries: [{use_case: Hyperise operations, known_fields: }] session: {generate_id: true}参数解读queries.use_case描述你要完成的业务场景此处为 Hyperise operationsRube 会据此匹配相关工具queries.known_fields若你已知某些字段可预填否则留空字符串交给 Rube 智能推断session.generate_id: true让 Rube 为本次对话生成新的会话 ID适合新建工作流时使用。该调用的返回值包含四类关键信息可用工具 slug 列表、每个工具的输入 schema、推荐的执行计划recommended execution plans、已知坑点known pitfalls。这四者正是后续RUBE_MULTI_EXECUTE_TOOL传参的依据。五、核心工作流模式标准三步曲针对 Hyperise 的具体任务原文档给出了一套标准的三步工作流适用于仓库内所有 Rube 类 Skill。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Hyperise task}] session: {id: existing_session_id}注意与首次发现不同此处session使用id字段传入已存在的会话 ID实现同一工作流内的会话延续。将use_case替换为你具体的 Hyperise 任务描述如创建个性化图片、管理动态内容等以 Rube 返回的实际匹配为准即可获得与任务强相关的工具 slug 与参数 schema。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [hyperise] session_id: your_session_id传入 toolkits 数组与当前会话 ID确认 Hyperise 连接为 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执行阶段的关键要点tools是数组可一次提交多个工具调用实现发现一批、执行一批的批处理效果tool_slug必须来自 Step 1 的搜索结果禁止硬编码arguments必须严格符合搜索结果返回的字段名与类型schema-compliantmemory参数必须始终携带即使为空也要显式传入{}session_id复用当前会话 ID。六、已知坑点六条实战避坑清单原文档总结了六条高频踩坑点这里逐条展开说明其背后的原因Always search first始终先搜索工具 schema 会随服务端更新而变化不经RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是 Rube 类 Skill 最常见的失败根源Check connection检查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE否则请求会因未授权而被拒绝Schema complianceschema 合规严格使用搜索结果中的精确字段名与类型多一个字符、错一种类型都会导致调用失败Memory parametermemory 参数RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory字段即使内容为空也传{}——这是 Rube 执行引擎的硬性接口要求Session reuse会话复用同一工作流内复用会话 ID 以保持上下文连续只有开启全新工作流时才生成新 IDPagination分页处理检查响应中是否携带分页令牌pagination tokens如有则继续拉取直到数据取完避免遗漏大批量结果。七、快速参考一张表掌握全部操作操作方法查找工具RUBE_SEARCH_TOOLS传入 Hyperise 专属 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 传hyperise执行调用RUBE_MULTI_EXECUTE_TOOL使用发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具其中后两行是进阶能力RUBE_REMOTE_WORKBENCH适合在远端执行环境里跑复杂的批量逻辑通过run_composio_tool()编程式调用而当你发现某个工具的返回 schema 不完整、需要全量字段定义时用RUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具补充拉取完整定义。八、把 Skill 装进 Codex安装与触发本文所属的 Skill 与仓库内其他 Skill 一样遵循 Codex 的标准安装路径。根据仓库 README.md 的说明Skill 存放于$CODEX_HOME/skills默认~/.codex/skills每个子目录需包含带name与descriptionfrontmatter 的SKILL.md推荐使用仓库的 skill-installer 安装脚本自动拉取并放置到目标目录安装后重启 Codex 以加载新元数据使用方式上Codex 会根据用户请求与 Skill 的description自动匹配触发你也可以直接提及 Skill 名称hyperise-automation让它被纳入考虑验证安装是否成功ls ~/.codex/skills查看目录head ~/.codex/skills/hyperise-automation/SKILL.md检查元数据。由于该 Skill 声明了requires.mcp: [rube]安装后还需确保 Codex 的 MCP 配置中已注册https://rube.app/mcp端点二者齐备后即可在会话中直接描述 Hyperise 自动化任务。九、小结hyperise-automation是一份小而精的 Codex Skill它没有堆砌 Hyperise 业务细节而是把重心放在 Rube MCP 的工具发现、连接校验、schema 合规执行这一可复用的方法论上。这一点从它与仓库内 composio-skills/exa-automation/SKILL.md 等兄弟 Skill 的模板一致性可见一斑。对读者而言掌握本文的接入与三步工作流不仅能自动化 Hyperise 操作更获得了一套可在任意 Composio 集成上复用的 Agent 自动化范式。【免费下载链接】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），仅供参考