Heyzine 自动化实战基于 Rube MCP 与 Composio 工具箱的 Codex 技能全指南【免费下载链接】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本指南围绕 composio-skills/heyzine-automation/SKILL.md 展开讲解如何让 Codex 通过 Rube MCPComposio 提供的 MCP 端点调用 Composio 的 Heyzine 工具箱完成翻转书flipbook等 Heyzine 操作的自动化。读完本文你将掌握 Rube MCP 的连接与鉴权流程、工具发现Tool Discovery方法论、三段式核心工作流发现 → 校验连接 → 执行以及批量操作、完整 Schema 获取等进阶能力并能在 Codex CLI / API 中直接落地这一技能。技能背景在 awesome-codex-skills 仓库中的定位本项目 awesome-codex-skills 是一个精心整理的 Codex 技能清单其核心理念是技能告诉 Agent “怎么做”MCP 网关则赋予它安全访问真实工具的能力。仓库中的composio-skills/目录收纳了大量基于 Composio 工具箱的自动化技能每个技能目录内只有一个SKILL.md文件通过 YAML frontmatter 声明name、description与requiresMCP 依赖正文则以步骤式指令指导 Codex 执行任务。heyzine-automation技能正是这一模式的 Heyzine 专属实现其 frontmatter 为name: heyzine-automation description: Automate Heyzine tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]description字段中刻意强调 “Always search tools first for current schemas”这是整套技能最重要的一条纪律工具 Schema 会随时间变化任何工作流都不得硬编码工具 slug 或参数。这条约定与仓库 README 中“description 必须穷尽描述触发时机”的创建规范一脉相承可参考 template-skill 的基础模板。前置条件在执行任何 Heyzine 工作流之前需要满足以下三个条件Rube MCP 已连接Codex 会话中必须存在RUBE_SEARCH_TOOLS工具这是判断 Rube MCP 是否就绪的标志。Heyzine 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS为 toolkitheyzine建立并激活连接。先搜索再执行始终先调用RUBE_SEARCH_TOOLS获取当前工具 Schema再决定调用哪个工具、传什么参数。从仓库源码结构看composio-skills/下数百个技能目录如 composio-automation、composio-search-automation均遵循完全相同的前置条件模板区别仅在于toolkit名称说明这是一套经过规模化复用的统一接入约定。环境搭建接入 Rube MCP 并激活 Heyzine 连接添加 Rube MCP 服务器Rube MCP 的接入极其轻量在 Codex 的 MCP 服务器配置中添加端点https://rube.app/mcp即可无需任何 API Key——只添加端点即可工作鉴权在连接层面通过 OAuth 流程完成。四步激活连接验证可用性确认RUBE_SEARCH_TOOLS能正常响应发起连接调用RUBE_MANAGE_CONNECTIONS传入 toolkitheyzine完成授权若返回的连接状态不是ACTIVE则跟随返回的认证链接完成 Heyzine 账号的 OAuth 授权确认状态在运行任何工作流之前确认连接状态显示为ACTIVE。说明OAuth 授权只需要完成一次之后连接持久有效除非用户在 Heyzine 侧撤销授权。每次会话开始建议重新校验一次连接状态避免工具执行中途因连接失效而报错。工具发现一切工作的起点Rube MCP 将工具发现设计为显式步骤。在执行任何 Heyzine 工作流之前先用以下调用发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: Heyzine operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息可用工具的 slug 列表后续RUBE_MULTI_EXECUTE_TOOL需要用到每个工具的输入 Schema字段名、类型、必填项推荐的执行计划适合当前任务的多步编排建议已知的坑known pitfalls该工具已知的边界条件与易错点。其中use_case应尽量具体例如“把 PDF 转为 Heyzine 翻转书”“查询 Heyzine 账户下所有翻转书”等语义越精确返回的工具集越聚焦known_fields用于在已知部分字段时加速检索首次调用时可让 Rube 自动生成会话 IDgenerate_id: true。核心工作流三段式模式技能文档给出了统一的执行范式任何 Heyzine 自动化任务都可套用以下三步。第一步发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Heyzine task}] session: {id: existing_session_id}注意在同一个工作流内应复用会话 IDid: existing_session_idRube 会基于会话上下文提供更连贯的工具推荐新工作流则生成新的会话 ID避免上下文串扰。第二步校验连接RUBE_MANAGE_CONNECTIONS toolkits: [heyzine] session_id: your_session_id这一步是廉价的安全网如果连接处于ACTIVE继续否则按返回的认证链接重新授权。从源码结构看这一步在所有 composio-skills 中都是强制步骤属于模板级约定。第三步执行工具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必须来自第一步搜索结果的真实 slug不得臆造arguments必须严格符合搜索返回的 Schema——字段名、类型、必填项都以搜索结果为唯一依据memory参数必须始终携带即使没有上下文也要传空对象{}一次RUBE_MULTI_EXECUTE_TOOL调用可传入多个工具条目tools为数组用于编排多步骤任务。进阶工具批量操作与完整 Schema除核心三步外技能文档还提供了两个进阶入口适用于更大规模的自动化场景批量操作RUBE_REMOTE_WORKBENCH当需要批量处理例如批量转换多个 PDF 为 Heyzine 翻转书、批量更新元数据时使用远程工作台RUBE_REMOTE_WORKBENCH在其中通过run_composio_tool()函数在远程沙箱中执行工具逻辑可避免长会话中的上下文膨胀并将工具调用与主 Agent 解耦。这种模式适合需要在循环中反复调用同一工具、且对响应延迟不敏感的场景。完整 SchemaRUBE_GET_TOOL_SCHEMAS当搜索结果中返回的工具带schemaRef引用说明完整 Schema 需要单独拉取时使用RUBE_GET_TOOL_SCHEMAS获取工具的完整字段定义通常包含嵌套结构、枚举取值范围等详细约束用于构造精确的参数。快速参考总览操作方式查找工具RUBE_SEARCH_TOOLS附带 Heyzine 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 设为heyzine执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()完整 Schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS已知陷阱与规避策略技能文档总结了六条实战中高频踩坑点逐条给出规避方法必须先搜索再执行工具 Schema 会变任何硬编码的 slug 或参数都可能过时。铁律是每次执行前调用RUBE_SEARCH_TOOLS。执行前校验连接确认RUBE_MANAGE_CONNECTIONS返回ACTIVE避免执行到一半才发现授权失效。严格遵循 Schema参数必须使用搜索返回的精确字段名和类型多一个字段或少一个字段都可能导致工具调用失败。始终携带 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中memory不可省略无上下文时传{}。会话 ID 复用策略同一工作流内复用会话 ID 以保持上下文连贯新工作流必须生成新 ID防止旧上下文干扰工具推荐。分页处理检查响应中的分页 token持续拉取直到数据取完避免只处理第一页导致结果不完整。将技能安装到 Codex本技能随 awesome-codex-skills 仓库分发安装方式与仓库其他技能一致详见 README.md 的 Quickstart 章节方式一使用技能安装器推荐克隆仓库后用skill-installer提供的脚本将技能安装到$CODEX_HOME/skills默认~/.codex/skillspython skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/heyzine-automation安装完成后重启 Codex 以加载新技能元数据。方式二手动安装将composio-skills/heyzine-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 使其加载新的 frontmatter 元数据在会话中描述任务或直接提及技能名Codex 会根据description自动触发匹配的技能本技能 description 中的触发关键词是 Heyzine 自动化任务。仓库 README 还提示了技能目录的标准布局SKILL.md为必选项指令 YAML frontmatterscripts/、references/、assets/为可选增强。本技能只包含SKILL.md单文件正符合“保持上下文精简、把长文档放到 references/ 按需加载”的最佳实践——因为其全部指令连接、发现、执行、规避陷阱都已浓缩在单文件内。技能设计模式小结从仓库视角看heyzine-automation体现了 composio-skills 系列的核心设计范式值得在创建同类技能时复用frontmatter 中声明 MCP 依赖requires.mcp: [rube]让 Codex 在触发技能前就知道基础设施前提description 中嵌入“先搜索”纪律从元数据层面约束 Agent 行为以“连接 → 发现 → 执行”三段式收敛复杂度把第三方 API 的多变 Schema 屏蔽在搜索步骤之后用会话 ID 与 memory 参数管理多步上下文兼顾连贯性与隔离性将批量与 Schema 获取作为独立入口避免主工作流过度膨胀。结合仓库中 connectComposio CLI 方式与本技能Rube MCP 方式可以看出同一“连接任意 App”目标的两种实现路径CLI 适合 shell 内直接驱动Rube MCP 则适合在 Agent 工具调用层面做 Schema 感知的自动化。理解这两条路径的差异有助于在实际项目中按需选型。【免费下载链接】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），仅供参考