基于 Rube MCP 与 Codex Skills 的 OneSignal REST API 自动化实战指南【免费下载链接】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/onesignal_rest_api-automation技能为骨架讲解如何借助 Rube MCPComposio 提供在 Codex 中自动发现并执行 OneSignal 推送通知、消息分段Segments、模板与消息发送等操作。读完本文你将掌握 Rube MCP 的连接建立、工具发现、工具执行、批量操作与错误恢复的完整工作流能够在 Codex CLI/API 场景中直接落地一套先搜索、再执行、后校验的 OneSignal 自动化方案。技能定位这份 SKILL.md 解决什么问题在 composio-skills/onesignal_rest_api-automation/SKILL.md 中技能声明frontmatter将其定义为一个面向 Codex 的模块化指令包name: onesignal_rest_api-automation description: Automate OneSignal tasks via Rube MCP (Composio): push notifications, segments, templates, and messaging. Always search tools first for current schemas. requires: mcp: [rube]从仓库的 README.md 可以看出 Codex Skills 的工作原理每个技能独立存放在一个目录中通过SKILL.md的元数据name description决定 Codex 何时触发该技能正文只在触发后才被加载从而保持上下文精简。本文的技能即在用户描述 OneSignal 相关任务时被 Codex 自动匹配并加载。其核心设计哲学是Always search tools first永远先搜索工具OneSignal 的 REST API 工具 schema 可能随版本变化因此不硬编码任何 tool slug而是通过 Rube MCP 的动态工具发现机制获取最新 schema 后再执行。补充说明仓库中同时存在三个相近技能——onesignal_rest_api-automation本文主体、onesignal-rest-api-automation旧版命名与 onesignal-user-auth-automation面向 OneSignal User Auth 鉴权链路。三者共享同一套 Rube MCP 工作流模式仅在 toolkit 名称上有所区别。前置条件Prerequisites根据技能文档运行 OneSignal 自动化工作流前需要满足三个条件Rube MCP 已连接确保RUBE_SEARCH_TOOLS工具可用这是后续一切操作的前提OneSignal 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 OneSignal 连接toolkit 名称为onesignal_rest_api先搜索工具任何工作流执行前必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema避免使用过期参数。其中第 3 条是贯穿全文的强制性约定原因在于 OneSignal 的 REST API 工具集是动态演进的——tool slug、输入字段、必填参数都可能调整硬编码任何 schema 信息都会导致执行失败。环境搭建接入 Rube MCP 并激活 OneSignal 连接第一步添加 Rube MCP Server技能文档给出的接入方式非常轻量在你的 MCP 客户端配置中添加https://rube.app/mcp作为 MCP server 端点即可无需预先申请 API Key——添加端点后即可直接使用。第二步建立并激活 OneSignal 连接接入完成后按以下顺序完成连接初始化验证可用性调用RUBE_SEARCH_TOOLS确认工具正常响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkit 参数传入onesignal_rest_api完成授权若返回的连接状态不是ACTIVE跟随返回的授权链接auth link在浏览器中完成 OAuth 授权确认状态在运行任何工作流之前确认连接状态为ACTIVE。连接状态是本技能执行链路中最重要的健康信号OAuth token 过期、用户手动撤销授权等情况都会导致状态从ACTIVE变为非激活后续所有工具调用都会失败。工具发现RUBE_SEARCH_TOOLS 的正确用法技能文档反复强调先搜索后执行其标准调用形态如下RUBE_SEARCH_TOOLS: queries[{use_case: push notifications, segments, templates, and messaging, known_fields: }]use_case字段用自然语言描述你要完成的任务推送通知、分段、模板、消息等known_fields用于填写你已经知道的字段名未知时留空。一次成功的搜索会返回可用的 OneSignal 工具 slug 列表tool slugs推荐执行计划recommended execution plan steps即完成该任务应依次调用哪些工具已知陷阱与边界情况known pitfalls and edge cases帮助规避常见错误每个工具的输入 schemainput schemas用于构造符合规范的参数。这一机制保证了即使 OneSignal API 发生了字段增减或语义调整Agent 也能始终拿到最新、最准确的调用契约而不会依赖过期的静态文档。核心工作流从发现工具到执行操作工作流一发现 OneSignal 可用工具RUBE_SEARCH_TOOLS: queries: - use_case: list all available OneSignal tools and capabilities在正式动手之前先审查返回的工具列表、描述与输入 schema确认哪些工具覆盖了你需要的 OneSignal 能力推送、分段、模板、消息等。工作流二执行 OneSignal 操作发现工具后通过RUBE_MULTI_EXECUTE_TOOL批量执行RUBE_MULTI_EXECUTE_TOOL: tools: - tool_slug: discovered_tool_slug arguments: {schema-compliant arguments} memory: {} sync_response_to_workbench: false注意三个关键细节tool_slug必须来自RUBE_SEARCH_TOOLS的发现结果严禁硬编码arguments必须严格符合返回的 schema字段名、类型、必填项均需一致memory参数必须始终携带即使为空也要传{}该要求在 onesignal-rest-api-automation 的 Pitfalls 中被单独强调。工作流三多步骤复合工作流复杂场景往往需要串联多个 OneSignal 操作技能文档给出如下编排建议使用具体 use case 调用RUBE_SEARCH_TOOLS搜索所有相关工具先执行前置步骤例如先查询后更新——fetch 在前update 在后在步骤间传递数据将上一步工具响应中的数据作为下一步的输入参数对于批量操作或数据处理改用RUBE_REMOTE_WORKBENCH承载。这种数据在工具间流动的编排方式使 Agent 可以完成诸如拉取全部订阅者 → 按条件筛选 → 创建分段 → 向分段发送推送模板这类端到端营销自动化链路。通用模式与最佳实践先查后建Search Before Action创建新资源如新分段、新模板之前务必先搜索是否已存在相同或类似的资源避免产生重复数据。分页处理PaginationOneSignal 的多数列表类操作支持分页。处理响应时检查next_cursor或page_token字段若存在则持续拉取直至返回为空确保拿到完整数据集而不是只处理第一页。错误处理Error Handling技能文档给出了标准的三步恢复策略每步执行后先检查工具响应中的错误信息再决定是否继续若工具调用失败先确认 OneSignal 连接是否仍为ACTIVE若连接已过期OAuth token 失效通过RUBE_MANAGE_CONNECTIONS重新认证后再继续。批量并行执行Batch Operations对于大批量操作使用RUBE_REMOTE_WORKBENCH在远端工作台中执行将run_composio_tool()放入循环并用ThreadPoolExecutor实现并行调用从而显著缩短大批量发送或大量记录更新的总耗时。这一模式在仓库内大量 composio-skills 中被统一采用如 anthropic_administrator-automation、capsule_crm-automation 等属于 Rube MCP 技能族的通用批量实践。已知陷阱清单Known Pitfalls技能文档明确列出的陷阱与规避方式是实战中最值得反复对照的部分陷阱规避方式硬编码工具 slug工具 schema 与可用操作随时可能变化任何 slug 都必须先经RUBE_SEARCH_TOOLS发现确认忽略连接状态执行工具前确保 OneSignal 连接为ACTIVEOAuth token 过期需重新认证触发限流收到 rate limit 错误时降低请求频率并实现退避backoff策略参数不符合 schema始终传严格符合 schema 的参数当返回的是schemaRef而非input_schema时用RUBE_GET_TOOL_SCHEMAS加载完整输入 schema遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL的每次调用都必须携带memory即使为空对象会话不管理同一工作流内复用 session ID开启新工作流时再生成新 ID忽略分页检查响应中的分页 token持续获取直到数据取完快速参考表Quick Reference操作使用方式查找工具RUBE_SEARCH_TOOLS OneSignal 相关 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为onesignal_rest_api执行操作RUBE_MULTI_EXECUTE_TOOL 发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于返回schemaRef的工具这张表浓缩了整份 SKILL.md 的操作核心发现 → 连接 → 执行 → 批量化 → 按需补全 schema是 Agent 在实际会话中应优先遵循的执行序。如何将本技能安装进 Codex本技能是仓库 README.md 中众多可安装技能之一。安装方式有两种推荐技能安装器Skill Installer——克隆仓库后运行git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/onesignal_rest_api-automation安装脚本会将技能放置到$CODEX_HOME/skills/skill-name默认~/.codex/skills重启 Codex 后即可加载新技能元数据。手动安装将 composio-skills/onesignal_rest_api-automation 目录整体复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex。后续会话中自然描述 OneSignal 相关任务时Codex 会依据技能description元数据自动触发匹配。安装完成后即可按上文流程接入 Rube MCP → 激活 OneSignal 连接 → 搜索工具 → 执行推送/分段/模板/消息操作实现 OneSignal 营销触达链路在 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 基于 Rube MCP 与 Codex Skills 的 OneSignal REST API 自动化实战指南
基于 Rube MCP 与 Codex Skills 的 OneSignal REST API 自动化实战指南【免费下载链接】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/onesignal_rest_api-automation技能为骨架讲解如何借助 Rube MCPComposio 提供在 Codex 中自动发现并执行 OneSignal 推送通知、消息分段Segments、模板与消息发送等操作。读完本文你将掌握 Rube MCP 的连接建立、工具发现、工具执行、批量操作与错误恢复的完整工作流能够在 Codex CLI/API 场景中直接落地一套先搜索、再执行、后校验的 OneSignal 自动化方案。技能定位这份 SKILL.md 解决什么问题在 composio-skills/onesignal_rest_api-automation/SKILL.md 中技能声明frontmatter将其定义为一个面向 Codex 的模块化指令包name: onesignal_rest_api-automation description: Automate OneSignal tasks via Rube MCP (Composio): push notifications, segments, templates, and messaging. Always search tools first for current schemas. requires: mcp: [rube]从仓库的 README.md 可以看出 Codex Skills 的工作原理每个技能独立存放在一个目录中通过SKILL.md的元数据name description决定 Codex 何时触发该技能正文只在触发后才被加载从而保持上下文精简。本文的技能即在用户描述 OneSignal 相关任务时被 Codex 自动匹配并加载。其核心设计哲学是Always search tools first永远先搜索工具OneSignal 的 REST API 工具 schema 可能随版本变化因此不硬编码任何 tool slug而是通过 Rube MCP 的动态工具发现机制获取最新 schema 后再执行。补充说明仓库中同时存在三个相近技能——onesignal_rest_api-automation本文主体、onesignal-rest-api-automation旧版命名与 onesignal-user-auth-automation面向 OneSignal User Auth 鉴权链路。三者共享同一套 Rube MCP 工作流模式仅在 toolkit 名称上有所区别。前置条件Prerequisites根据技能文档运行 OneSignal 自动化工作流前需要满足三个条件Rube MCP 已连接确保RUBE_SEARCH_TOOLS工具可用这是后续一切操作的前提OneSignal 连接已激活通过RUBE_MANAGE_CONNECTIONS建立 OneSignal 连接toolkit 名称为onesignal_rest_api先搜索工具任何工作流执行前必须先调用RUBE_SEARCH_TOOLS获取当前工具 schema避免使用过期参数。其中第 3 条是贯穿全文的强制性约定原因在于 OneSignal 的 REST API 工具集是动态演进的——tool slug、输入字段、必填参数都可能调整硬编码任何 schema 信息都会导致执行失败。环境搭建接入 Rube MCP 并激活 OneSignal 连接第一步添加 Rube MCP Server技能文档给出的接入方式非常轻量在你的 MCP 客户端配置中添加https://rube.app/mcp作为 MCP server 端点即可无需预先申请 API Key——添加端点后即可直接使用。第二步建立并激活 OneSignal 连接接入完成后按以下顺序完成连接初始化验证可用性调用RUBE_SEARCH_TOOLS确认工具正常响应发起连接调用RUBE_MANAGE_CONNECTIONStoolkit 参数传入onesignal_rest_api完成授权若返回的连接状态不是ACTIVE跟随返回的授权链接auth link在浏览器中完成 OAuth 授权确认状态在运行任何工作流之前确认连接状态为ACTIVE。连接状态是本技能执行链路中最重要的健康信号OAuth token 过期、用户手动撤销授权等情况都会导致状态从ACTIVE变为非激活后续所有工具调用都会失败。工具发现RUBE_SEARCH_TOOLS 的正确用法技能文档反复强调先搜索后执行其标准调用形态如下RUBE_SEARCH_TOOLS: queries[{use_case: push notifications, segments, templates, and messaging, known_fields: }]use_case字段用自然语言描述你要完成的任务推送通知、分段、模板、消息等known_fields用于填写你已经知道的字段名未知时留空。一次成功的搜索会返回可用的 OneSignal 工具 slug 列表tool slugs推荐执行计划recommended execution plan steps即完成该任务应依次调用哪些工具已知陷阱与边界情况known pitfalls and edge cases帮助规避常见错误每个工具的输入 schemainput schemas用于构造符合规范的参数。这一机制保证了即使 OneSignal API 发生了字段增减或语义调整Agent 也能始终拿到最新、最准确的调用契约而不会依赖过期的静态文档。核心工作流从发现工具到执行操作工作流一发现 OneSignal 可用工具RUBE_SEARCH_TOOLS: queries: - use_case: list all available OneSignal tools and capabilities在正式动手之前先审查返回的工具列表、描述与输入 schema确认哪些工具覆盖了你需要的 OneSignal 能力推送、分段、模板、消息等。工作流二执行 OneSignal 操作发现工具后通过RUBE_MULTI_EXECUTE_TOOL批量执行RUBE_MULTI_EXECUTE_TOOL: tools: - tool_slug: discovered_tool_slug arguments: {schema-compliant arguments} memory: {} sync_response_to_workbench: false注意三个关键细节tool_slug必须来自RUBE_SEARCH_TOOLS的发现结果严禁硬编码arguments必须严格符合返回的 schema字段名、类型、必填项均需一致memory参数必须始终携带即使为空也要传{}该要求在 onesignal-rest-api-automation 的 Pitfalls 中被单独强调。工作流三多步骤复合工作流复杂场景往往需要串联多个 OneSignal 操作技能文档给出如下编排建议使用具体 use case 调用RUBE_SEARCH_TOOLS搜索所有相关工具先执行前置步骤例如先查询后更新——fetch 在前update 在后在步骤间传递数据将上一步工具响应中的数据作为下一步的输入参数对于批量操作或数据处理改用RUBE_REMOTE_WORKBENCH承载。这种数据在工具间流动的编排方式使 Agent 可以完成诸如拉取全部订阅者 → 按条件筛选 → 创建分段 → 向分段发送推送模板这类端到端营销自动化链路。通用模式与最佳实践先查后建Search Before Action创建新资源如新分段、新模板之前务必先搜索是否已存在相同或类似的资源避免产生重复数据。分页处理PaginationOneSignal 的多数列表类操作支持分页。处理响应时检查next_cursor或page_token字段若存在则持续拉取直至返回为空确保拿到完整数据集而不是只处理第一页。错误处理Error Handling技能文档给出了标准的三步恢复策略每步执行后先检查工具响应中的错误信息再决定是否继续若工具调用失败先确认 OneSignal 连接是否仍为ACTIVE若连接已过期OAuth token 失效通过RUBE_MANAGE_CONNECTIONS重新认证后再继续。批量并行执行Batch Operations对于大批量操作使用RUBE_REMOTE_WORKBENCH在远端工作台中执行将run_composio_tool()放入循环并用ThreadPoolExecutor实现并行调用从而显著缩短大批量发送或大量记录更新的总耗时。这一模式在仓库内大量 composio-skills 中被统一采用如 anthropic_administrator-automation、capsule_crm-automation 等属于 Rube MCP 技能族的通用批量实践。已知陷阱清单Known Pitfalls技能文档明确列出的陷阱与规避方式是实战中最值得反复对照的部分陷阱规避方式硬编码工具 slug工具 schema 与可用操作随时可能变化任何 slug 都必须先经RUBE_SEARCH_TOOLS发现确认忽略连接状态执行工具前确保 OneSignal 连接为ACTIVEOAuth token 过期需重新认证触发限流收到 rate limit 错误时降低请求频率并实现退避backoff策略参数不符合 schema始终传严格符合 schema 的参数当返回的是schemaRef而非input_schema时用RUBE_GET_TOOL_SCHEMAS加载完整输入 schema遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL的每次调用都必须携带memory即使为空对象会话不管理同一工作流内复用 session ID开启新工作流时再生成新 ID忽略分页检查响应中的分页 token持续获取直到数据取完快速参考表Quick Reference操作使用方式查找工具RUBE_SEARCH_TOOLS OneSignal 相关 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为onesignal_rest_api执行操作RUBE_MULTI_EXECUTE_TOOL 发现的 tool slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于返回schemaRef的工具这张表浓缩了整份 SKILL.md 的操作核心发现 → 连接 → 执行 → 批量化 → 按需补全 schema是 Agent 在实际会话中应优先遵循的执行序。如何将本技能安装进 Codex本技能是仓库 README.md 中众多可安装技能之一。安装方式有两种推荐技能安装器Skill Installer——克隆仓库后运行git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/onesignal_rest_api-automation安装脚本会将技能放置到$CODEX_HOME/skills/skill-name默认~/.codex/skills重启 Codex 后即可加载新技能元数据。手动安装将 composio-skills/onesignal_rest_api-automation 目录整体复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex。后续会话中自然描述 OneSignal 相关任务时Codex 会依据技能description元数据自动触发匹配。安装完成后即可按上文流程接入 Rube MCP → 激活 OneSignal 连接 → 搜索工具 → 执行推送/分段/模板/消息操作实现 OneSignal 营销触达链路在 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考