用 Rube MCP 自动化 21risk 操作awesome-codex-skills 中的 -21risk-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导读本指南基于 awesome-codex-skills 仓库中的 -21risk-automation 技能文档讲解如何借助 Composio 的 21risk toolkit 与 Rube MCPModel Context Protocol 服务器在 Codex CLI/API 中自动化 21risk 业务操作。读完本文你将掌握从连接 21risk 账户、动态发现工具 schema到按三阶段工作流批量执行 21risk 任务的完整方案并理解规避 schema 漂移、连接失效等常见坑位的实战要点。技能定位Composio Toolkit 自动化体系中的一员在 awesome-codex-skills 仓库中composio-skills/目录下聚合了数百个按第三方服务命名的自动化技能如-2chat-automation、ably-automation等每个技能都遵循统一的模式通过 Composio 提供的 toolkit 连接目标 SaaS 服务再经由 Rube MCP 暴露的RUBE_*系列工具完成「搜索工具 → 检查连接 → 执行调用」的闭环。-21risk-automation即面向 21risk 的对应实现其文件头声明了关键元数据--- name: -21risk-automation description: Automate 21risk tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---这段 frontmatter 是 Codex 技能机制的入口根据仓库 README.md 的说明Codex 会读取SKILL.md中的name与description元数据来决定何时触发技能只有在技能被触发后才加载正文从而保持上下文精简。requires.mcp字段则声明本技能强依赖名为rube的 MCP 服务器——这是整个自动化的基础设施。前置条件在运行任何 21risk 工作流之前需要满足以下三个条件Rube MCP 必须处于已连接状态确认RUBE_SEARCH_TOOLS工具可用它是后续一切操作的探针。21risk 连接必须为 ACTIVE通过RUBE_MANAGE_CONNECTIONS并指定 toolkit 为_21risk建立或激活连接。执行前必须先调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema禁止凭记忆或文档硬编码工具名与参数。Setup接入 Rube MCP 与建立 21risk 连接获取 Rube MCPRube MCP 的接入成本极低——无需申请任何 API Key只需在客户端的 MCP 服务器配置中添加端点地址https://rube.app/mcp即可生效。在 Codex 的配置中声明该端点后技能所依赖的rubeMCP 即被视为可用。四步建立 21risk 连接验证 Rube MCP 可用调用RUBE_SEARCH_TOOLS确认其正常响应。调用RUBE_MANAGE_CONNECTIONS传入 toolkit_21risk发起连接请求。若连接状态不是ACTIVE跟随返回结果中的认证链接完成 OAuth/授权设置。在运行任何工作流之前再次确认连接状态显示为ACTIVE。Tool Discovery先搜索后执行21risk toolkit 的工具清单与输入 schema 会随服务演进而变化因此技能强制要求「先发现再使用」。标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: 21risk operations, known_fields: }] session: {generate_id: true}该调用返回的内容包括可用工具的 slug唯一标识、每个工具的输入 schema、推荐执行计划以及已知陷阱提示。session.generate_id: true表示本次会话为新工作流生成全新会话 ID若在已有工作流中继续操作则应改为传入既有会话 ID详见下文。Core Workflow Pattern三阶段核心工作流技能文档给出了一个可复用的三阶段执行模式适用于任意 21risk 具体任务。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific 21risk task}] session: {id: existing_session_id}将use_case替换为你实际的 21risk 任务描述例如创建订单、查询风险名单等并用工作流内既有会话 ID 替换占位符以获得与该任务匹配的工具 slug 与参数 schema。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [_21risk] session_id: your_session_id执行前校验连接是否仍然 ACTIVE。21risk 的 OAuth 令牌可能过期连接状态检查是避免「工具调用成功但返回认证错误」的关键前置步骤。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_idtool_slug必须取自 Step 1 的搜索结果而非硬编码arguments的字段名与类型必须严格符合搜索返回的 schemamemory参数必须始终携带即使为空也要传{}session_id复用工作流既有会话。进阶操作批量执行与完整 Schema 获取除上述基础链路外技能还提到两个进阶工具RUBE_REMOTE_WORKBENCH适用于批量操作场景在远程工作台中通过run_composio_tool()函数以编程方式批量调用 21risk 工具适合需要循环、条件分支的多步骤任务RUBE_GET_TOOL_SCHEMAS当RUBE_SEARCH_TOOLS返回的工具带schemaRef引用时用该工具拉取完整 schema 定义用于构造复杂参数。Known Pitfalls六大已知陷阱技能文档总结了六个高频踩坑点务必逐条遵守Always search first先搜索再执行工具 schema 会变化绝不硬编码工具 slug 或参数每次都必须调用RUBE_SEARCH_TOOLSCheck connection执行前检查连接确认RUBE_MANAGE_CONNECTIONS返回ACTIVE状态再执行工具Schema compliance严格符合 schema使用搜索结果的精确字段名与类型避免因拼写或类型不符导致调用失败Memory parameter保留 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory即使为空也要传{}Session reuse会话复用策略同一工作流内复用会话 ID开启新工作流时生成新 IDPagination处理分页检查响应中的分页令牌pagination token持续拉取直到数据完整避免遗漏结果。Quick Reference速查表操作使用方式查找工具RUBE_SEARCH_TOOLS传入 21risk 相关 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 指定为_21risk执行工具RUBE_MULTI_EXECUTE_TOOL使用发现到的工具 slug批量操作RUBE_REMOTE_WORKBENCH调用run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS针对带schemaRef的工具在 Codex 中安装与使用该技能本技能属于 awesome-codex-skills 的composio-skills/集合。参照仓库 README.md 的通用安装方式可用技能安装器将其装入$CODEX_HOME/skills默认~/.codex/skillsgit 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/-21risk-automation安装后重启 Codex 以加载新技能元数据在会话中自然描述 21risk 相关任务Codex 将依据 frontmatter 中的description自动触发该技能。也可手动将 composio-skills/-21risk-automation 目录复制到$CODEX_HOME/skills/完成安装。技能被触发后Codex 会遵循本指南的三阶段工作流完成 21risk 任务的自动化执行。小结-21risk-automation技能把「连接管理、动态 schema 发现、规范执行」三条原则固化为一套可复用的工作流模板。对开发者而言最值得内化的不是某个具体工具而是先搜索、再校验、后执行的稳健调用范式——它让 Agent 在 toolkit schema 频繁演进的真实环境中依然可靠运行。如需将其推广到其他服务可参照composio-skills/目录下同构的其他技能文档替换 toolkit 标识与 use case 描述即可快速套用。【免费下载链接】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），仅供参考