在 awesome-codex-skills 中实现 Coinranking 自动化coinranking-automation 技能与 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本篇指南围绕 coinranking-automation 技能定义文件 展开讲解如何将该 Codex 技能接入工作流通过 Rube MCPComposio完成 Coinranking 工具发现、连接管理与工具执行。读完后你将掌握该技能的完整三步工作模式、六个关键坑位规避策略以及技能的安装与验证方法。技能定位一个只教 Codex “怎么调 MCP” 的指令包在 awesome-codex-skills 仓库中技能skill是存放在独立目录下的模块化指令包每个技能目录内有一份SKILL.md包含name与description组成的 YAML frontmatter 元数据以及分步执行指南。Codex 读取元数据来决定何时触发技能只有触发后才加载正文从而保持上下文精简见 README.md 的 “What Are Codex Skills?” 一节。coinranking-automation 技能正是这一机制的实例其 frontmatter 如下--- name: coinranking-automation description: Automate Coinranking tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从这三段元数据可以读出三个设计要点name技能标识与目录名 coinranking-automation 保持一致安装后位于$CODEX_HOME/skills/coinranking-automation。description面向触发匹配的描述且明确写入 “Always search tools first for current schemas”——即把“先搜索工具再执行”这一约束直接编码进触发语义里。requires: mcp: [rube]声明该技能依赖 Rube MCP 服务器。从仓库结构看整个 composio-skills 目录下的同类技能如 coinbase-automation、composio-search-automation都使用同样的requires约定说明这一套自动化技能共享同一套 Rube MCP 接入前提。技能本身不携带 API Key 或可执行脚本——它是一份“操作手册”告诉 Agent 依次调用哪些 Rube MCP 工具、以什么参数结构调用、以及需要规避哪些坑。前置条件Rube MCP 连接与 Coinranking 授权文档 “Prerequisites” 一节列出了三条硬性前提缺一则工作流无法继续Rube MCP 已连接RUBE_SEARCH_TOOLS工具可用并能响应存在活跃的 Coinranking 连接通过RUBE_MANAGE_CONNECTIONS管理toolkit 指定为coinranking每次执行前先调用RUBE_SEARCH_TOOLS以获取当前最新的工具 schema而不是凭记忆硬编码参数。接入 Rube MCP 端点文档 “Setup” 一节给出的接入方式非常直接在客户端Codex的 MCP 服务器配置中添加端点https://rube.app/mcp无需额外 API Key——添加端点即可工作。随后按文档给出的四步完成初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONStoolkit 传coinranking若连接状态不是 ACTIVE按返回的 auth link 完成授权设置再次确认连接状态显示为 ACTIVE之后才允许运行任何工作流。从仓库中同类技能的写法看例如 coinbase-automation/SKILL.md 中 “ensure an active connection exists … If no connection is active, initiate one viaRUBE_MANAGE_CONNECTIONS”这个“先验连接、再执工具”的顺序是整个 composio-skills 体系的通用纪律而非 coinranking 独有的要求。工具发现RUBE_SEARCH_TOOLS 的调用格式文档 “Tool Discovery” 一节给出了标准调用格式RUBE_SEARCH_TOOLS queries: [{use_case: Coinranking operations, known_fields: }] session: {generate_id: true}该调用的输入与返回要点queries以use_case描述具体意图known_fields留空表示不预设字段知识session.generate_id: true由 Rube 侧生成新的会话 ID后续步骤会复用它返回值可用工具的 slug标识符、输入 schema、推荐执行计划execution plans以及已知坑位known pitfalls。这一步的意义在于工具 schema 会变化搜索结果是参数结构的唯一可信来源。文档甚至在 “Known Pitfalls” 中将其列为第一条铁律——“Never hardcode tool slugs or arguments without callingRUBE_SEARCH_TOOLS”。核心工作流三步完成一次 Coinranking 自动化文档 “Core Workflow Pattern” 将完整流程拆为三个步骤以下完整继承并逐步说明。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Coinranking task}] session: {id: existing_session_id}与初始化阶段的调用相比此步的use_case应替换为具体的业务任务描述例如查询币种排名、获取市场数据等且session使用已存在的会话 ID 而非重新生成——这是文档 “Session reuse” 坑位要求的具体体现同一工作流内复用会话 ID新工作流再生成新 ID。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [coinranking] session_id: your_session_id在执行任何工具前再次确认coinrankingtoolkit 的连接处于 ACTIVE 状态。虽然初始化阶段已验证过一次但工作流执行前复检是文档 “Check connection” 坑位的明确要求。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 搜索结果形如TOOL_SLUG_FROM_SEARCH的占位符强调“以搜索结果为唯一来源”arguments必须与搜索结果中的 schema 完全一致——字段名与类型都要精确匹配“Schema compliance” 坑位memory必须包含该参数即使为空也需传{}“Memory parameter” 坑位session_id复用当前工作流的会话 ID“Session reuse” 坑位。进阶能力批量操作与完整 schema 获取文档 “Quick Reference” 表格在三个基础操作之外还提供了两条进阶路径操作方式查找工具RUBE_SEARCH_TOOLS传入 Coinranking 专属 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定coinranking执行工具RUBE_MULTI_EXECUTE_TOOL传入发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于携带schemaRef的工具两条进阶路径的适用场景RUBE_REMOTE_WORKBENCHrun_composio_tool()当一次任务需要串联多个 Coinranking 工具调用批量操作时可用远程工作台统一编排而不是逐次单独调用RUBE_MULTI_EXECUTE_TOOL。RUBE_GET_TOOL_SCHEMAS当RUBE_SEARCH_TOOLS返回的某工具只带有schemaRef引用而非内联 schema 时需通过该工具换取完整 schema才能保证 Step 3 中arguments的字段级精确匹配。从仓库结构看这一行出现在几乎每个 composio-skills 技能每个技能的 Quick Reference 中都引用了schemaRef处理属于该技能体系的公共协议。此外文档 “Known Pitfalls” 中有一条针对数据的通用约束分页。响应中若含分页 token应继续拉取直至完整。仓库中的姊妹技能 coinbase-automation/SKILL.md 展示了这类分页的具体形态——以游标如starting_after代替页码翻页、limit有取值上限——可作为 Coinranking 数据类接口遇到分页时的参照处理方式。已知坑位清单六条执行纪律文档 “Known Pitfalls” 一节逐条列出了六条必须遵守的纪律这里逐条展开其工程含义Always search first先搜索工具 schema 会变化。未调用RUBE_SEARCH_TOOLS前不得硬编码任何工具 slug 或参数——这是所有坑位的总根因。Check connection验连接执行工具前确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 状态避免授权失效时执行到一半失败。Schema complianceschema 合规字段名与类型必须严格使用搜索结果中的原文不做猜测、改写或“等价替换”。Memory parametermemory 参数RUBE_MULTI_EXECUTE_TOOL调用中必须包含memory空对象{}也要显式传。Session reuse会话复用同一工作流内复用会话 ID新工作流生成新 ID——既保持上下文连贯又避免跨任务串扰。Pagination分页检查响应中的分页 token循环拉取直至数据完整。技能安装与验证该技能按 awesome-codex-skills 的标准安装流程接入 Codex见 README.md 的 Quickstart 一节方式一使用仓库自带的 Skill Installer推荐git clone https://gitcode.com/GitHub_Trending/aw/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/coinranking-automation安装脚本逻辑可见 install-skill-from-github.py它从仓库拉取技能目录放置到$CODEX_HOME/skills/skill-nameCODEX_HOME未设置时默认为~/.codex随后重启 Codex 使其加载新技能元数据。方式二手动安装将composio-skills/coinranking-automation目录整体复制到$CODEX_HOME/skills/默认~/.codex/skills/重启 Codex 重新加载元数据在后续会话中描述任务或直接提及技能名Codex 会基于descriptionfrontmatter 自动匹配触发。验证安装列出已安装技能并检查元数据即可ls ~/.codex/skills head ~/.codex/skills/coinranking-automation/SKILL.md确认 frontmatter 中name为coinranking-automation、requires.mcp为[rube]即代表安装成功再按前文 “前置条件” 一节完成 Rube MCP 端点添加与 Coinranking 连接授权即可开始使用三步工作流。小结coinranking-automation 技能的价值不在某个具体接口的封装而是一套可复用的 MCP 自动化范式以RUBE_SEARCH_TOOLS的动态 schema 为准、以RUBE_MANAGE_CONNECTIONS的 ACTIVE 状态为闸口、以RUBE_MULTI_EXECUTE_TOOL的 schema 级合规为执行底线辅以memory、会话复用与分页三条执行纪律。这套模式与仓库中 composio-skills 目录下的数百个同类技能完全一致因此掌握 coinranking-automation 之后切换到其他 toolkit 只需替换use_case与 toolkit 名称流程不变。【免费下载链接】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），仅供参考