通过 Rube MCP 网关自动化 Echtpost：awesome-codex-skills 中 echtpost-automation 技能实战指南
通过 Rube MCP 网关自动化 Echtpostawesome-codex-skills 中 echtpost-automation 技能实战指南【免费下载链接】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本文基于仓库内的 echtpost-automation 技能定义讲解如何在 Codex 环境下通过 Composio 的 Rube MCP 网关对接 Echtpost 服务从 MCP 端点接入、工具发现到连接鉴权校验与批量工具执行的完整工作流。读完本文你将掌握该类 Composio 自动化技能的标准化三步执行模式发现 → 校验 → 执行、会话session复用规则以及文档中列出的全部易错点。技能定位一个基于 Rube MCP 的第三方服务适配器echtpost-automation是 awesome-codex-skills 仓库中composio-skills/目录下的一个标准 Codex 技能Skill。它的职责是让 Agent 不用手写 Echtpost 的 API 调用代码而是通过 Composio 的 Rube MCP 端点以搜索工具 → 校验连接 → 执行工具的统一模式完成 Echtpost 相关操作。技能的完整定义集中在 SKILL.md 一个文件中符合本仓库 README 中说明的技能布局规范每个技能是一个独立文件夹必须包含带 YAML frontmatter 的SKILL.md。该文件的 frontmatter 为name: echtpost-automation description: Automate Echtpost tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube]三个字段各有含义可以直接对照仓库其他技能理解name技能标识安装到$CODEX_HOME/skills/skill-name后即作为目录名descriptionCodex 依据该描述判断何时触发技能。本技能特意把Always search tools first for current schemas始终先搜索工具获取最新 schema写进了描述这是后续所有工作流的总原则requires.mcp: [rube]声明该技能依赖名为rube的 MCP 服务器未接入 Rube MCP 时技能不具备执行能力。需要说明的是本仓库是技能目录而非运行时Echtpost 的具体工具清单、鉴权与参数校验都由 Composio 平台侧Rube MCP 网关完成仓库内只提供技能指令本身。技能在仓库中的位置与安装方式echtpost-automation位于composio-skills/集合中。从源码结构看该目录下按字母序组织了数百个toolkit-automation技能每个技能目录结构与 echtpost-automation 相同单个SKILL.md例如同模式的 composio-automation 技能。composio-skills/下还带有 .claude-plugin/marketplace.json其中声明了以ComposioHQ为 owner 的插件市场清单说明这批技能同时作为可分发的插件市场内容维护。安装该技能有两条路径均以 README 的 Quickstart 为准方式一使用仓库自带安装脚本推荐git clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # 安装单个技能到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo ComposioHQ/awesome-codex-skills --path composio-skills/echtpost-automation安装脚本位于 skill-installer/scripts/install-skill-from-github.py会将技能放入$CODEX_HOME/skills/skill-name安装后需重启 Codex 使其加载新技能元数据。方式二手动安装将composio-skills/echtpost-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 加载元数据在会话中自然描述任务如帮我查一下 Echtpost 上的…或直接点名技能Codex 会根据description自动触发。验证安装可用ls ~/.codex/skills查看目录并用head ~/.codex/skills/echtpost-automation/SKILL.md检查 frontmatter。前置条件技能文档在 Prerequisites 一节明确列出三项前提缺一即无法工作Rube MCP 已接入客户端必须能调用RUBE_SEARCH_TOOLS工具否则技能无从发现 Echtpost 工具Echtpost 连接处于活跃状态需通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为echtpost的连接且状态为 ACTIVE始终先搜索工具每次执行前调用RUBE_SEARCH_TOOLS获取当前工具 schema而不是凭记忆写死工具名和参数。Setup接入 Rube MCP 端点Rube MCP 的接入方式在文档 Setup 一节给出在客户端的 MCP 服务器配置中添加https://rube.app/mcp这一个端点即可无需预配置 API key——文档原文强调No API keys needed — just add the endpoint and it works鉴权动作被推迟到连接管理步骤中通过 OAuth 链接完成。接入后的验证步骤共四步确认 Rube MCP 可用向客户端发起一次RUBE_SEARCH_TOOLS调用能正常响应即代表端点已连通调用RUBE_MANAGE_CONNECTIONS参数指定 toolkit 为echtpost若返回的连接状态不是 ACTIVE按响应中给出的 auth link 完成授权通常是浏览器 OAuth 流程再次确认连接状态显示为 ACTIVE 后才开始运行任何工作流。第四步是硬性门禁文档在 Known Pitfalls 中再次强调VerifyRUBE_MANAGE_CONNECTIONSshows ACTIVE status before executing tools跳过它会导致执行阶段直接报连接类错误。工具发现RUBE_SEARCH_TOOLS在执行任何 Echtpost 操作之前必须先做工具发现。文档给出的标准调用形态是RUBE_SEARCH_TOOLS queries: [{use_case: Echtpost operations, known_fields: }] session: {generate_id: true}参数要点queries是查询列表use_case描述具体用途这里用通用的 Echtpost operations 做首轮发现实际任务中可替换为更具体的描述known_fields用于声明已知字段首轮可为空字符串session.generate_id: true表示让网关生成一个新的会话 ID。这个 ID 要在后续同一工作流的每次调用中复用见下文 Step 2/3 的session_id参数。调用返回内容包含四部分可用的工具 slug、输入 schema、推荐执行计划以及已知陷阱known pitfalls。文档明确说Always discover available tools before executing workflows即工具发现不是可选优化而是流程起点——因为工具 schema 会随平台演进变化。核心工作流发现 → 校验 → 执行三步模式文档的 Core Workflow Pattern 一节把完整流程拆成三步以下按原文顺序完整保留各步调用形态。Step 1: 发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Echtpost task}] session: {id: existing_session_id}注意与首轮发现的差异此处use_case应写你的具体任务例如某个 Echtpost 场景并且session从generate_id: true变为id: existing_session_id——复用 Step 0初始发现或上一步生成的会话 ID保证同一工作流内的上下文连续。Step 2: 校验连接状态RUBE_MANAGE_CONNECTIONS toolkits: [echtpost] session_id: your_session_idtoolkits以数组形式指定要检查的 toolkit这里是echtpostsession_id继续复用同一会话。返回状态为 ACTIVE 才允许进入下一步否则回到 Setup 一节第 3 步走 auth link 授权。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必须来自 Step 1 搜索结果中返回的 slug不可手写臆造arguments必须严格符合 Step 1 返回的输入 schema——字段名和类型都要与搜索结果完全一致Known Pitfalls 中单列的 Schema compliance 条目即针对此点memory参数必须出现即使没有内容也要传空对象{}这是文档明确写出的强制要求session_id继续复用工作流内同一个 ID。批量与深层 schema 的两个扩展通道Quick Reference 表还列出两条进阶通道批量操作使用RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数适合一次编排多步 Echtpost 调用的脚本化场景完整 schema当搜索结果中某工具带有schemaRef标记时说明该工具的完整 schema 未内联在搜索结果里需改用RUBE_GET_TOOL_SCHEMAS拉取完整定义后再构造arguments。已知陷阱文档列出的六条硬性规则Known Pitfalls 一节是这份技能文档中最具实战价值的部分六条规则全部继承如下建议在自动化脚本或 Agent 提示词中作为检查清单使用#陷阱规则1先搜索工具 schema 会变。调用RUBE_SEARCH_TOOLS之前绝不硬编码工具 slug 或参数2查连接执行工具前确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 状态3schema 合规使用搜索结果中完全一致的字段名与类型4memory 参数RUBE_MULTI_EXECUTE_TOOL调用必须包含memory哪怕只是空{}5会话复用同一工作流内复用 session ID开启新工作流时生成新 ID6分页检查响应中的分页 token持续拉取直到数据完整第 6 条分页尤其容易被忽视列表类 Echtpost 操作若返回分页 token 而客户端只取第一页会把不完整数据当成全量处理。快速参考表文档末尾的 Quick Reference 给出了五类操作到工具映射可直接作为日常速查操作方法找工具RUBE_SEARCH_TOOLS带上 Echtpost 相关 use case连接/校验RUBE_MANAGE_CONNECTIONStoolkit 为echtpost执行RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()完整 schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS适用边界与同类技能对照几点适用前提需要向读者说明该技能不携带 Echtpost 的具体工具清单——工具 slug 与 schema 一律以运行时RUBE_SEARCH_TOOLS的返回为准这也正是技能描述中Always search tools first的设计意图技能依赖外部端点https://rube.app/mcpComposio 的 Rube MCP 网关网关不可达或 Echtpost 连接未 ACTIVE 时技能流程在 Step 2 就会中断Echtpost 的完整工具文档在 Composio 平台的 toolkit 页composio.dev/toolkits/echtpost维护仓库内的 SKILL.md 只承担操作模式说明的角色。从仓库横向对照看composio-skills/下所有toolkit-automation技能如 composio-automation共享同一套骨架唯一差异是 frontmatter 中的 toolkit 名称与搜索 use case。因此本文总结的接入 Rube 端点 → 生成会话 → 搜索工具 → 校验连接 → 按 schema 执行流程可以平移到其他任何 toolkit 技能而composio-skills/.claude-plugin/marketplace.json的存在则说明这批技能还支持以插件市场形式分发。对于只需要单一服务的团队直接安装对应的单个技能目录而非整个 800 技能集合即可保持$CODEX_HOME/skills下的上下文精简——这也与 README 中避免在技能内堆放多余文档以保持上下文精简的最佳实践一致。【免费下载链接】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），仅供参考