在 awesome-codex-skills 中通过 Rube MCP 自动化 Google Calendar 的完整实战指南【免费下载链接】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/googlecalendar-automation/SKILL.md 为核心讲解如何让 Codex Agent 通过 Rube MCPComposio 提供发现并调用 Google Calendar 工具完成日程查询、创建、修改等自动化操作。读完本文你将掌握 Rube MCP 的连接流程、RUBE_SEARCH_TOOLS工具发现机制、三阶段核心工作流模式以及避免踩坑的关键约定可直接将其落地为可复用的 Codex Skill。一、Skill 定位与元数据解读该 Skill 是仓库composio-skills/目录下数百个自动化 Skill 之一。其SKILL.md的 YAML frontmatter 定义了它的触发元数据--- name: googlecalendar-automation description: Automate Google Calendar tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从这段元数据可以提炼出三个关键信息触发机制Codex 会读取description字段当用户请求涉及 Google Calendar 任务时自动匹配触发该 Skill仓库 README.md 的 Using Skills in Codex 一节明确说明这一机制。依赖声明requires.mcp: [rube]表明该 Skill 运行的前提是客户端已配置名为rube的 MCP 服务器。核心原则description 中反复强调 Always search tools first——工具 schema 会持续演进Agent 每次执行前必须先动态发现工具而不是硬编码工具名和参数。二、前置条件Prerequisites根据原文档运行该 Skill 需要满足三个前置条件Rube MCP 已连接客户端环境必须能访问RUBE_SEARCH_TOOLS工具Rube MCP 提供的工具发现入口。Google Calendar 连接处于 ACTIVE 状态需要通过RUBE_MANAGE_CONNECTIONS建立并激活googlecalendartoolkit 的连接。先搜索再执行任何工作流开始前必须先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。这三个条件环环相扣MCP 服务器是通道ACTIVE 连接是权限schema 搜索是正确调用的保障。三、Setup接入 Rube MCP 并建立连接3.1 添加 Rube MCP 服务器原文档给出的接入方式极为简单——无需申请任何 API Key只需在 MCP 客户端配置中把端点https://rube.app/mcp添加为 MCP server 即可。配置完成后重启客户端使 MCP 工具重新加载。3.2 建立 Google Calendar 连接的四个步骤1. 验证 Rube MCP 可用确认 RUBE_SEARCH_TOOLS 有响应 2. 调用 RUBE_MANAGE_CONNECTIONStoolkit 传 googlecalendar 3. 若连接状态不是 ACTIVE跟随返回的 auth 链接完成授权 4. 确认连接状态为 ACTIVE 后再运行任何工作流其中第 2 步是关键RUBE_MANAGE_CONNECTIONS负责管理外部应用的 OAuth 连接生命周期传入toolkits: [googlecalendar]后系统会返回授权链接若尚未授权或连接状态。只有状态为ACTIVE后续工具调用才有权限基础。四、Tool Discovery动态发现工具 schema原文档强调Rube MCP 的工具列表与 schema 会动态变化因此引入RUBE_SEARCH_TOOLS作为统一的工具发现入口。标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Google Calendar operations, known_fields: }] session: {generate_id: true}该调用返回四类关键信息可用的工具 slugtool slugs输入 schemainput schemas字段名与类型推荐的执行计划recommended execution plans已知陷阱known pitfalls这也是为什么 Skill 元数据中反复强调 Always search tools first工具名、参数结构都可能随服务端更新而变化硬编码任何 slug 或参数都可能导致调用失败。五、核心工作流模式Core Workflow Pattern原文档给出了一套可复用的三阶段工作流任何 Google Calendar 自动化任务都应遵循Step 1发现可用工具先用具体任务描述替换 use_case并复用已有会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Google Calendar task}] session: {id: existing_session_id}Step 2检查连接状态执行前确认连接仍然有效RUBE_MANAGE_CONNECTIONS toolkits: [googlecalendar] session_id: your_session_idStep 3执行工具将搜索得到的工具 slug 与 schema 合规参数填入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必须来自搜索结果的真实值不能凭记忆填写arguments的字段名与类型必须与 schema 完全一致memory参数即使为空也必须显式传{}同一工作流内复用session_id新工作流再生成新 ID。六、已知陷阱清单Known Pitfalls原文档总结了 6 条必须遵守的工程约束是避免线上事故的关键陷阱应对策略工具 schema 会变化永远先调RUBE_SEARCH_TOOLS绝不硬编码 tool slug 或参数连接可能失效执行前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态参数类型不匹配严格使用搜索结果中的精确字段名与类型遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须携带memory空值写{}会话管理混乱工作流内复用 session ID新工作流生成新 ID分页未处理检查响应中的分页 token持续拉取直至数据完整其中分页一条尤其重要Google Calendar 的列表类操作如查询未来事件返回结果可能跨多页Agent 必须循环处理分页 token否则会得到不完整的日程数据。七、快速参考表Quick Reference原文档以表格形式浓缩了全部操作入口这是 Agent 运行时最实用的速查表操作方式查找工具用 Google Calendar 相关 use case 调RUBE_SEARCH_TOOLS建立连接用 toolkitgooglecalendar调RUBE_MANAGE_CONNECTIONS执行操作用发现的 tool slug 调RUBE_MULTI_EXECUTE_TOOL批量操作用RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对含schemaRef的工具调RUBE_GET_TOOL_SCHEMAS批量操作与完整 schema 两个入口是进阶场景当需要对多个日历事件做批量更新时RUBE_REMOTE_WORKBENCH的run_composio_tool()允许在远程工作台环境中执行复杂逻辑而当搜索结果只返回schemaRef引用而未内联完整 schema 时则需要通过RUBE_GET_TOOL_SCHEMAS拉取完整定义。八、将 Skill 安装进 Codex作为仓库内 Skill该文件可按仓库 README.md 的 Quickstart 安装到本地方式一Skill Installer推荐仓库提供官方安装脚本 skill-installer/scripts/install-skill-from-github.py支持--repo、--url、--path、--ref、--dest、--name、--method等参数。安装脚本会校验目标路径中必须存在SKILL.md见脚本内_validate_skill函数并将整个 Skill 目录复制到$CODEX_HOME/skills/skill-name默认~/.codex/skills。方式二手动安装将composio-skills/googlecalendar-automation/目录复制到$CODEX_HOME/skills/下然后重启 Codex 加载元数据。后续在会话中用自然语言描述 Google Calendar 任务即可自动触发该 Skill。安装后可通过ls ~/.codex/skills与head ~/.codex/skills/googlecalendar-automation/SKILL.md验证安装结果。九、生态联动与 Google Meet Skill 协同仓库中与其紧密相关的还有 composio-skills/googlemeet-automation/SKILL.md它展示了 Google Calendar toolkit 的典型跨模块用法用GOOGLECALENDAR_CREATE_EVENT创建含 Google Meet 链接的日程create_meeting_room: true默认开启用GOOGLECALENDAR_FIND_FREE_SLOTS在安排会议前查询参会者空闲时段用GOOGLECALENDAR_PATCH_EVENT修改或改期已有会议用GOOGLECALENDAR_GET_CURRENT_DATE_TIME获取当前时间用于相对时间排程。这些工具命名GOOGLECALENDAR_*前缀与 Rube MCP 搜索返回的 slug 一一对应可作为理解 Google Calendar toolkit 能力边界的参考从建事件、查空闲、改事件到取当前时间覆盖了日程自动化的主干场景。十、总结googlecalendar-automation是仓库中一个高度工程化的 Codex Skill 范例它以动态 schema 发现为核心设计原则通过RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL三阶段工作流将 Google Calendar 的复杂 API 调用封装为对 Agent 友好的指令集。理解其元数据、前置条件、工作流模式与陷阱清单不仅能让你立即在 Codex 中自动化日历操作更能举一反三——仓库composio-skills/下数百个同名模式 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 在 awesome-codex-skills 中通过 Rube MCP 自动化 Google Calendar 的完整实战指南
在 awesome-codex-skills 中通过 Rube MCP 自动化 Google Calendar 的完整实战指南【免费下载链接】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/googlecalendar-automation/SKILL.md 为核心讲解如何让 Codex Agent 通过 Rube MCPComposio 提供发现并调用 Google Calendar 工具完成日程查询、创建、修改等自动化操作。读完本文你将掌握 Rube MCP 的连接流程、RUBE_SEARCH_TOOLS工具发现机制、三阶段核心工作流模式以及避免踩坑的关键约定可直接将其落地为可复用的 Codex Skill。一、Skill 定位与元数据解读该 Skill 是仓库composio-skills/目录下数百个自动化 Skill 之一。其SKILL.md的 YAML frontmatter 定义了它的触发元数据--- name: googlecalendar-automation description: Automate Google Calendar tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从这段元数据可以提炼出三个关键信息触发机制Codex 会读取description字段当用户请求涉及 Google Calendar 任务时自动匹配触发该 Skill仓库 README.md 的 Using Skills in Codex 一节明确说明这一机制。依赖声明requires.mcp: [rube]表明该 Skill 运行的前提是客户端已配置名为rube的 MCP 服务器。核心原则description 中反复强调 Always search tools first——工具 schema 会持续演进Agent 每次执行前必须先动态发现工具而不是硬编码工具名和参数。二、前置条件Prerequisites根据原文档运行该 Skill 需要满足三个前置条件Rube MCP 已连接客户端环境必须能访问RUBE_SEARCH_TOOLS工具Rube MCP 提供的工具发现入口。Google Calendar 连接处于 ACTIVE 状态需要通过RUBE_MANAGE_CONNECTIONS建立并激活googlecalendartoolkit 的连接。先搜索再执行任何工作流开始前必须先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema。这三个条件环环相扣MCP 服务器是通道ACTIVE 连接是权限schema 搜索是正确调用的保障。三、Setup接入 Rube MCP 并建立连接3.1 添加 Rube MCP 服务器原文档给出的接入方式极为简单——无需申请任何 API Key只需在 MCP 客户端配置中把端点https://rube.app/mcp添加为 MCP server 即可。配置完成后重启客户端使 MCP 工具重新加载。3.2 建立 Google Calendar 连接的四个步骤1. 验证 Rube MCP 可用确认 RUBE_SEARCH_TOOLS 有响应 2. 调用 RUBE_MANAGE_CONNECTIONStoolkit 传 googlecalendar 3. 若连接状态不是 ACTIVE跟随返回的 auth 链接完成授权 4. 确认连接状态为 ACTIVE 后再运行任何工作流其中第 2 步是关键RUBE_MANAGE_CONNECTIONS负责管理外部应用的 OAuth 连接生命周期传入toolkits: [googlecalendar]后系统会返回授权链接若尚未授权或连接状态。只有状态为ACTIVE后续工具调用才有权限基础。四、Tool Discovery动态发现工具 schema原文档强调Rube MCP 的工具列表与 schema 会动态变化因此引入RUBE_SEARCH_TOOLS作为统一的工具发现入口。标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Google Calendar operations, known_fields: }] session: {generate_id: true}该调用返回四类关键信息可用的工具 slugtool slugs输入 schemainput schemas字段名与类型推荐的执行计划recommended execution plans已知陷阱known pitfalls这也是为什么 Skill 元数据中反复强调 Always search tools first工具名、参数结构都可能随服务端更新而变化硬编码任何 slug 或参数都可能导致调用失败。五、核心工作流模式Core Workflow Pattern原文档给出了一套可复用的三阶段工作流任何 Google Calendar 自动化任务都应遵循Step 1发现可用工具先用具体任务描述替换 use_case并复用已有会话RUBE_SEARCH_TOOLS queries: [{use_case: your specific Google Calendar task}] session: {id: existing_session_id}Step 2检查连接状态执行前确认连接仍然有效RUBE_MANAGE_CONNECTIONS toolkits: [googlecalendar] session_id: your_session_idStep 3执行工具将搜索得到的工具 slug 与 schema 合规参数填入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必须来自搜索结果的真实值不能凭记忆填写arguments的字段名与类型必须与 schema 完全一致memory参数即使为空也必须显式传{}同一工作流内复用session_id新工作流再生成新 ID。六、已知陷阱清单Known Pitfalls原文档总结了 6 条必须遵守的工程约束是避免线上事故的关键陷阱应对策略工具 schema 会变化永远先调RUBE_SEARCH_TOOLS绝不硬编码 tool slug 或参数连接可能失效执行前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态参数类型不匹配严格使用搜索结果中的精确字段名与类型遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须携带memory空值写{}会话管理混乱工作流内复用 session ID新工作流生成新 ID分页未处理检查响应中的分页 token持续拉取直至数据完整其中分页一条尤其重要Google Calendar 的列表类操作如查询未来事件返回结果可能跨多页Agent 必须循环处理分页 token否则会得到不完整的日程数据。七、快速参考表Quick Reference原文档以表格形式浓缩了全部操作入口这是 Agent 运行时最实用的速查表操作方式查找工具用 Google Calendar 相关 use case 调RUBE_SEARCH_TOOLS建立连接用 toolkitgooglecalendar调RUBE_MANAGE_CONNECTIONS执行操作用发现的 tool slug 调RUBE_MULTI_EXECUTE_TOOL批量操作用RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schema对含schemaRef的工具调RUBE_GET_TOOL_SCHEMAS批量操作与完整 schema 两个入口是进阶场景当需要对多个日历事件做批量更新时RUBE_REMOTE_WORKBENCH的run_composio_tool()允许在远程工作台环境中执行复杂逻辑而当搜索结果只返回schemaRef引用而未内联完整 schema 时则需要通过RUBE_GET_TOOL_SCHEMAS拉取完整定义。八、将 Skill 安装进 Codex作为仓库内 Skill该文件可按仓库 README.md 的 Quickstart 安装到本地方式一Skill Installer推荐仓库提供官方安装脚本 skill-installer/scripts/install-skill-from-github.py支持--repo、--url、--path、--ref、--dest、--name、--method等参数。安装脚本会校验目标路径中必须存在SKILL.md见脚本内_validate_skill函数并将整个 Skill 目录复制到$CODEX_HOME/skills/skill-name默认~/.codex/skills。方式二手动安装将composio-skills/googlecalendar-automation/目录复制到$CODEX_HOME/skills/下然后重启 Codex 加载元数据。后续在会话中用自然语言描述 Google Calendar 任务即可自动触发该 Skill。安装后可通过ls ~/.codex/skills与head ~/.codex/skills/googlecalendar-automation/SKILL.md验证安装结果。九、生态联动与 Google Meet Skill 协同仓库中与其紧密相关的还有 composio-skills/googlemeet-automation/SKILL.md它展示了 Google Calendar toolkit 的典型跨模块用法用GOOGLECALENDAR_CREATE_EVENT创建含 Google Meet 链接的日程create_meeting_room: true默认开启用GOOGLECALENDAR_FIND_FREE_SLOTS在安排会议前查询参会者空闲时段用GOOGLECALENDAR_PATCH_EVENT修改或改期已有会议用GOOGLECALENDAR_GET_CURRENT_DATE_TIME获取当前时间用于相对时间排程。这些工具命名GOOGLECALENDAR_*前缀与 Rube MCP 搜索返回的 slug 一一对应可作为理解 Google Calendar toolkit 能力边界的参考从建事件、查空闲、改事件到取当前时间覆盖了日程自动化的主干场景。十、总结googlecalendar-automation是仓库中一个高度工程化的 Codex Skill 范例它以动态 schema 发现为核心设计原则通过RUBE_SEARCH_TOOLS→RUBE_MANAGE_CONNECTIONS→RUBE_MULTI_EXECUTE_TOOL三阶段工作流将 Google Calendar 的复杂 API 调用封装为对 Agent 友好的指令集。理解其元数据、前置条件、工作流模式与陷阱清单不仅能让你立即在 Codex 中自动化日历操作更能举一反三——仓库composio-skills/下数百个同名模式 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考