基于 Rube MCP 自动化 Axonaut 业务操作：awesome-codex-skills 实战指南
基于 Rube MCP 自动化 Axonaut 业务操作awesome-codex-skills 实战指南【免费下载链接】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/axonaut-automation/SKILL.md 展开讲解如何在 Codex CLI / API 环境中通过 Rube MCP 接入 Composio 的 Axonaut 工具包实现对 Axonaut 业务的自动化。读完本文你将掌握 MCP 端点配置、连接激活校验、工具 schema 发现、多工具批量执行等完整流程并了解规避常见坑位的实战要点可直接复用到该仓库中所有*-automation系列技能上。背景为什么用 Skill 驱动 Axonaut 自动化awesome-codex-skills 是一个精选的实用 Codex 技能集合其核心理念是Skills 告诉 Agent「怎么做」MCP 网关为它提供真正能操作外部系统的工具见 README.md。每个技能以独立目录存在内部必须有带name与descriptionfrontmatter 的SKILL.mdCodex 依据 description 决定何时触发技能并在触发后才加载正文以保持上下文精简README.md。本技能axonaut-automation的 frontmatter 即遵循该规范--- name: axonaut-automation description: Automate Axonaut tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---requires.mcp声明了运行前置依赖客户端必须已经接入名为rube的 MCP 服务器。这是该技能能够工作的第一道保障——没有 Rube MCP技能内的所有工具调用都无法解析。前置条件在运行任何 Axonaut 自动化工作流之前需要满足以下三个条件Rube MCP 已连接客户端会话中必须存在RUBE_SEARCH_TOOLS工具Rube MCP 暴露的工具之一它是后续一切操作的入口。Axonaut 连接已激活通过RUBE_MANAGE_CONNECTIONS以 toolkitaxonaut建立连接且状态必须为ACTIVE。先搜索、后执行任何工作流的第一步都必须是调用RUBE_SEARCH_TOOLS获取当前工具 schema禁止凭记忆硬编码工具 slug 或参数。环境搭建接入 Rube MCP 并激活 Axonaut 连接1. 添加 Rube MCP 服务器Rube MCP 的接入方式非常轻量在客户端配置中添加 MCP 服务器端点https://rube.app/mcp即可无需任何 API Key添加后立即可用。这一步通常在 Codex 的 MCP 配置中完成配置成功后客户端会暴露一组RUBE_*前缀的工具。2. 激活 Axonaut 连接连接建立按以下顺序执行确认 Rube MCP 可用调用RUBE_SEARCH_TOOLS验证其能够正常响应调用RUBE_MANAGE_CONNECTIONS参数传入 toolkitaxonaut若返回的连接状态不是ACTIVE跟随响应中返回的认证链接完成授权设置再次确认连接状态显示ACTIVE之后才能开始运行工作流。连接状态校验是每一次工作流的必要步骤而不是只在首次搭建时做一次。第三方 OAuth 凭据可能过期、吊销或被撤销跳过检查直接执行会导致难以排查的认证类报错。工具发现一切从 RUBE_SEARCH_TOOLS 开始工具 schema 会随版本演进而变化因此技能的核心纪律是「永远先搜索」。发现工具的标准调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Axonaut operations, known_fields: }] session: {generate_id: true}该调用会返回可用的工具 slug 列表tool slugs每个工具的输入 schema字段名、类型、必填项针对该 use case 的推荐执行计划recommended execution plans已知陷阱known pitfalls。queries支持传入具体的业务场景例如客户查询、报价单处理等known_fields可填入你已经确定的字段名以帮助检索定位session参数在首次发现时使用generate_id: true让系统生成新会话 ID。核心工作流模式三步走Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Axonaut task}] session: {id: existing_session_id}将use_case替换为具体的 Axonaut 任务描述复用当前工作流的 session ID。这一步的输出决定了下两步要用哪个工具 slug、传什么参数。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [axonaut] session_id: your_session_id传入 toolkit 名称数组axonaut与当前 session ID确认连接为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_idRUBE_MULTI_EXECUTE_TOOL支持在一次调用中传入多个工具tools为数组每个元素包含tool_slug取自 Step 1 搜索结果不要自行猜测arguments严格按照搜索返回的 schema 填写字段名与类型。另外两个参数需要特别注意memory必须始终包含即使为空也要传{}session_id复用当前工作流的会话 ID保持上下文连贯。已知陷阱六条实战避坑清单原文档总结的六条陷阱是运维稳定性的关键逐一展开如下永远先搜索Always search first工具 schema 会变化绝不在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数。这是本技能最核心的纪律因为 Rube 侧的工具集与参数结构可能随 Composio 工具包升级而调整硬编码必然产生过期调用。检查连接Check connection执行任何工具前先通过RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE避免在失效连接上浪费时间与 token。Schema 合规Schema compliance参数必须使用搜索结果的精确字段名与类型多一个、少一个字段都可能导致执行失败。Memory 参数Memory parameterRUBE_MULTI_EXECUTE_TOOL调用中永远带上memory至少为空对象{}。遗漏该参数可能导致调用被拒。会话复用Session reuse同一工作流内复用 session ID开启新的工作流时生成新的 session。合理复用能让多步骤任务共享上下文也有助于服务端对执行链路进行审计与追踪。分页处理Pagination检查响应中是否携带分页令牌pagination tokens若有则持续拉取直到取完全部数据避免在大量记录场景下静默丢失结果。快速参考表操作方法查找工具RUBE_SEARCH_TOOLS传入 Axonaut 专属 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 为axonaut执行操作RUBE_MULTI_EXECUTE_TOOL使用搜索得到的工具 slug批量操作RUBE_REMOTE_WORKBENCH使用run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于带schemaRef的工具其中RUBE_REMOTE_WORKBENCH适用于需要在远端工作台执行批量或复杂编排的场景通过run_composio_tool()编程式调用而RUBE_GET_TOOL_SCHEMAS用于获取带schemaRef引用的工具的完整参数结构适合在编写复杂参数前做一次性全量核对。源码级佐证技能在仓库中的定位与安装从仓库结构看axonaut-automation隶属于 composio-skills/ 目录该目录下包含数百个按厂商命名的同构技能如ahrefs-automation、googlecalendar-automation等每个技能目录内均只有一个SKILL.md。这种单一文档 frontmatter 声明的结构与 README.md 描述的「技能布局」规范一致SKILL.md是必选项scripts/、references/、assets/为可选项本技能未引入额外脚本属于纯指令型技能。将该技能安装到 Codex 环境推荐使用仓库自带的 skill-installer# 克隆仓库后将技能安装到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py --repo owner/repo --path composio-skills/axonaut-automation安装完成后重启 Codex以加载新的技能元数据README.md。之后在会话中自然描述任务例如「帮我自动化处理 Axonaut 里的客户数据」Codex 会根据技能的descriptionfrontmatter 自动触发本技能。技能被触发后Agent 会按本文所述流程依次执行工具发现、连接校验与批量执行从而把「写 Skill」的声明式知识与 Rube MCP 的运行时工具能力衔接起来。结语Axonaut 自动化的本质是一条高度可复用的流水线RUBE_SEARCH_TOOLS 发现 → RUBE_MANAGE_CONNECTIONS 校验 → RUBE_MULTI_EXECUTE_TOOL 执行辅以 session 复用、memory 参数、分页处理等细节纪律。掌握这一模式后你不仅能在 Codex 中驱动 Axonaut 工具包还能将它平移到仓库中其他数百个*-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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考