使用 Rube MCP 自动化 Amcards 业务操作awesome-codex-skills 的 amcards-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本指南以 composio-skills/amcards-automation/SKILL.md 为核心完整讲解如何在 Codex CLI/API 中通过 Composio 的 Amcards 工具集自动化处理 Amcards 业务任务。读完本文你将掌握 Rube MCP 的连接配置、先搜索工具 Schema、再校验连接、最后执行调用的三段式工作流以及避免常见踩坑的实战要点可直接复制命令投入实际使用。技能定位一个开箱即用的 Amcards 自动化指令包在 awesome-codex-skills 仓库中每个技能都是一个独立的文件夹内含一份SKILL.md。它通过 YAML frontmatter 中的name与description两个字段向 Codex 声明自身能力Codex 先读取元数据判断何时该触发这个技能技能被触发后才加载正文指令从而保持上下文精简。amcards-automation 技能的前置声明如下见 SKILL.md--- name: amcards-automation description: Automate Amcards tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---其中requires.mcp: [rube]是关键约束本技能强依赖 Rube MCP 服务器提供的能力未接入 Rube 前技能无法工作。技能正文则以Automate Amcards operations through Composios Amcards toolkit via Rube MCP一句话点明任务边界——所有自动化均经由 Composio 托管的 Amcards 工具集完成而非直接调用 Amcards 原生 API。前置条件在开始任何 Amcards 自动化之前需要满足以下三个条件对应原文档 PrerequisitesRube MCP 必须已连接RUBE_SEARCH_TOOLS工具可用这是验证 Rube 接入是否成功的标志存在活跃的 Amcards 连接通过RUBE_MANAGE_CONNECTIONS以amcards为 toolkit 建立连接且状态为 ACTIVE每次执行前先调用RUBE_SEARCH_TOOLS工具 Schema 会随服务端更新而变化禁止凭记忆硬编码。安装与连接配置获取 Rube MCP原文档 Setup 给出的接入方式非常简单在客户端配置中将https://rube.app/mcp添加为 MCP server 端点即可无需申请任何 API Key——添加端点后即可直接使用。在 Codex 中完成接入后按以下顺序完成 Amcards 连接初始化确认 Rube MCP 可用调用RUBE_SEARCH_TOOLS能收到响应即代表接入成功调用RUBE_MANAGE_CONNECTIONStoolkit 参数传入amcards若连接状态不是 ACTIVE点击返回的认证链接完成授权设置在运行任何工作流之前再次确认连接状态为 ACTIVE。说明RUBE_MANAGE_CONNECTIONS返回的认证链接由 Composio 的 OAuth/API Key 流程动态生成具体授权方式以调用时返回的内容为准。将技能安装到 Codex仓库 README.md 提供了技能安装方法。最推荐的方式是使用仓库自带的 skill-installer 脚本详见 skill-installer/SKILL.md 及 install-skill-from-github.pygit 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/amcards-automation安装脚本会从$CODEX_HOME/skills默认~/.codex/skills下的目标路径中校验SKILL.md存在后将技能目录拷贝到skill-name子目录并打印Installed skill-name to dest确认结果。安装完成后需要重启 Codex才会加载新技能的元数据。手动安装同样可行把composio-skills/amcards-automation/目录整体复制到~/.codex/skills/并重启即可。工具发现永远先调用 RUBE_SEARCH_TOOLS原文档 Tool Discovery 强调执行任何工作流之前必须先做工具发现。这是本技能的第一原则因为工具 slug、输入 Schema、推荐执行计划都可能随版本变化。首次使用的发现请求如下RUBE_SEARCH_TOOLS queries: [{use_case: Amcards operations, known_fields: }] session: {generate_id: true}该调用的返回内容包含四类关键信息可用的工具 slugtool slugs、每个工具的输入 Schema、官方推荐的执行计划recommended execution plans、以及已知的坑known pitfalls。后续所有执行的参数都应严格以此为唯一事实来源。核心工作流发现 → 校验 → 执行原文档 Core Workflow Pattern 将完整自动化流程拆为三步这也是本技能所有任务无论是单个操作还是复杂业务流程的统一骨架。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Amcards task}] session: {id: existing_session_id}把use_case换成你的具体任务描述例如开卡、查余额、交易流水等并复用当前工作流的 session ID让搜索基于已有会话上下文进行。Step 2校验连接状态RUBE_MANAGE_CONNECTIONS toolkits: [amcards] session_id: your_session_id在真正调用任何工具之前先确认amcards连接处于 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 搜索结果中返回的 slug禁止猜测或硬编码arguments的字段名与类型必须与搜索结果中的 Schema 完全一致memory参数必须始终携带即使没有需要传递的状态也要显式传空对象{}。RUBE_MULTI_EXECUTE_TOOL支持在tools数组中一次性放入多个工具调用适合批量或串行业务流程若任务复杂可依赖memory字段在工作流步骤之间传递中间状态。常见陷阱与规避策略原文档 Known Pitfalls 总结了六条实战经验逐条展开如下陷阱规避策略工具 Schema 会变永远先调用RUBE_SEARCH_TOOLS不要硬编码工具 slug 或参数即使上次执行成功过连接状态失效执行工具前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE避免半途授权失败参数不合规严格使用搜索结果中的精确字段名与类型不要靠记忆或猜测传参漏传 memoryRUBE_MULTI_EXECUTE_TOOL每次调用都带memory字段无状态时传{}session 误用同一工作流内复用同一 session ID开启新工作流时生成新 ID如session: {generate_id: true}分页漏数据检查响应中的分页 token持续拉取直到取完全部结果快速参考表以下操作对照表可直接作为日常使用的速查索引对应原文档 Quick Reference操作方法查找工具RUBE_SEARCH_TOOLS携带 Amcards 相关的 use_case 描述建立连接RUBE_MANAGE_CONNECTIONStoolkit 传amcards执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCHrun_composio_tool()获取完整 Schema对带schemaRef的工具调用RUBE_GET_TOOL_SCHEMAS从单一技能到生态同模板技能的复用价值amcards-automation 并不是孤例。仓库的 composio-skills 目录下收录了数百个结构完全一致的自动化技能如 composio-automation 等它们共用同一套Rube MCP 三段式工作流范式区别仅在于toolkit与use_case的取值。这意味着你只需掌握本文的三步流程即可无障碍迁移到仓库中任意其他*-automation技能将RUBE_MANAGE_CONNECTIONS的toolkits改为对应名称、把RUBE_SEARCH_TOOLS的use_case换成目标业务描述即可。这种高度一致的模板化设计详见 skill-creator/SKILL.md 关于保持 SKILL.md 精简、用 description 驱动触发的规范让开发者可以用极低的认知成本批量驾驭大量第三方 SaaS 自动化场景。总结amcards-automation 技能的价值在于把连接第三方服务 动态发现工具 安全执行这一套易错流程固化成了可复制的指令模板。其核心方法论——先搜索 Schema、再校验连接、后执行调用且永远不信任硬编码——不仅是 Amcards 场景的最佳实践也是借助 Composio 生态自动化任何 SaaS 服务的通用范式。按本文步骤完成安装与连接后即可让 Codex 在对话中直接驱动 Amcards 相关业务操作。【免费下载链接】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），仅供参考