awesome-codex-skills 实战:通过 Rube MCP 自动化 Stannp 营销任务的完整指南
【免费下载链接】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 中的 stannp-automation 技能,讲解如何借助 Rube MCP(Composio)这一统一 MCP 通道,在 Codex 中完成 Stannp 平台任务的工具发现、连接管理与批量执行。读完本文,你将掌握「先搜索 Schema、再核对连接、最后执行工具」的三步式自动化范式,并能直接复用到 Composio 生态下的其他数百个集成。
技能是什么:一个面向 Stannp 自动化的 Codex Skill
stannp-automation是仓库composio-skills/目录下的一个标准 Codex Skill。与仓库中其他技能(如 composio-automation、connect)一致,它遵循 Codex Skill 的统一规范:每个技能放在独立文件夹中,通过SKILL.md携带 YAML frontmatter 元数据(name+description)与逐步操作指引。Codex 依据description决定何时触发该技能,只有触发后才加载正文,从而保持上下文精简(详见 README.md)。
该技能的 frontmatter 定义了三个关键字段:
name: stannp-automation description: "Automate Stannp tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube]name:技能唯一标识,也是安装后存放的目录名;description:声明「通过 Rube MCP 自动化 Stannp 任务」,并强调关键纪律——先搜索当前工具 Schema,再执行;requires.mcp:声明该技能依赖名为rube的 MCP 服务器,这是 Codex 加载技能时做能力预检的依据。
前置条件
在运行任何工作流之前,需要满足以下三项条件:
- Rube MCP 必须已连接,且环境中存在
RUBE_SEARCH_TOOLS工具(这是判断 Rube MCP 是否可用的标志); - Stannp 连接必须处于 ACTIVE 状态,该连接通过
RUBE_MANAGE_CONNECTIONS以 toolkitstannp建立; - 每次执行前先调用
RUBE_SEARCH_TOOLS获取最新工具 Schema——这是技能反复强调的硬性要求。
环境准备:接入 Rube MCP
Rube MCP 的接入方式非常轻量:在客户端(即 Codex)的 MCP 服务器配置中直接添加端点https://rube.app/mcp即可,无需申请任何 API Key——添加端点即可生效。
接入后按以下顺序完成初始化:
- 调用
RUBE_SEARCH_TOOLS,确认 Rube MCP 已响应; - 调用
RUBE_MANAGE_CONNECTIONS,传入 toolkitstannp; - 若连接状态不是
ACTIVE,跟随返回的授权链接完成 OAuth 设置; - 在所有工作流运行前,再次确认连接状态为
ACTIVE。
从仓库视角看,该技能是 Composio 统一 MCP 接入模式的实例化:Composio 提供单一 MCP 端点承载 1000+ 集成(README 中描述为 MCP Gateway 模式),Stannp 只是其中的一个 toolkit;同一个RUBE_*工具族在 composio-automation 等技能中被完全复用,区别仅在于传入的use_case与toolkits参数。
工具发现:永远先搜 Schema
工具 Schema 是随时可能变化的,因此技能要求任何工作流的第一步都是发现工具。文档给出了标准查询模板:
RUBE_SEARCH_TOOLS queries: [{use_case: "Stannp operations", known_fields: ""}] session: {generate_id: true}该调用会返回以下四类信息:
- 可用的tool slugs(工具标识,用于后续执行);
- 各工具的input schemas(输入参数结构);
- 推荐的execution plans(执行计划);
- 已知的pitfalls(常见陷阱提示)。
在真实任务中,应将use_case替换为你的具体 Stannp 任务描述(如发送邮件、查询模板、管理收件人列表等),known_fields用于补充已知的字段名。首次发起会话时用session: {generate_id: true}让系统生成会话 ID,后续步骤复用该 ID。
核心工作流:三步自动化模式
技能把一次完整的 Stannp 自动化收敛为三个步骤,每一步都有对应的 Rube 工具。
Step 1:发现可用工具
RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Stannp task"}] session: {id: "existing_session_id"}将use_case换成具体任务描述,并复用已有会话 ID(session: {id: "existing_session_id"})。这一步产出的 tool slug 与输入 Schema 将直接用于第三步。
Step 2:核对连接状态
RUBE_MANAGE_CONNECTIONS toolkits: ["stannp"] session_id: "your_session_id"执行任何工具之前,必须确认 Stannp 的 OAuth 连接处于ACTIVE状态。若连接失效或缺失,应按返回的授权链接重新完成授权,再回到本步确认。
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 完全一致;memory参数必须始终携带,即使为空也要显式传{};session_id在同一工作流内复用。
值得说明的是,这个「搜索 → 核对连接 → 执行」的调用链在仓库全部 Composio 技能中保持一致,例如 composio-automation 的RUBE_MULTI_EXECUTE_TOOL调用结构与本技能完全相同。也就是说,掌握了这套模式,就掌握了 Rube MCP 驱动任意 Composio toolkit 的通用能力。
已知陷阱与规避清单
技能文档明确列出了六条高频陷阱,值得逐条落实:
| 陷阱 | 正确做法 |
|---|---|
| 硬编码 tool slug 或参数 | 永远先调用RUBE_SEARCH_TOOLS,因为工具 Schema 会变化,禁止未经搜索直接使用历史 slug |
| 连接状态未确认就执行 | 执行前用RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE |
| 参数与 Schema 不一致 | 严格使用搜索结果返回的精确字段名与类型 |
遗漏memory参数 | RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory,即使为空{} |
| 会话 ID 混用 | 工作流内复用同一 session ID;开启新工作流时生成新 ID |
| 忽略分页 | 检查响应中的分页 token,持续拉取直到数据完整 |
其中「先搜索再执行」是全篇最核心的纪律——它既是description字段中的明示要求,也是规避其余大部分问题的前提。
快速参考:Rube 工具一览
| 操作 | 使用方式 |
|---|---|
| 查找工具 | RUBE_SEARCH_TOOLS,传入 Stannp 相关的具体 use case |
| 建立连接 | RUBE_MANAGE_CONNECTIONS,toolkit 指定为stannp |
| 执行工具 | RUBE_MULTI_EXECUTE_TOOL,使用搜索发现到的 tool slug |
| 批量操作 | RUBE_REMOTE_WORKBENCH,配合run_composio_tool()使用 |
| 获取完整 Schema | RUBE_GET_TOOL_SCHEMAS,适用于带schemaRef的工具 |
前三个工具构成标准三步工作流;后两个是进阶能力:RUBE_REMOTE_WORKBENCH适合需要远程环境运行的批量任务,RUBE_GET_TOOL_SCHEMAS则在工具通过schemaRef引用外部 Schema 时用于获取完整定义。
将技能安装到 Codex 并使用
本技能本质是一个可被 Codex 自动加载的 Skill,安装方式与仓库其他技能一致(详见 README.md):
- 克隆仓库(若尚未拥有本地副本),或用仓库提供的 skill-installer 脚本按路径安装;
- 将
composio-skills/stannp-automation目录放入$CODEX_HOME/skills/(默认~/.codex/skills/); - 重启 Codex,使其重新加载技能元数据;
- 在新会话中直接描述 Stannp 相关任务,Codex 会根据
description自动触发该技能。
触发后,Codex 会按照上文的三步流程:先RUBE_SEARCH_TOOLS确认 Stannp 相关工具与 Schema,再核对连接,最后通过RUBE_MULTI_EXECUTE_TOOL完成实际调用。整个过程无需手工编写任何 Stannp API 请求代码。
小结
stannp-automation是 awesome-codex-skills 仓库「Skill + MCP 网关」架构的典型范例:它以极简的SKILL.md封装了完整的工具发现、连接管理和安全执行范式,并将「先搜索 Schema、核对连接、携带 memory、复用会话」等工程纪律固化成了可复用的流程。这套模式不止适用于 Stannp——仓库 composio-skills/ 目录下数百个*-automation技能全部复用同一套RUBE_*调用约定。理解了本文的三步工作流与陷阱清单,你就可以举一反三,用同一种心智模型驱动 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),仅供参考