Awesome Codex Skills 实战基于 Rube MCP 实现 Ambient Weather 天气数据自动化接入【免费下载链接】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-skillsAmbient Weather 是一家提供个人气象站硬件与云服务的厂商其数据 API 可提供温度、湿度、气压、风速、降雨等实时观测数据。本文基于仓库 awesome-codex-skills 中 composio-skills/ambient-weather-automation/SKILL.md 所定义的 Codex Skill完整讲解如何通过 Rube MCP 网关调用 Composio 的 Ambient Weather 工具集从工具发现、连接管理到任务执行的端到端自动化流程。读完本文你将掌握一套先搜索 Schema、再校验连接、最后执行工具的通用自动化模式可直接迁移到该仓库 600 个同类 Composio 自动化 Skill 中。一、Skill 定位这份文档解决什么问题在 awesome-codex-skills 仓库中composio-skills/目录下收录了大量面向具体第三方服务的自动化 SkillAmbient Weather 对应的目录为 composio-skills/ambient-weather-automation/。其 SKILL.md 的元数据明确给出了触发语义--- name: ambient-weather-automation description: Automate Ambient Weather tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中description字段声明了该 Skill 的能力边界与关键约束Always search tools firstCodex 在会话中会根据用户请求与这段描述做匹配并自动触发requires.mcp声明了运行依赖——必须挂载名为rube的 MCP 服务器。这与仓库 README.md 中Skills tell your agent how to work. An MCP Gateway gives it secure access to the tools it needs的理念一致Skill 负责方法论MCP 网关负责打通真实世界的能力。该 Skill 的核心思路是不把工具调用写死而是通过 Rube MCP 暴露的发现类工具实时获取当前可用的工具与参数 Schema再按 Schema 构造调用。原因在于第三方工具集的接口会持续演进硬编码工具名或参数极易失效。二、前置条件开始之前需要满足以下三项要求对应原文档 Prerequisites 小节Rube MCP 已连接客户端中必须存在可用的RUBE_SEARCH_TOOLS工具这是验证 Rube MCP 是否就绪的基准。Ambient Weather 连接处于 ACTIVE 状态需要通过RUBE_MANAGE_CONNECTIONS为ambient_weather工具集建立并激活 OAuth 连接。先搜索后执行任何工作流执行前都必须调用RUBE_SEARCH_TOOLS获取当前最新的工具 Schema。三、环境搭建接入 Rube MCP 并激活连接3.1 添加 Rube MCP 服务器原文档给出了极简的接入方式在客户端的 MCP 服务器配置中添加端点https://rube.app/mcp即可无需任何 API Key——添加端点后即自动生效。这是 Rube MCP 网关的核心设计它把 1,000 第三方集成的鉴权、连接生命周期和工具代理集中收敛到一个标准 MCP 端点上仓库 README.md 将其称为 MCP Gateway 模式。3.2 连接激活四步流程原文档规定了严格的操作顺序建议按序执行确认 Rube MCP 可用调用RUBE_SEARCH_TOOLS确认有响应调用RUBE_MANAGE_CONNECTIONS传入工具集ambient_weather若连接状态不是ACTIVE点击返回的授权链接完成 OAuth 设置再次确认连接状态为ACTIVE然后才允许运行任何工作流。从源码结构看RUBE_MANAGE_CONNECTIONS承担的是连接生命周期管理职责它同时用于查询连接状态第 2 步和返回授权入口第 3 步是先连接、后执行这一铁律的落点。四、工具发现永远先取最新 Schema这是整个 Skill 的第一步也是最容易被忽略的一步。原文档给出了标准发现调用RUBE_SEARCH_TOOLS queries: [{use_case: Ambient Weather operations, known_fields: }] session: {generate_id: true}关键参数说明queries[].use_case用自然语言描述你要做的任务例如Ambient Weather operations也可以替换为更具体的如读取某台气象站实时数据queries[].known_fields已知字段可为空字符串session.generate_id: true首次调用时让服务端生成新的会话 ID供后续步骤复用。该调用的返回值包括四类关键信息可用工具的 slug、输入参数 Schema、推荐的执行计划以及已知陷阱known pitfalls。这意味着工具发现不仅是查名字而是把执行方案和避坑指南一并返回为后续RUBE_MULTI_EXECUTE_TOOL的参数构造提供权威依据。五、核心工作流发现 → 连接 → 执行原文档将可复用的执行模式提炼为三个步骤任何 Ambient Weather 任务拉取实时观测、历史数据、设备信息等都遵循这一模板。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Ambient Weather task}] session: {id: existing_session_id}与首次发现相比这里复用已存在的session_id表示该请求属于既有工作流的一部分。会话复用是保证工作流内状态连续的关键。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [ambient_weather] session_id: your_session_id在执行任何工具前确认ambient_weather工具集的连接状态。若返回非ACTIVE回到第三节的第 3 步完成授权后再继续。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 的搜索结果禁止凭空猜测arguments必须严格符合搜索返回的 Schema字段名、类型、必填项均以 Schema 为准memory参数必须始终携带即使为空也要传{}session_id沿用 Step 1/2 的会话。六、已知陷阱六个必须遵守的实践约束原文档的 Known Pitfalls 小节沉淀了使用该类 Skill 的六个关键教训任何一条被违反都可能导致调用失败或数据不全陷阱约束Always search first工具 Schema 会变化。未经RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数属于高危操作Check connection执行前必须通过RUBE_MANAGE_CONNECTIONS确认连接为ACTIVE状态Schema compliance必须使用搜索结果中的精确字段名与类型不能凭记忆构造参数Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须包含memory参数空则传{}Session reuse同一工作流内复用 session ID新工作流生成新的 session IDPagination检查响应中的分页令牌持续拉取直至数据完整从该 Skill 的 YAML 元数据description中的 Always search tools first for current schemas可以看出先搜索不仅是实践建议而是被写进了 Skill 触发语义的硬性要求——这也解释了为什么仓库中 600 余个 composio 自动化 Skill 都统一采用同一套发现→连接→执行模式。七、快速参考表四类核心操作一览原文档最后给出了操作速查表覆盖常规执行与进阶场景OperationApproachFind toolsRUBE_SEARCH_TOOLS配合 Ambient Weather 专属 use_caseConnectRUBE_MANAGE_CONNECTIONS传入工具集ambient_weatherExecuteRUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slugBulk opsRUBE_REMOTE_WORKBENCH配合run_composio_tool()Full schema对带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS获取完整 Schema其中最后两行对应进阶用法批量操作时改用RUBE_REMOTE_WORKBENCH中的run_composio_tool()编程式执行当搜索返回的工具引用schemaRef时需要进一步调用RUBE_GET_TOOL_SCHEMAS拉取完整 Schema 定义。八、配套资源如何安装与使用该 Skill该 Skill 作为仓库的一部分可通过仓库自带的安装器部署到本地 Codexpython skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/ambient-weather-automation从 安装脚本源码 的实现看安装逻辑会将 skill 拷贝到$CODEX_HOME/skills/skill-name默认~/.codex/skills技能名取自路径 basename此处即ambient-weather-automation且若目标目录已存在会中止安装。安装完成后重启 Codex 加载新元数据详见 skill-installer/SKILL.md 与 README.md 中的安装指引。使用阶段只需在 Codex 会话中自然描述任务例如拉取我在 Ambient Weather 上注册的气象站的当前观测数据Codex 会根据 SKILL.md 的description自动触发本 Skill随后按第五节的三步流程执行。如需查看其他工具的自动化方式composio-skills/目录下的同类 Skill如 ambee-automation遵循完全一致的结构可对照参考。九、总结ambient-weather-automationSkill 的完整方法论可归纳为一句话让 Agent 先向网关问清楚再动手执行。通过RUBE_SEARCH_TOOLS发现、RUBE_MANAGE_CONNECTIONS连接、RUBE_MULTI_EXECUTE_TOOL执行三件套配以Schema 至上、会话复用、分页拉全的纪律即可稳定地将 Ambient Weather 的天气数据接入到 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Awesome Codex Skills 实战：基于 Rube MCP 实现 Ambient Weather 天气数据自动化接入
Awesome Codex Skills 实战基于 Rube MCP 实现 Ambient Weather 天气数据自动化接入【免费下载链接】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-skillsAmbient Weather 是一家提供个人气象站硬件与云服务的厂商其数据 API 可提供温度、湿度、气压、风速、降雨等实时观测数据。本文基于仓库 awesome-codex-skills 中 composio-skills/ambient-weather-automation/SKILL.md 所定义的 Codex Skill完整讲解如何通过 Rube MCP 网关调用 Composio 的 Ambient Weather 工具集从工具发现、连接管理到任务执行的端到端自动化流程。读完本文你将掌握一套先搜索 Schema、再校验连接、最后执行工具的通用自动化模式可直接迁移到该仓库 600 个同类 Composio 自动化 Skill 中。一、Skill 定位这份文档解决什么问题在 awesome-codex-skills 仓库中composio-skills/目录下收录了大量面向具体第三方服务的自动化 SkillAmbient Weather 对应的目录为 composio-skills/ambient-weather-automation/。其 SKILL.md 的元数据明确给出了触发语义--- name: ambient-weather-automation description: Automate Ambient Weather tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中description字段声明了该 Skill 的能力边界与关键约束Always search tools firstCodex 在会话中会根据用户请求与这段描述做匹配并自动触发requires.mcp声明了运行依赖——必须挂载名为rube的 MCP 服务器。这与仓库 README.md 中Skills tell your agent how to work. An MCP Gateway gives it secure access to the tools it needs的理念一致Skill 负责方法论MCP 网关负责打通真实世界的能力。该 Skill 的核心思路是不把工具调用写死而是通过 Rube MCP 暴露的发现类工具实时获取当前可用的工具与参数 Schema再按 Schema 构造调用。原因在于第三方工具集的接口会持续演进硬编码工具名或参数极易失效。二、前置条件开始之前需要满足以下三项要求对应原文档 Prerequisites 小节Rube MCP 已连接客户端中必须存在可用的RUBE_SEARCH_TOOLS工具这是验证 Rube MCP 是否就绪的基准。Ambient Weather 连接处于 ACTIVE 状态需要通过RUBE_MANAGE_CONNECTIONS为ambient_weather工具集建立并激活 OAuth 连接。先搜索后执行任何工作流执行前都必须调用RUBE_SEARCH_TOOLS获取当前最新的工具 Schema。三、环境搭建接入 Rube MCP 并激活连接3.1 添加 Rube MCP 服务器原文档给出了极简的接入方式在客户端的 MCP 服务器配置中添加端点https://rube.app/mcp即可无需任何 API Key——添加端点后即自动生效。这是 Rube MCP 网关的核心设计它把 1,000 第三方集成的鉴权、连接生命周期和工具代理集中收敛到一个标准 MCP 端点上仓库 README.md 将其称为 MCP Gateway 模式。3.2 连接激活四步流程原文档规定了严格的操作顺序建议按序执行确认 Rube MCP 可用调用RUBE_SEARCH_TOOLS确认有响应调用RUBE_MANAGE_CONNECTIONS传入工具集ambient_weather若连接状态不是ACTIVE点击返回的授权链接完成 OAuth 设置再次确认连接状态为ACTIVE然后才允许运行任何工作流。从源码结构看RUBE_MANAGE_CONNECTIONS承担的是连接生命周期管理职责它同时用于查询连接状态第 2 步和返回授权入口第 3 步是先连接、后执行这一铁律的落点。四、工具发现永远先取最新 Schema这是整个 Skill 的第一步也是最容易被忽略的一步。原文档给出了标准发现调用RUBE_SEARCH_TOOLS queries: [{use_case: Ambient Weather operations, known_fields: }] session: {generate_id: true}关键参数说明queries[].use_case用自然语言描述你要做的任务例如Ambient Weather operations也可以替换为更具体的如读取某台气象站实时数据queries[].known_fields已知字段可为空字符串session.generate_id: true首次调用时让服务端生成新的会话 ID供后续步骤复用。该调用的返回值包括四类关键信息可用工具的 slug、输入参数 Schema、推荐的执行计划以及已知陷阱known pitfalls。这意味着工具发现不仅是查名字而是把执行方案和避坑指南一并返回为后续RUBE_MULTI_EXECUTE_TOOL的参数构造提供权威依据。五、核心工作流发现 → 连接 → 执行原文档将可复用的执行模式提炼为三个步骤任何 Ambient Weather 任务拉取实时观测、历史数据、设备信息等都遵循这一模板。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Ambient Weather task}] session: {id: existing_session_id}与首次发现相比这里复用已存在的session_id表示该请求属于既有工作流的一部分。会话复用是保证工作流内状态连续的关键。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [ambient_weather] session_id: your_session_id在执行任何工具前确认ambient_weather工具集的连接状态。若返回非ACTIVE回到第三节的第 3 步完成授权后再继续。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 的搜索结果禁止凭空猜测arguments必须严格符合搜索返回的 Schema字段名、类型、必填项均以 Schema 为准memory参数必须始终携带即使为空也要传{}session_id沿用 Step 1/2 的会话。六、已知陷阱六个必须遵守的实践约束原文档的 Known Pitfalls 小节沉淀了使用该类 Skill 的六个关键教训任何一条被违反都可能导致调用失败或数据不全陷阱约束Always search first工具 Schema 会变化。未经RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数属于高危操作Check connection执行前必须通过RUBE_MANAGE_CONNECTIONS确认连接为ACTIVE状态Schema compliance必须使用搜索结果中的精确字段名与类型不能凭记忆构造参数Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须包含memory参数空则传{}Session reuse同一工作流内复用 session ID新工作流生成新的 session IDPagination检查响应中的分页令牌持续拉取直至数据完整从该 Skill 的 YAML 元数据description中的 Always search tools first for current schemas可以看出先搜索不仅是实践建议而是被写进了 Skill 触发语义的硬性要求——这也解释了为什么仓库中 600 余个 composio 自动化 Skill 都统一采用同一套发现→连接→执行模式。七、快速参考表四类核心操作一览原文档最后给出了操作速查表覆盖常规执行与进阶场景OperationApproachFind toolsRUBE_SEARCH_TOOLS配合 Ambient Weather 专属 use_caseConnectRUBE_MANAGE_CONNECTIONS传入工具集ambient_weatherExecuteRUBE_MULTI_EXECUTE_TOOL使用搜索发现的 tool slugBulk opsRUBE_REMOTE_WORKBENCH配合run_composio_tool()Full schema对带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS获取完整 Schema其中最后两行对应进阶用法批量操作时改用RUBE_REMOTE_WORKBENCH中的run_composio_tool()编程式执行当搜索返回的工具引用schemaRef时需要进一步调用RUBE_GET_TOOL_SCHEMAS拉取完整 Schema 定义。八、配套资源如何安装与使用该 Skill该 Skill 作为仓库的一部分可通过仓库自带的安装器部署到本地 Codexpython skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/ambient-weather-automation从 安装脚本源码 的实现看安装逻辑会将 skill 拷贝到$CODEX_HOME/skills/skill-name默认~/.codex/skills技能名取自路径 basename此处即ambient-weather-automation且若目标目录已存在会中止安装。安装完成后重启 Codex 加载新元数据详见 skill-installer/SKILL.md 与 README.md 中的安装指引。使用阶段只需在 Codex 会话中自然描述任务例如拉取我在 Ambient Weather 上注册的气象站的当前观测数据Codex 会根据 SKILL.md 的description自动触发本 Skill随后按第五节的三步流程执行。如需查看其他工具的自动化方式composio-skills/目录下的同类 Skill如 ambee-automation遵循完全一致的结构可对照参考。九、总结ambient-weather-automationSkill 的完整方法论可归纳为一句话让 Agent 先向网关问清楚再动手执行。通过RUBE_SEARCH_TOOLS发现、RUBE_MANAGE_CONNECTIONS连接、RUBE_MULTI_EXECUTE_TOOL执行三件套配以Schema 至上、会话复用、分页拉全的纪律即可稳定地将 Ambient Weather 的天气数据接入到 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考