awesome-codex-skills通过 Rube MCP 自动化 Docsumo 的完整实践——工具发现、连接管理与执行工作流【免费下载链接】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/docsumo-automation/SKILL.md 展开系统讲解如何在 Codex 技能体系中接入 Docsumo发票/单据智能提取平台的自动化能力。读完本文你将掌握 Rube MCP 的接入配置、RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三大工具的调用规范、会话session与 memory 参数的使用纪律以及技能在 awesome-codex-skills 仓库中的安装与触发机制。一、技能定位与元数据Codex 如何识别这个技能Docsumo Automation 技能是 awesome-codex-skills 仓库中composio-skills目录下的一个成员。该目录集中了 800 余个应用自动化技能如 composio-skills/docmosis-automation、docsumo-automation等它们共享同一套Rube MCP Composio toolkit的自动化模式。从 composio-skills/docsumo-automation/SKILL.md 的 YAML frontmatter 可以看到该技能的元数据定义--- name: docsumo-automation description: Automate Docsumo tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---各字段的作用结合仓库 README 的说明可以确认name技能唯一标识对应安装后的目录名docsumo-automation。description触发依据。README 在What Are Codex Skills?一节说明Codex 依据description的匹配度决定何时触发技能并且只在技能命中后才加载正文从而保持上下文精简。因此description特意写明了Always search tools first这一核心执行纪律。requires.mcp: [rube]声明该技能依赖名为rube的 MCP 服务。这是本技能与其他本地型技能的关键差异——它不是自包含指令而是要求客户端已挂载 Rube MCP 端点。二、安装与加载把技能装进 $CODEX_HOME/skills按照仓库 README.md 的 Quickstart安装某个技能有两种方式。推荐使用内置的 skill-installer 脚本其说明见 skill-installer/SKILL.mdgit clone https://github.com/ComposioHQ/awesome-codex-skills.git cd awesome-codex-skills # 将技能安装到 $CODEX_HOME/skills默认 ~/.codex/skills python skill-installer/scripts/install-skill-from-github.py \ --repo ComposioHQ/awesome-codex-skills \ --path composio-skills/docsumo-automation脚本 skill-installer/scripts/install-skill-from-github.py 的行为约束来自 skill-installer/SKILL.md默认对公开仓库走直接下载认证/权限失败时回退到 git sparse checkout先 HTTPS 再 SSH若目标技能目录已存在则中止避免覆盖可通过--ref默认main、--dest、--method auto|download|git、--name控制行为。也可以手动安装把composio-skills/docsumo-automation目录整体复制到$CODEX_HOME/skills/默认~/.codex/skills/。两种方式最后都需要重启 Codex以重新加载技能元数据。验证方式同样在 README 中给出ls ~/.codex/skills查看目录head ~/.codex/skills/docsumo-automation/SKILL.md查看元数据。安装后的使用方式是自然语言描述任务如用 Docsumo 提取这批发票由 Codex 按description自动匹配触发也可以直接点名docsumo-automation强制考虑该技能。三、前置条件与 Rube MCP 连接配置技能文档在 Prerequisites 一节给出了三条硬性前提缺一不可Rube MCP 已连接客户端中必须能调用RUBE_SEARCH_TOOLSDocsumo 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS以 toolkitdocsumo建立并核验始终先调用RUBE_SEARCH_TOOLS获取当前工具 schema而不是凭记忆硬编码。Setup 部分的配置要点是在 MCP 客户端配置中加入 Rube MCP 端点https://rube.app/mcp作为 MCP server 地址配置。文档强调该端点无需 API Key——just add the endpoint and it works凭证与连接授权由后续的RUBE_MANAGE_CONNECTIONS交互式流程接管。文档给出的完整连接建立步骤4 步原文顺序调用RUBE_SEARCH_TOOLS确认其有响应以此验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONS并指定 toolkit 为docsumo若连接状态不是 ACTIVE跟随接口返回的 auth link 完成授权即用户在浏览器中完成 Docsumo 账号的 OAuth 类授权在执行任何工作流之前再次确认连接状态显示为ACTIVE。从源码结构看仓库内 800 多个*-automation技能例如同为单据自动化类的 composio-skills/docmosis-automation/SKILL.md都遵循完全相同的四步模板仅 toolkit 参数不同docsumovsdocmosis。这说明连接管理是由 Rube 端统一抽象的技能层只需声明 toolkit 名称。四、工具发现RUBE_SEARCH_TOOLS 的调用规范文档在 Tool Discovery 一节要求在执行任何工作流之前必须先做工具发现。原始请求格式如下RUBE_SEARCH_TOOLS queries: [{use_case: Docsumo operations, known_fields: }] session: {generate_id: true}参数解读queries[].use_case用自然语言描述任务场景。首次探索时用宽泛的Docsumo operations具体任务时换成如your specific Docsumo task的具体描述见下文 Step 1queries[].known_fields可留空字符串用于提示已知字段session.generate_id: true为当前工作流生成一个新会话 ID。首次发现工具时使用该方式创建会话同一工作流内的后续调用则复用返回的session_id。调用返回的内容包括四部分原文逐条列出可用工具的 slug工具唯一标识、输入 schema、推荐执行计划recommended execution plans、已知陷阱known pitfalls。后续步骤 3 中RUBE_MULTI_EXECUTE_TOOL的参数必须严格来自这次返回的 schema——这正是Always search tools first纪律的技术原因。五、核心工作流三步调用模式文档把完整执行路径固化为三步。以下完整保留原文调用参数并补充字段语义。Step 1Discover Available Tools工具发现RUBE_SEARCH_TOOLS queries: [{use_case: your specific Docsumo task}] session: {id: existing_session_id}与 Tool Discovery 一节的不同点在于此处使用session: {id: existing_session_id}而非generate_id: true即把发现动作挂到已建立的工作流会话上保证会话内工具上下文一致。Step 2Check Connection连接核验RUBE_MANAGE_CONNECTIONS toolkits: [docsumo] session_id: your_session_idtoolkits是数组形式可同时核验多个 toolkit。该步骤的意义在于连接状态可能在授权链接被放弃、token 过期等情况下从 ACTIVE 退化为非 ACTIVE必须在执行前重新确认而不能依赖上次连过的记忆。Step 3Execute Tools工具执行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本技能要求每次调用都必须携带该参数即使无内容也要显式传空对象{}——这是 Known Pitfalls 中单列的一条纪律session_id沿用本工作流会话。RUBE_MULTI_EXECUTE_TOOL支持tools数组批量提交多个工具调用适合提取 查询 更新这类串联操作。六、已知陷阱Known Pitfalls逐条解析文档列出的 6 条陷阱按失败后果归类解读Always search first先搜索后执行工具 schema 会随 upstream 变化任何跳过RUBE_SEARCH_TOOLS直接硬编码 slug 或参数名的写法都可能随时失效。这是本技能第一条也是权重最高的一条纪律。Check connection连接核验执行前必须确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE。非 ACTIVE 状态下执行工具调用属于无效操作。Schema complianceschema 精确匹配字段名与类型必须逐字对齐搜索结果大小写、下划线都不能凭习惯改写。Memory parametermemory 必传RUBE_MULTI_EXECUTE_TOOL调用中memory参数必须出现空场景也要传{}否则可能触发参数校验失败。Session reuse会话复用边界同一工作流内复用同一个 session ID开启新工作流时生成新的。混用会话会污染工具上下文。Pagination分页续取Docsumo 涉及文档列表等数据型接口响应中若出现分页 token必须沿 token 持续翻页直到取完否则会拿到不完整结果。七、Quick Reference操作速查表完整继承文档中的速查表五个入口工具各司其职OperationApproachFind toolsRUBE_SEARCH_TOOLS附 Docsumo 具体 use caseConnectRUBE_MANAGE_CONNECTIONS toolkitdocsumoExecuteRUBE_MULTI_EXECUTE_TOOL 搜索到的 tool slugBulk opsRUBE_REMOTE_WORKBENCH内调用run_composio_tool()Full schema对带schemaRef的工具用RUBE_GET_TOOL_SCHEMAS取完整 schema补充说明速查表中RUBE_SEARCH_TOOLS返回的 schema 有时是引用式的带schemaRef字段此时不能只看摘要字段必须用RUBE_GET_TOOL_SCHEMAS展开完整输入定义而批量bulk场景则升级到RUBE_REMOTE_WORKBENCH的脚本化通道在run_composio_tool()中循环执行——这两条路径覆盖了单工具深 schema和大批量重复调用两类典型工况。八、在仓库中的位置与延伸阅读技能正文composio-skills/docsumo-automation/SKILL.md本文全部工作流、参数与陷阱的直接来源同类模板对照composio-skills/docmosis-automation/SKILL.md同结构toolkit 为docmosis可对照验证四步模板技能机制与安装说明README.mdWhat Are Codex Skills?、Quickstart、Creating Skills 三节安装工具脚本说明skill-installer/SKILL.md、skill-installer/scripts/install-skill-from-github.py从仓库组织方式可以推断composio-skills下的每个*-automation目录都是一个最小可安装单元单一SKILL.md承载全部指令无额外脚本或引用文件符合 README Creating Skills 一节中保持技能目录精简、避免冗余文档的最佳实践。如果你要接入的其他 SaaS 也有对应 Composio toolkit完全可以照docsumo-automation的模式复刻替换 toolkit 名称、按四步模板写连接流程、保留先搜索后执行与 memory/session 纪律即可。适用前提与限制本文所有工具名RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL、RUBE_REMOTE_WORKBENCH、RUBE_GET_TOOL_SCHEMAS及其参数均来自仓库内技能文档的当前版本Rube MCP 服务端能力端点可用性、toolkit 覆盖范围、schema 结构不在本仓库内实际行为以RUBE_SEARCH_TOOLS的实时返回为准。技能生效前提是客户端已按第三节配置 Rube MCP 端点且 Codex 已重启加载技能。【免费下载链接】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），仅供参考