使用 Rube MCP 在 Codex 中自动化 Happy Scribe 转录与字幕工作流：awesome-codex-skills 实战指南
使用 Rube MCP 在 Codex 中自动化 Happy Scribe 转录与字幕工作流awesome-codex-skills 实战指南【免费下载链接】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/happy-scribe-automation/SKILL.md 展开讲解如何在 Codex 中通过 Rube MCP 连接 Composio 的 Happy Scribe 工具集以对话式指令完成转录、字幕等任务的发现、连接与批量执行。读完本文你将掌握 Rube MCP 的零配置接入方式、RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三个核心调用模式以及规避 schema 漂移、会话复用等坑位的最佳实践。Happy Scribe 自动化技能是什么Happy Scribe 是音频/视频转录与字幕领域的常用服务平台。本技能skill的作用是让 Codex 代理通过Rube MCP调用Composio 提供的 Happy Scribe toolkit把「上传音视频 → 生成转录稿 → 整理字幕 → 导出结果」这类重复性操作交给 Agent 自动完成。该技能位于仓库的composio-skills目录下其 SKILL.md 文件以 YAML frontmatter 声明了技能元数据--- name: happy-scribe-automation description: Automate Happy Scribe tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段元数据符合仓库 README.md 定义的 Codex 技能规范每个技能拥有独立目录与SKILL.mdCodex 依据description判断何时触发技能命中后才加载正文以节省上下文。其中requires.mcp声明该技能依赖名为rube的 MCP 服务器。值得说明的是composio-skills目录收录了数百个结构完全一致的自动化技能如 flutterwave-automation、composio-automation它们共享同一套「Rube MCP Composio toolkit」模式本文讲述的调用范式同样适用于这些技能。前置条件开始使用前需要满足三项前置条件Rube MCP 必须已连接即RUBE_SEARCH_TOOLS工具可用这是所有后续调用的基础Happy Scribe 连接必须处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为happy_scribe的连接先搜索、后执行任何工作流启动前必须先调用RUBE_SEARCH_TOOLS获取当前的工具 schema避免使用过期字段。获取 Rube MCP零 API Key 接入Rube MCP 的接入非常简单无需申请任何 API Key只需在 MCP 客户端配置中把https://rube.app/mcp添加为 MCP 服务器端点即可。连接建立后按以下四步完成 Happy Scribe 的连接配置验证可用性确认RUBE_SEARCH_TOOLS能正常响应发起连接调用RUBE_MANAGE_CONNECTIONS传入 toolkithappy_scribe完成授权若连接状态不是ACTIVE按照返回的认证链接完成授权设置确认状态在运行任何工作流之前确认连接状态已变为ACTIVE。工具发现RUBE_SEARCH_TOOLS 的作用工具 schema 会随服务端更新而变化因此技能文档反复强调「Always search tools first」。首次使用可用如下调用完成全局工具发现RUBE_SEARCH_TOOLS queries: [{use_case: Happy Scribe operations, known_fields: }] session: {generate_id: true}该调用会返回四类关键信息可用工具 slug后续RUBE_MULTI_EXECUTE_TOOL执行时使用的工具标识输入 schema每个工具要求的字段名、类型与取值范围推荐执行计划针对该 use case 的建议调用序列已知陷阱该工具集常见的使用注意事项。注意session: {generate_id: true}表示由系统生成一个新的会话 ID适用于新工作流的起点而同一工作流内部的后续调用则应复用已有会话 ID见下文。核心工作流模式三步完成一次自动化技能文档给出了统一的「发现 → 检查 → 执行」三步工作流适用于任何具体的 Happy Scribe 任务。Step 1发现可用工具将具体的任务描述填入use_case并复用当前工作流的会话 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Happy Scribe task}] session: {id: existing_session_id}例如需要批量转录时use_case 可描述为对应的转录场景系统会返回与该场景匹配的工具 slug 与参数 schema。这里刻意使用占位符your specific Happy Scribe task而非硬编码正是因为工具集随版本演化具体任务措辞应以实际查询为准。Step 2检查连接状态执行任何工具前务必确认 Happy Scribe 连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [happy_scribe] session_id: your_session_id若返回非 ACTIVE 状态应先回到 Setup 步骤完成授权再继续后续操作。Step 3执行工具使用RUBE_MULTI_EXECUTE_TOOL执行从搜索结果中获得的工具RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_idtools数组支持一次调用执行多个工具每个元素包含tool_slug必须来自搜索结果和arguments必须严格符合搜索返回的 schema。memory参数每次都必须携带即使为空也要显式传{}session_id沿用工作流既有 ID。已知陷阱与最佳实践技能文档总结了六条经过实践检验的注意事项直接影响自动化流程的成败始终先搜索工具 schema 会变化未调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是导致调用失败的首要原因检查连接执行前通过RUBE_MANAGE_CONNECTIONS确认连接为 ACTIVE避免在断连状态下空跑Schema 合规参数必须使用搜索结果的精确字段名与类型多一个、少一个字段都可能被拒Memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须始终包含memory即使为空对象{}会话复用同一工作流内复用会话 ID 以保持上下文连贯开启新工作流时才生成新 ID分页处理检查响应中的分页 token持续拉取直到数据完整避免只拿到第一页结果。操作速查表操作方式查找工具RUBE_SEARCH_TOOLS传入 Happy Scribe 相关的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 传happy_scribe执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具这张表覆盖了从发现到批量执行的完整链路常规单次任务走前三行大规模批量场景切换到RUBE_REMOTE_WORKBENCH的run_composio_tool()函数式调用需要精读参数定义时再用RUBE_GET_TOOL_SCHEMAS展开schemaRef指向的完整 schema。在 awesome-codex-skills 仓库中安装与使用本技能本技能是 awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API收录的众多实战技能之一。按照仓库 README 的说明技能安装到$CODEX_HOME/skills默认~/.codex/skills每个子目录内的SKILL.md通过name与descriptionfrontmatter 被 Codex 识别git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # 安装 composio-skills 下的 happy-scribe-automation 技能 python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/happy-scribe-automation安装后重启 Codex 以加载新技能元数据然后在会话中自然描述任务如「把这段会议录音转录成带时间戳的字幕」Codex 会依据description自动触发本技能。触发后Agent 将按本文前述流程依次完成工具发现、连接检查与工具执行。需要提醒的是技能文档中出现的https://rube.app/mcp与 Composio toolkit 文档链接属于外部服务实际使用时以 Rube MCP 返回的实时 schema 为准这正是该技能「先搜索、后执行」设计理念的核心所在。小结本技能为 Happy Scribe 转录与字幕自动化提供了一套「工具发现先行、连接状态校验、schema 合规执行」的稳健范式其价值在于把易变的工具接口封装为稳定的对话式工作流。无论是单次转录还是通过RUBE_REMOTE_WORKBENCH的批量处理遵循本文的三步核心模式与六条陷阱规避原则即可在 Codex 中稳定地复用这套 Happy Scribe 自动化能力。【免费下载链接】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），仅供参考