Google Super 自动化基于 Rube MCPComposio的 Codex 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/googlesuper-automation/SKILL.md 为骨架系统讲解如何通过 Composio 的 Google Super toolkit 与 Rube MCP在 Codex CLI 中完成 Google Super 相关操作的端到端自动化。读完本文你将掌握 Rube MCP 的接入方式、工具发现Tool Discovery、连接管理与工具执行的标准三步工作流以及 schema 合规、会话复用、分页处理等实战避坑要点可直接复制命令到自己的 Agent 工作流中运行。一、Skill 是什么元数据与触发机制该 Skill 本质上是一份遵循 Codex Skills 规范的指令包。其SKILL.md头部 YAML frontmatter 定义了触发元数据--- name: googlesuper-automation description: Automate Google Super tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---nameSkill 的唯一标识安装后对应$CODEX_HOME/skills/googlesuper-automation目录。descriptionCodex 判断何时触发该 Skill 的依据。注意其中明确要求「Always search tools first for current schemas」这是整个工作流的核心理念——工具 schema 会变化必须动态发现而非硬编码。requires.mcp声明该 Skill 依赖名为rube的 MCP 服务器Codex 在触发前会检查该 MCP 是否可用。这一结构与仓库根目录 README.md 中「What Are Codex Skills?」一节描述的通用规范一致每个 Skill 独立成文件夹、含SKILL.mdCodex 依据 description 元数据决定触发时机仅在触发后才加载正文以保持上下文精简。安装方式可参考 skill-installer 提供的脚本python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/googlesuper-automation安装后重启 Codex 即可生效。该 Skill 属于仓库中庞大的composio-skills/家族该目录下包含数百个按集成命名的同类 Skill如 googledocs、googlecalendar、googledrive 等它们共享同一套 Rube MCP 接入协议仅 toolkit 名称与具体工具集不同——本文讲解的流程对该家族全部适用。二、前置条件Prerequisites在开始任何 Google Super 自动化之前需要满足三项条件Rube MCP 已连接环境中存在RUBE_SEARCH_TOOLS工具这是 Rube MCP 是否可用的探针。Google Super 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立并激活 toolkit 为googlesuper的 OAuth 连接。先搜索再执行任何工作流开始前必须调用RUBE_SEARCH_TOOLS获取当前工具 schema禁止直接猜测工具名或参数。三、Setup接入 Rube MCP 并激活连接3.1 添加 Rube MCP 服务器Rube MCP 的接入极其轻量——无需任何 API Key只需在 MCP 客户端配置中添加端点https://rube.app/mcp把它作为 MCP server 加入客户端配置即可直接使用。3.2 四步连接检查流程验证可用性调用RUBE_SEARCH_TOOLS确认其正常响应。发起连接调用RUBE_MANAGE_CONNECTIONS传入toolkits: [googlesuper]。完成授权若连接状态不是ACTIVE跟随返回的 auth link 完成 OAuth 设置。确认状态在运行任何工作流之前确认连接状态显示为ACTIVE。3.3 安装 Skill 到 Codex可选若要在本地 Codex 中使用该 Skill可将整个googlesuper-automation文件夹复制到$CODEX_HOME/skills/默认为~/.codex/skills/后重启 Codex或在会话中直接描述任务由 Codex 依据 description 自动触发匹配的 Skill。四、工具发现Tool Discovery这是执行任何工作流前的强制第一步。文档给出的标准发现请求RUBE_SEARCH_TOOLS queries: [{use_case: Google Super operations, known_fields: }] session: {generate_id: true}返回内容包含四类关键信息可用工具的 slug即后续执行阶段要使用的tool_slug输入 schema每个工具的参数名、类型、必填项推荐的执行计划针对该 use case 的最佳工具组合与调用顺序已知陷阱该工具集特有的注意事项。session.generate_id: true表示让服务端生成一个新的会话 ID用于承载本次发现请求后续工作流中应复用该 ID。五、核心工作流模式Core Workflow Pattern标准的三步模式贯穿所有任务其设计意图是先发现、再确认、后执行。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Google Super task}] session: {id: existing_session_id}与初始发现相比此处use_case换成具体任务描述例如创建电子表格、读取数据、导出报表等并复用已有会话 ID而非重新生成。通过搜索结果的 schema 确定要用的工具 slug 与参数结构。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [googlesuper] session_id: your_session_id执行前确认 Google Super 的 OAuth 连接仍是ACTIVE状态。OAuth token 可能过期或被撤销这一步能提前拦截大部分执行期鉴权失败。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 搜索结果中的真实 slug不能硬编码arguments必须严格符合搜索结果返回的 schema字段名、类型、必填项memory参数必须始终携带即使无状态也传空对象{}session_id复用 Step 1 的会话保证同一工作流内状态连贯。从仓库中同族的 Skill如 composio-skills/googledocs-automation/SKILL.md、composio-skills/googlecalendar-automation/SKILL.md可以看到同样的三步模式被数百个集成 Skill 复用差异仅在于 toolkit 名googlesuper与搜索时的 use_case 描述——这说明该模式是 Composio Rube 体系下稳定、通用、经过大规模验证的执行范式。六、已知陷阱清单Known Pitfalls陷阱应对策略工具 schema 会变化绝不硬编码 tool slug 或参数每次执行前调用RUBE_SEARCH_TOOLS连接可能失效执行前用RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE参数不合法严格使用搜索结果中的字段名与类型逐一核对必填项漏传 memoryRUBE_MULTI_EXECUTE_TOOL调用中始终携带memory空状态传{}会话混乱同一工作流内复用 session ID新工作流才生成新 ID结果被截断检查响应中的分页 token持续拉取直到数据完整其中「先搜索」被反复强调frontmatter description、Prerequisites、Tool Discovery、Pitfalls 四处出现足见其重要性Composio 工具集会随上游 API 演进schema 是唯一可信的事实来源。七、快速参考表Quick Reference操作途径查找工具RUBE_SEARCH_TOOLSuse case 描述为 Google Super 相关任务建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定googlesuper执行工具RUBE_MULTI_EXECUTE_TOOL携带搜索发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于处理带schemaRef的工具参考表揭示了两个进阶能力批量操作当需要循环执行大量工具调用时可用RUBE_REMOTE_WORKBENCH远程执行环境中的run_composio_tool()函数编排批量任务避免在 Agent 会话内逐条往返完整 schema部分复杂工具以schemaRef形式引用外部 schema需调用RUBE_GET_TOOL_SCHEMAS拉取完整定义后才能正确构造arguments。八、一个完整的实战串联示例结合上述全部要素一个典型的「在 Codex 中自动化 Google Super 报表生成」工作流如下调用RUBE_SEARCH_TOOLSuse_case: Google Super operations生成新会话得到可用 slug 与参数 schema调用RUBE_MANAGE_CONNECTIONStoolkits: [googlesuper]确认连接ACTIVE调用RUBE_MULTI_EXECUTE_TOOL传入搜索到的 slug 与 schema 合规参数携带memory: {}与同一session_id检查响应中的分页 token必要时继续拉取直至拿到完整结果若涉及大量数据操作改用RUBE_REMOTE_WORKBENCH的run_composio_tool()批量编排。适用范围与限制本流程适用于通过 Rube MCPComposio 提供 1000 集成的统一 MCP 网关访问 Google Super 工具集的场景工具 slug、参数结构乃至连接机制均由 Rube/Composio 服务端动态下发实际以RUBE_SEARCH_TOOLS返回的实时 schema 为准。该 Skill 仅承担编排规范不包含任何凭据——OAuth 通过RUBE_MANAGE_CONNECTIONS的授权链接完成安全边界清晰。总结本文完整继承了 composio-skills/googlesuper-automation/SKILL.md 的全部内容并将其置于 awesome-codex-skills 仓库的大背景下展开这是一套「发现工具 → 校验连接 → 执行调用」的动态驱动型自动化范式其核心价值在于永远以实时 schema 为事实来源从机制上规避了工具版本漂移带来的集成腐化问题。掌握了这份 Skill你不仅能自动化 Google Super还能将其推广到仓库composio-skills/目录下数百个同构集成真正做到一套模式、处处复用。Powered by 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），仅供参考