ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

使用 awesome-codex-skills 中的 Msg91 技能通过 Rube MCP 自动化短信与通信工作流

使用 awesome-codex-skills 中的 Msg91 技能通过 Rube MCP 自动化短信与通信工作流 使用 awesome-codex-skills 中的 Msg91 技能通过 Rube MCP 自动化短信与通信工作流【免费下载链接】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/msg91-automation/SKILL.md 这份 Codex 技能文档展开系统讲解如何在 Codex CLI/API 环境中通过 Composio 的 Msg91 工具集与 Rube MCP 网关完成短信服务SMS与通信类任务的自动化。读完本文你将掌握 Rube MCP 的连接与鉴权、工具 schema 的实时发现、标准三步执行工作流以及分页、会话复用等实战要点能够在自己的 Codex 会话中直接落地一套可复用的 Msg91 自动化方案。技能是什么msg91-automation 的定位与元数据在 Codex Skills 体系中每个技能都是一个包含SKILL.md的独立目录通过 YAML frontmatter 声明元数据Codex 依据description决定何时触发该技能。本仓库 README.md 对此有明确说明Codex 读取元数据判断触发时机只有在技能被触发后才加载正文从而保持上下文精简。msg91-automation技能的 frontmatter 位于 composio-skills/msg91-automation/SKILL.md 开头包含三个关键字段--- name: msg91-automation description: Automate Msg91 tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---name技能唯一标识即安装后出现在$CODEX_HOME/skills/下的目录名msg91-automationdescription声明技能的触发场景——通过 Rube MCPComposio自动化 Msg91 任务务必先搜索工具以获取当前 schema。这段描述是 Codex 匹配用户请求与技能的关键因此写作时要求覆盖做什么、何时用两个维度requires.mcp声明本技能依赖rube这个 MCP 服务器即https://rube.app/mcp提供的统一 MCP 端点。这一字段让 Codex 在触发技能前就知道必须加载对应 MCP 工具。Msg91 是面向开发者的短信与通信 API 服务本技能并不直接封装 Msg91 的 HTTP 接口而是借助 Composio 的 Msg91 toolkit 作为中间层由 Rube MCP 统一代理执行。这种技能编排 MCP 网关 第三方 toolkit的架构与本仓库composio-skills/目录下上百个自动化技能如composio-automation、openai-automation等保持一致全部复用同一套 Rube MCP 交互协议。前置条件三件事缺一不可技能文档明确列出运行本技能前必须满足的前置条件Rube MCP 已连接客户端必须能正常调用RUBE_SEARCH_TOOLS工具这是验证 Rube MCP 是否可用的标志Msg91 连接处于 ACTIVE 状态需要通过RUBE_MANAGE_CONNECTIONS建立并确认 Msg91 账号连接先搜索工具再动手任何时候都先调用RUBE_SEARCH_TOOLS获取当前工具 schema这是贯穿全文的黄金法则。之所以强调先搜索是因为 Rube MCP 暴露的工具 schema 会随上游 toolkit 的更新而变化。技能文档明确警告永远不要硬编码工具 slug 或参数。这一设计思路在 composio-skills/composio-automation/SKILL.md 等同类技能中完全一致属于整个composio-skills/系列共同遵循的协议规范。环境准备接入 Rube MCP 并建立 Msg91 连接添加 Rube MCP 服务器本技能的最大便利在于接入 Rube MCP 不需要任何 API key。只需在 Codex 的 MCP 配置中把https://rube.app/mcp添加为 MCP 服务器端点即可生效。这在文档中被称为 Get Rube MCP 步骤。建立 Msg91 连接的四个步骤文档给出的 Setup 流程如下验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS有响应证明 MCP 通道已打通发起连接调用RUBE_MANAGE_CONNECTIONS指定 toolkit 为msg91完成鉴权如果连接状态不是 ACTIVE跟随返回的 auth 链接完成账号授权通常为 OAuth 或 API key 绑定流程确认状态在任何工作流运行前确认连接状态已变为 ACTIVE。其中第 3 步是关键交互点——RUBE_MANAGE_CONNECTIONS会返回一个授权链接Agent 需要将该链接交给用户完成人工授权授权完成后连接即生效。这属于Agent 编排 人工鉴权的混合模式确保第三方账号凭据不经过 Agent 上下文。工具发现RUBE_SEARCH_TOOLS 的正确用法Rube MCP 采用搜索优先的协议设计。在任何执行动作之前必须先发现当前可用的工具及其输入 schema。技能文档给出的标准发现请求如下RUBE_SEARCH_TOOLS queries: [{use_case: Msg91 operations, known_fields: }] session: {generate_id: true}请求参数解析queries数组类型每项包含use_case描述你要完成的具体任务如发送短信、查询发送记录等与known_fields你已知的字段名没有则为空字符串。use_case写得越具体返回的工具匹配越精准session包含generate_id: true时由服务端生成新会话 ID在后续请求中复用同一session.id可保持工作流上下文连续。该调用的返回内容包括四类信息可用工具 slug、工具输入 schema、推荐的执行计划、已知陷阱known pitfalls。也就是说搜索不仅是找工具还会直接给出编排建议Agent 应优先采纳返回的执行计划。核心工作流发现 → 检查连接 → 执行技能文档将完整的自动化流程抽象为三步固定模式适用于任何 Msg91 业务场景。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Msg91 task}] session: {id: existing_session_id}与首次发现相比此处在工作流内部使用session.id引用既有会话而非再次生成新 ID——这是会话复用的第一步。把use_case替换为你当前的具体任务描述即可。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [msg91] session_id: your_session_id执行工具前必须确认连接仍处于 ACTIVE。注意这里参数是toolkits复数数组与session_id与发现阶段的参数名不同。若状态异常需回到 Setup 流程重新走授权链接。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执行调用包含三个要素tools数组可一次传入多个工具调用。每项由tool_slug必须取自搜索返回结果严禁手写与arguments必须严格符合搜索返回的 schema字段名与类型一字不差组成memory必须始终携带即使没有上下文也要传空对象{}否则调用可能失败session_id沿用工作流内的既有会话 ID。文档特别强调RUBE_MULTI_EXECUTE_TOOL是标准执行入口支持一次请求批量执行多个工具适合发送短信后再查询状态等复合流程。已知陷阱六条实战避坑指南技能文档总结了六条经过沉淀的实践约束每条都对应一类真实失败场景永远先搜索工具 schema 会变化。没有先调用RUBE_SEARCH_TOOLS就硬编码 slug 或参数是最大的失败来源执行前检查连接确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 再执行工具避免在鉴权过期状态下发起无效调用严格遵循 schema参数必须使用搜索结果中的精确字段名与类型多一个、少一个、类型不符都会导致执行失败memory 参数必带RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory即便为空也要传{}会话复用策略同一工作流内复用会话 ID保证上下文连续新工作流才生成新 ID处理分页检查响应中的分页 tokenpagination tokens持续翻页直到数据取完——尤其是发送记录、通讯录等列表类数据只取第一页会遗漏后续结果。快速参考四种操作入口速查表技能文档以表格形式给出不同操作对应的入口是日常使用时的命令速查卡OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Msg91-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitmsg91ExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef对表格的补充解读批量操作当需要循环执行大量相同操作如向多个收件人发送短信时优先使用RUBE_REMOTE_WORKBENCH结合run_composio_tool()在远端工作区执行而不是在本地逐条调用可显著降低往返开销完整 schema当搜索结果中某些工具带有schemaRef引用时用RUBE_GET_TOOL_SCHEMAS拉取完整定义适用于参数结构复杂的工具发现与执行分离RUBE_SEARCH_TOOLS负责找RUBE_MULTI_EXECUTE_TOOL负责做两者通过搜索返回的tool_slug衔接构成完整闭环。在仓库中安装与使用本技能本仓库 README.md 提供了两种把技能装进 Codex 的方式msg91-automation同样适用方式一使用技能安装器推荐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/msg91-automation安装脚本会把技能目录放入$CODEX_HOME/skills/msg91-automation默认~/.codex/skills。该脚本默认对公开仓库走直接下载失败时回退到 git sparse checkout且目标目录已存在时会中止详见 skill-installer/SKILL.md。方式二手动安装将composio-skills/msg91-automation/目录复制到$CODEX_HOME/skills/重启 Codex 使其加载新的元数据在会话中用自然语言描述任务如通过 Msg91 发送短信并确认发送状态Codex 会根据 frontmatter 中的description自动触发该技能。安装完成后会话内即可按本文第三节到第七节所述的流程添加 Rube MCP → 建立 Msg91 连接 → 搜索工具 → 执行三步工作流。协议一致性与 composio-skills 系列技能的对比印证为了理解本技能的设计并非孤例可以横向对比同仓库的其他技能文档composio-skills/composio-automation/SKILL.md 用于自动化 Composio 自身操作其前置条件、Setup 四步、工具发现、三步工作流与陷阱清单与本技能几乎逐字对应只是 toolkit 从msg91换为composiocomposio-skills/openai-automation/SKILL.md 则展示了同一 Rube MCP 协议下工具级的另一种写法直接以OPENAI_CREATE_RESPONSE等具体工具 slug 组织工作流并附详细的参数表与陷阱表。对比可见msg91-automation属于协议级技能——它不预设具体工具 slug而是把先搜索、再执行的方法论固化下来对上游 Msg91 toolkit 的工具变动具有天然适应性。这也解释了文档中反复强调Always search tools first的根本原因技能文档本身不硬编码工具真正的工具契约由 Rube MCP 实时下发。对读者而言这意味着即使 Msg91 工具集后续新增或调整工具本技能的工作流框架依然有效只需重新执行RUBE_SEARCH_TOOLS即可适配。总结以 composio-skills/msg91-automation/SKILL.md 为核心的 Msg91 自动化技能提供了一条零 API key 接入、搜索驱动、schema 实时适配的短信与通信自动化路径。其核心方法论可概括为四句话先搜索拿 schema再检查连接状态用会话串起工作流执行时必带 memory 并处理分页。这套模式不仅适用于 Msg91也完整复用于本仓库composio-skills/目录下的上百个自动化技能是理解整个 Composio Rube MCP 技能生态的一把通用钥匙。【免费下载链接】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),仅供参考
返回列表