Awesome Codex Skills 实战通过 Rube MCP 自动化 OCR Web Service 工作流【免费下载链接】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 中的 OCR Web Service 自动化技能 为骨架系统讲解如何借助 Rube MCP 让 Codex Agent 调用 Composio 的 OCR Web Service 工具集自动完成图片/文档的文字识别类任务。读完本文你将掌握从接入 MCP、建立连接、发现工具到执行工具的完整调用链并学会规避六个高频踩坑点能够把这套「搜索—连接—执行」模式复用到仓库中其他数百个 Composio 技能上。一、技能定位这个 SKILL 在仓库中的角色该技能存放于 composio-skills/ocr-web-service-automation/SKILL.md是仓库composio-skills/目录下数百个「按工具包Toolkit自动化」技能中的一个。从仓库 README.md 可知Codex Skills 的本质是模块化指令包每个技能目录内有一个SKILL.md通过 YAML frontmatter 的name与description声明元数据Codex 依据description判断何时触发该技能触发后才加载正文从而保持上下文精简。本技能的 frontmatter 声明如下对应 SKILL.md--- name: ocr-web-service-automation description: Automate OCR Web Service tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各司其职name是技能唯一标识安装到$CODEX_HOME/skills/后即以此为目录名description是 Codex 触发匹配的依据同时直接点明了本技能的两个铁律——通过Rube MCP调用、永远先搜索工具获取最新 schemarequires.mcp: [rube]则声明了运行时依赖提醒使用者必须先接入 Rube MCP 这个 MCP 服务器。二、核心概念Rube MCP 与 Composio OCR Web Service Toolkit要理解本技能先厘清两个概念Rube MCP是本技能的唯一接入通道。它在客户端配置中添加一个 MCP 服务器端点后即可使用无需额外申请 API Key。接入后Codex Agent 会获得一组RUBE_*前缀的工具本技能涉及五个Rube 工具职责RUBE_SEARCH_TOOLS按 use case 搜索可用工具返回 tool slug、输入 schema、推荐执行计划与已知坑RUBE_MANAGE_CONNECTIONS管理第三方服务连接建立、查看状态、跟随授权链接RUBE_MULTI_EXECUTE_TOOL批量执行一个或多个已发现的工具RUBE_REMOTE_WORKBENCH远程工作台适合批量/脚本化操作内部通过run_composio_tool()调用RUBE_GET_TOOL_SCHEMAS获取带schemaRef的完整工具 schemaComposio 的 OCR Web Service Toolkit是 Composio 提供的 1000 第三方集成之一仓库 README 中 MCP Gateway 章节印证了该生态规模负责把 OCR Web Service 的能力封装成可供 Agent 直接调用的工具。本技能的作用就是指导 Agent 完成「Rube MCP → Composio OCR 工具集」这条链路。值得说明的是通过对比同目录下的 composio-automation/SKILL.md、composio-search-automation/SKILL.md 等文件可以清晰看出所有 Composio 技能都遵循同一套模板前置条件 → Setup → 工具发现 → 三步工作流 → 已知陷阱 → 速查表。因此本文讲解的模式具有强可复用性换一个 Toolkit 名即可迁移。三、前置条件开工前必须满足的三项要求在运行任何 OCR 工作流之前需要确认以下三点对应 SKILL.mdRube MCP 已连接RUBE_SEARCH_TOOLS必须可用这是整个技能运转的前提OCR Web Service 连接已激活通过RUBE_MANAGE_CONNECTIONS指定 toolkit 为ocr_web_service且连接状态为ACTIVE先搜索后执行任何情况下执行工具前都必须先调用RUBE_SEARCH_TOOLS获取当前 schema禁止凭记忆硬编码工具 slug 或参数。其中第 3 条是贯穿全文的最高优先级原则——工具 schema 是动态演进的只有以实时搜索结果为准才能保证调用参数与类型完全匹配。四、环境搭建接入 Rube MCP 并建立 OCR 连接4.1 添加 MCP 服务器在 Codex 客户端配置中将以下地址注册为一个 MCP Server 即可无需配置 API Key添加端点后立即可用https://rube.app/mcp4.2 建立并验证连接的四个步骤接入 MCP 后按顺序完成连接初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能正常响应说明 MCP 通道已打通发起连接调用RUBE_MANAGE_CONNECTIONStoolkits 参数传入ocr_web_service完成授权若返回的连接状态不是ACTIVE则根据返回的授权链接auth link完成第三方服务授权确认就绪再次核对连接状态显示ACTIVE后才允许开始执行任何工作流。这四步把「通道可用」与「业务可用」明确区分开来第 1 步验证的是 MCP 层第 24 步验证的是 OCR 服务连接层任何一层未就绪都不应进入执行阶段。五、工具发现用 RUBE_SEARCH_TOOLS 获取实时 Schema工具发现是每次工作流的强制第一动作。技能给出了一个可复用的初始搜索示例对应 SKILL.mdRUBE_SEARCH_TOOLS queries: [{use_case: OCR Web Service operations, known_fields: }] session: {generate_id: true}关键参数说明use_case描述你的具体任务意图如 OCR Web Service operations实际执行时替换为你自己的 OCR 任务描述越具体返回的工具越精准known_fields你已知的字段名留空字符串表示不预设session.generate_id: true由系统生成新的会话 ID用于区分不同工作流。调用后返回四类关键信息可用工具 slugtool slugs——后续执行阶段的调用标识输入 schema——每个工具的参数结构、字段名与类型推荐执行计划recommended execution plans——针对该 use case 的建议调用顺序已知陷阱known pitfalls——该工具的使用注意事项。这四类信息共同构成「实时契约」是后续一切调用的依据。六、核心工作流发现—连接—执行三步曲技能将完整工作流规范为三个步骤每个步骤都有标准调用格式对应 SKILL.md。Step 1发现可用工具针对你的具体 OCR 任务发起搜索复用已有的会话 ID同一工作流内保持会话一致RUBE_SEARCH_TOOLS queries: [{use_case: your specific OCR Web Service task}] session: {id: existing_session_id}Step 2检查连接状态执行工具前再次确认连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [ocr_web_service] session_id: your_session_idStep 3执行工具用搜索阶段拿到的 tool slug 组装调用schema 字段必须与搜索结果的输入 schema 完全一致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 的搜索结果禁止硬编码猜测arguments严格遵循搜索返回的 schema字段名、类型、必填项都以实时结果为准memory必填参数即使当前没有跨步骤状态需要传递也要显式传入空对象{}否则调用可能失败。七、进阶能力批量操作与完整 Schema 获取除基础三步外技能还提供了两个面向进阶场景的工具批量操作使用RUBE_REMOTE_WORKBENCH在其内部调用run_composio_tool()来完成批量/脚本化的工具执行适合需要循环处理多份 OCR 任务的场景完整 Schema对于搜索结果中带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS获取其完整、未截断的 schema 定义确保参数补全不遗漏。这两个工具与三步工作流配合构成从「单次执行」到「批量流水线」的完整能力梯度。八、六大已知陷阱从踩坑记录到防御式编程SKILL.md 明确列出了六个高频陷阱这也是该技能最实用的部分逐一展开必须先搜索Always search first工具 schema 会变化。任何不经过RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数的行为都是最危险的错误来源执行前检查连接在调用任何工具前用RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE。连接过期或未授权会导致执行阶段大面积失败严格 schema 合规arguments 中的字段名、类型必须与搜索结果完全一致哪怕是大小写或类型差异都可能被拒绝memory 参数不可省略所有RUBE_MULTI_EXECUTE_TOOL调用都必须携带memory字段即使为空也要写成{}会话复用策略同一工作流内的多次调用复用同一个 session ID保持上下文连贯开启全新工作流时再生成新 ID分页处理响应中可能带有分页 token必须检查并持续拉取直到数据取完为止否则会静默丢失后续结果。九、快速参考速查表技能末尾提供了一张可直接贴在会话旁的操作速查表完整继承如下OperationApproachFind toolsRUBE_SEARCH_TOOLSwith OCR Web Service-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitocr_web_serviceExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef十、安装与使用让 Codex 自动触发该技能10.1 安装方式该技能目录本身即可作为 Codex Skill 使用。推荐通过仓库自带的 skill-installer 辅助脚本安装例如python skill-installer/scripts/install-skill-from-github.py --repo owner/awesome-codex-skills --path composio-skills/ocr-web-service-automation也可以手动将composio-skills/ocr-web-service-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/下然后重启 Codex 以加载新的元数据。10.2 触发机制依据 README.md 的说明安装并重启后你只需在会话中以自然语言描述 OCR 任务Codex 就会根据 frontmatter 中的description自动匹配并触发本技能你也可以显式提及技能名ocr-web-service-automation来强制调用。技能触发后正文中这套「先搜索、再连接、后执行」的指令才会被加载进上下文这正是渐进式披露progressive disclosure设计的体现。10.3 验证安装安装完成后可执行ls ~/.codex/skills确认目录存在再用head ~/.codex/skills/ocr-web-service-automation/SKILL.md检查元数据是否正确加载。十一、小结一套模式数百种工具本技能的价值不止于 OCR 本身它示范的「Rube MCP 接入 → RUBE_SEARCH_TOOLS 发现 → RUBE_MANAGE_CONNECTIONS 建连 → RUBE_MULTI_EXECUTE_TOOL 执行」四段式链路在 composio-skills/ 目录下的数百个同类技能中完全一致。掌握本文的流程、参数语义与六大陷阱后你可以把同样的方法论迁移到任意 Composio Toolkit 上让 Codex Agent 稳定、合规地完成跨应用的自动化任务。【免费下载链接】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），仅供参考
Awesome Codex Skills 实战：通过 Rube MCP 自动化 OCR Web Service 工作流
Awesome Codex Skills 实战通过 Rube MCP 自动化 OCR Web Service 工作流【免费下载链接】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 中的 OCR Web Service 自动化技能 为骨架系统讲解如何借助 Rube MCP 让 Codex Agent 调用 Composio 的 OCR Web Service 工具集自动完成图片/文档的文字识别类任务。读完本文你将掌握从接入 MCP、建立连接、发现工具到执行工具的完整调用链并学会规避六个高频踩坑点能够把这套「搜索—连接—执行」模式复用到仓库中其他数百个 Composio 技能上。一、技能定位这个 SKILL 在仓库中的角色该技能存放于 composio-skills/ocr-web-service-automation/SKILL.md是仓库composio-skills/目录下数百个「按工具包Toolkit自动化」技能中的一个。从仓库 README.md 可知Codex Skills 的本质是模块化指令包每个技能目录内有一个SKILL.md通过 YAML frontmatter 的name与description声明元数据Codex 依据description判断何时触发该技能触发后才加载正文从而保持上下文精简。本技能的 frontmatter 声明如下对应 SKILL.md--- name: ocr-web-service-automation description: Automate OCR Web Service tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三个字段各司其职name是技能唯一标识安装到$CODEX_HOME/skills/后即以此为目录名description是 Codex 触发匹配的依据同时直接点明了本技能的两个铁律——通过Rube MCP调用、永远先搜索工具获取最新 schemarequires.mcp: [rube]则声明了运行时依赖提醒使用者必须先接入 Rube MCP 这个 MCP 服务器。二、核心概念Rube MCP 与 Composio OCR Web Service Toolkit要理解本技能先厘清两个概念Rube MCP是本技能的唯一接入通道。它在客户端配置中添加一个 MCP 服务器端点后即可使用无需额外申请 API Key。接入后Codex Agent 会获得一组RUBE_*前缀的工具本技能涉及五个Rube 工具职责RUBE_SEARCH_TOOLS按 use case 搜索可用工具返回 tool slug、输入 schema、推荐执行计划与已知坑RUBE_MANAGE_CONNECTIONS管理第三方服务连接建立、查看状态、跟随授权链接RUBE_MULTI_EXECUTE_TOOL批量执行一个或多个已发现的工具RUBE_REMOTE_WORKBENCH远程工作台适合批量/脚本化操作内部通过run_composio_tool()调用RUBE_GET_TOOL_SCHEMAS获取带schemaRef的完整工具 schemaComposio 的 OCR Web Service Toolkit是 Composio 提供的 1000 第三方集成之一仓库 README 中 MCP Gateway 章节印证了该生态规模负责把 OCR Web Service 的能力封装成可供 Agent 直接调用的工具。本技能的作用就是指导 Agent 完成「Rube MCP → Composio OCR 工具集」这条链路。值得说明的是通过对比同目录下的 composio-automation/SKILL.md、composio-search-automation/SKILL.md 等文件可以清晰看出所有 Composio 技能都遵循同一套模板前置条件 → Setup → 工具发现 → 三步工作流 → 已知陷阱 → 速查表。因此本文讲解的模式具有强可复用性换一个 Toolkit 名即可迁移。三、前置条件开工前必须满足的三项要求在运行任何 OCR 工作流之前需要确认以下三点对应 SKILL.mdRube MCP 已连接RUBE_SEARCH_TOOLS必须可用这是整个技能运转的前提OCR Web Service 连接已激活通过RUBE_MANAGE_CONNECTIONS指定 toolkit 为ocr_web_service且连接状态为ACTIVE先搜索后执行任何情况下执行工具前都必须先调用RUBE_SEARCH_TOOLS获取当前 schema禁止凭记忆硬编码工具 slug 或参数。其中第 3 条是贯穿全文的最高优先级原则——工具 schema 是动态演进的只有以实时搜索结果为准才能保证调用参数与类型完全匹配。四、环境搭建接入 Rube MCP 并建立 OCR 连接4.1 添加 MCP 服务器在 Codex 客户端配置中将以下地址注册为一个 MCP Server 即可无需配置 API Key添加端点后立即可用https://rube.app/mcp4.2 建立并验证连接的四个步骤接入 MCP 后按顺序完成连接初始化验证 Rube MCP 可用确认RUBE_SEARCH_TOOLS能正常响应说明 MCP 通道已打通发起连接调用RUBE_MANAGE_CONNECTIONStoolkits 参数传入ocr_web_service完成授权若返回的连接状态不是ACTIVE则根据返回的授权链接auth link完成第三方服务授权确认就绪再次核对连接状态显示ACTIVE后才允许开始执行任何工作流。这四步把「通道可用」与「业务可用」明确区分开来第 1 步验证的是 MCP 层第 24 步验证的是 OCR 服务连接层任何一层未就绪都不应进入执行阶段。五、工具发现用 RUBE_SEARCH_TOOLS 获取实时 Schema工具发现是每次工作流的强制第一动作。技能给出了一个可复用的初始搜索示例对应 SKILL.mdRUBE_SEARCH_TOOLS queries: [{use_case: OCR Web Service operations, known_fields: }] session: {generate_id: true}关键参数说明use_case描述你的具体任务意图如 OCR Web Service operations实际执行时替换为你自己的 OCR 任务描述越具体返回的工具越精准known_fields你已知的字段名留空字符串表示不预设session.generate_id: true由系统生成新的会话 ID用于区分不同工作流。调用后返回四类关键信息可用工具 slugtool slugs——后续执行阶段的调用标识输入 schema——每个工具的参数结构、字段名与类型推荐执行计划recommended execution plans——针对该 use case 的建议调用顺序已知陷阱known pitfalls——该工具的使用注意事项。这四类信息共同构成「实时契约」是后续一切调用的依据。六、核心工作流发现—连接—执行三步曲技能将完整工作流规范为三个步骤每个步骤都有标准调用格式对应 SKILL.md。Step 1发现可用工具针对你的具体 OCR 任务发起搜索复用已有的会话 ID同一工作流内保持会话一致RUBE_SEARCH_TOOLS queries: [{use_case: your specific OCR Web Service task}] session: {id: existing_session_id}Step 2检查连接状态执行工具前再次确认连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [ocr_web_service] session_id: your_session_idStep 3执行工具用搜索阶段拿到的 tool slug 组装调用schema 字段必须与搜索结果的输入 schema 完全一致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 的搜索结果禁止硬编码猜测arguments严格遵循搜索返回的 schema字段名、类型、必填项都以实时结果为准memory必填参数即使当前没有跨步骤状态需要传递也要显式传入空对象{}否则调用可能失败。七、进阶能力批量操作与完整 Schema 获取除基础三步外技能还提供了两个面向进阶场景的工具批量操作使用RUBE_REMOTE_WORKBENCH在其内部调用run_composio_tool()来完成批量/脚本化的工具执行适合需要循环处理多份 OCR 任务的场景完整 Schema对于搜索结果中带schemaRef的工具使用RUBE_GET_TOOL_SCHEMAS获取其完整、未截断的 schema 定义确保参数补全不遗漏。这两个工具与三步工作流配合构成从「单次执行」到「批量流水线」的完整能力梯度。八、六大已知陷阱从踩坑记录到防御式编程SKILL.md 明确列出了六个高频陷阱这也是该技能最实用的部分逐一展开必须先搜索Always search first工具 schema 会变化。任何不经过RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数的行为都是最危险的错误来源执行前检查连接在调用任何工具前用RUBE_MANAGE_CONNECTIONS确认状态为ACTIVE。连接过期或未授权会导致执行阶段大面积失败严格 schema 合规arguments 中的字段名、类型必须与搜索结果完全一致哪怕是大小写或类型差异都可能被拒绝memory 参数不可省略所有RUBE_MULTI_EXECUTE_TOOL调用都必须携带memory字段即使为空也要写成{}会话复用策略同一工作流内的多次调用复用同一个 session ID保持上下文连贯开启全新工作流时再生成新 ID分页处理响应中可能带有分页 token必须检查并持续拉取直到数据取完为止否则会静默丢失后续结果。九、快速参考速查表技能末尾提供了一张可直接贴在会话旁的操作速查表完整继承如下OperationApproachFind toolsRUBE_SEARCH_TOOLSwith OCR Web Service-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitocr_web_serviceExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef十、安装与使用让 Codex 自动触发该技能10.1 安装方式该技能目录本身即可作为 Codex Skill 使用。推荐通过仓库自带的 skill-installer 辅助脚本安装例如python skill-installer/scripts/install-skill-from-github.py --repo owner/awesome-codex-skills --path composio-skills/ocr-web-service-automation也可以手动将composio-skills/ocr-web-service-automation/目录复制到$CODEX_HOME/skills/默认~/.codex/skills/下然后重启 Codex 以加载新的元数据。10.2 触发机制依据 README.md 的说明安装并重启后你只需在会话中以自然语言描述 OCR 任务Codex 就会根据 frontmatter 中的description自动匹配并触发本技能你也可以显式提及技能名ocr-web-service-automation来强制调用。技能触发后正文中这套「先搜索、再连接、后执行」的指令才会被加载进上下文这正是渐进式披露progressive disclosure设计的体现。10.3 验证安装安装完成后可执行ls ~/.codex/skills确认目录存在再用head ~/.codex/skills/ocr-web-service-automation/SKILL.md检查元数据是否正确加载。十一、小结一套模式数百种工具本技能的价值不止于 OCR 本身它示范的「Rube MCP 接入 → RUBE_SEARCH_TOOLS 发现 → RUBE_MANAGE_CONNECTIONS 建连 → RUBE_MULTI_EXECUTE_TOOL 执行」四段式链路在 composio-skills/ 目录下的数百个同类技能中完全一致。掌握本文的流程、参数语义与六大陷阱后你可以把同样的方法论迁移到任意 Composio Toolkit 上让 Codex Agent 稳定、合规地完成跨应用的自动化任务。【免费下载链接】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），仅供参考
