用 Composio Rube MCP 自动化 Carbone 文档渲染awesome-codex-skills 中 carbone-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/carbone-automation/SKILL.md 展开讲解如何在 Codex 中通过 Rube MCPComposio 提供的 MCP 网关驱动 Carbone 工具包完成自动化操作从 MCP 端点接入、连接授权到“先搜索工具、再执行工具”的三步工作流以及官方文档明确列出的六条常见陷阱。读完后你可以照此在自己的 Codex 环境中接入任意 Rube MCP 自动化技能本仓库composio-skills/下共有 800 余个同构技能并掌握一套可复制、可验证的工具调用模式。技能定位与元数据Carbone 是一个文档渲染类服务模板化渲染 Office 文档。本技能的目标是让 Codex 代理不用手写 HTTP 请求而是通过 Composio 的 Rube MCP 网关调用 Carbone 工具包toolkitcarbone。技能的入口文件是 SKILL.md其 YAML frontmatter 定义了触发元数据--- name: carbone-automation description: Automate Carbone tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个要点name是技能在$CODEX_HOME/skills中的标识名description决定了 Codex 何时触发该技能——按 README.md 的说明Codex 读取各技能的元数据来决定是否触发命中后才加载正文以此保持上下文精简渐进式披露机制requires: mcp: [rube]声明了前置依赖客户端必须已连接 Rube MCP 服务器否则技能无法执行任何动作。安装方式按 README.md 的 Quickstart有两种安装路径技能安装器推荐将技能拉取到$CODEX_HOME/skills/skill-name默认~/.codex/skills本仓库提供了 skill-installer/scripts/install-skill-from-github.pypython skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/carbone-automation手动安装把composio-skills/carbone-automation/整个文件夹拷贝到~/.codex/skills/下然后重启 Codex 使其重新加载元数据。安装后可用ls ~/.codex/skills查看已装技能用head ~/.codex/skills/carbone-automation/SKILL.md校验 frontmatter。前置条件原文档列出了三条硬性前置条件执行任何工作流前都需满足Rube MCP 已连接即客户端中RUBE_SEARCH_TOOLS工具可用已通过RUBE_MANAGE_CONNECTIONS建立carbone工具包的有效连接执行任何工作流前始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema——这是贯穿全文的第一原则原因见下文“已知陷阱”。Rube MCP 接入配置Rube MCP 的接入方式非常简单在你的 MCP 客户端配置中加入端点https://rube.app/mcp无需 API Key。原文档给出的接入步骤是确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONStoolkit 传carbone若连接状态不是 ACTIVE按返回的授权链接auth link完成授权再次确认连接状态显示 ACTIVE 后才运行任何工作流。从该技能的结构看整个授权流程是“无本地凭证”的MCP 端点本身即可用OAuth 级别的授权交给 Composio 侧的连接管理完成这正是 Composio 作为 MCP 网关的价值主张——connect/SKILL.md 中对同一生态的描述是“Skills tell your agent how to work. An MCP Gateway gives it secure access to the tools it needs”即技能负责“怎么做”MCP 网关负责“安全地做”。工具发现RUBE_SEARCH_TOOLSCarbone 具体有哪些工具、每个工具的入参是什么不能靠记忆或硬编码而要在运行时发现。原文档给出的发现调用是RUBE_SEARCH_TOOLS queries: [{use_case: Carbone operations, known_fields: }] session: {generate_id: true}参数说明queries是查询数组每项含use_case自然语言描述任务场景与known_fields已知字段可为空字符串session.generate_id: true表示本次会话由服务端生成一个新 session id返回的 id 将用于后续调用复用。搜索结果返回四样内容可用工具的 slug工具标识符、输入 schema、推荐执行计划recommended execution plans、已知陷阱known pitfalls。这意味着一次搜索就同时拿到了“调用什么、怎么传参、注意什么”的全部信息这也是“永远先搜索”原则成立的原因。核心工作流三步模式原文档将执行流程固化为三步以下参数与调用形式以原文档为准。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Carbone task}] session: {id: existing_session_id}注意这里 session 从{generate_id: true}变为{id: existing_session_id}即复用 Step 0工具发现生成的会话 id。把“你的具体 Carbone 任务”替换use_case中的占位描述可以让返回的 slug 与 schema 更贴近实际意图。Step 2检查连接状态RUBE_MANAGE_CONNECTIONS toolkits: [carbone] session_id: your_session_id在执行任何工具前确认carbone连接处于 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_idtool_slug必须使用 Step 1 搜索结果中返回的 slug禁止自行猜测arguments必须严格符合搜索返回的输入 schema——字段名与类型一字不差memory字段即使为空也必须带上{}见下文陷阱清单三个步骤全程复用同一个session_id。已知陷阱Known Pitfalls原文档用六条陷阱清单总结了该工作流中最容易踩的坑逐条对应到调用纪律陷阱要求目的Always search first未调用RUBE_SEARCH_TOOLS前绝不硬编码 tool slug 或参数工具 schema 会随版本变化硬编码必然漂移Check connection执行前用RUBE_MANAGE_CONNECTIONS确认 ACTIVE避免连接失效导致的批量失败Schema compliance字段名与类型严格取自搜索结果保证RUBE_MULTI_EXECUTE_TOOL一次通过Memory parameterRUBE_MULTI_EXECUTE_TOOL调用必须包含memory空则传{}该字段为必选缺失会调用失败Session reuse同一工作流内复用 session id新工作流再生成新 id保持上下文连续同时隔离不同任务Pagination检查响应中的分页 token持续拉取直到完整防止只处理了部分数据其中“memory 必传”与“分页检查”是最容易被自动化的 Agent 忽略的两条前者是协议级必选项后者是数据完整性问题——处理 Carbone 批量渲染结果时若漏掉后续分页会静默丢失数据。快速参考表原文档的 Quick Reference 汇总了五类操作的对应工具操作方式查找工具RUBE_SEARCH_TOOLS配 Carbone 特定的 use case建立连接RUBE_MANAGE_CONNECTIONStoolkit 传carbone执行工具RUBE_MULTI_EXECUTE_TOOL使用发现的 tool slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS用于返回了schemaRef的工具两点值得展开批量操作走RUBE_REMOTE_WORKBENCH而非循环调用RUBE_MULTI_EXECUTE_TOOL当搜索结果中某个工具只给出schemaRefschema 引用而非内联 schema 时需要再调RUBE_GET_TOOL_SCHEMAS取完整定义——这是“schema 可能按需加载”的显式约定。延伸在仓库中横向使用这套模式composio-skills/目录下的 800 余个技能如 composio-skills/carbon-automation/SKILL.md、composio-skills/zoho-automation/SKILL.md与carbone-automation是同构的frontmatter 同样是requires: mcp: [rube]正文同样是“搜索 → 检查连接 → 执行”的三段式差异仅在 toolkit 名称与 use case 文案。因此本文总结的工作流与陷阱清单可直接迁移到其中任何一个工具包只需把toolkits: [carbone]换成对应工具包名并把use_case换成相应领域的任务描述即可。如果你更倾向于从终端而非 MCP 驱动 Composio仓库中的 connect/SKILL.md 提供了 CLI 对照路线composio search对应工具发现composio link toolkit对应连接管理composio execute SLUG -d json对应工具执行。两条路线的“先搜索、后执行、校验连接”纪律完全一致可按运行环境择一采用。小结carbone-automation技能本身很短但它把“Agent 通过 MCP 网关操作第三方 SaaS”这件事提炼成了可执行的纪律frontmatter 声明依赖、Rube MCP 端点免 Key 接入、RUBE_SEARCH_TOOLS运行时发现 schema、RUBE_MANAGE_CONNECTIONS校验 ACTIVE、RUBE_MULTI_EXECUTE_TOOL合规执行外加六条陷阱清单兜底。把这套模式装进 Codex 后Carbone 乃至 Composio 工具包矩阵中的其他服务都可以用同样的三步走完成自动化。【免费下载链接】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），仅供参考