awesome-codex-skills基于 Rube MCP 的 Composio Search 自动化技能实战——从连接认证到工具发现【免费下载链接】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-search-automation 技能讲清楚 Codex 如何通过 Rube MCP 网关自动化操作 Composio Search 工具集从 MCP 端点接入、连接认证到先搜索工具再执行的核心工作流以及该技能沉淀出的 6 条防坑规则。读完本文你能够把这个技能装入自己的 Codex 环境并复用其发现优先discover-first的 MCP 工具调用模式去构建同类自动化技能。技能定位composio-skills 集合中的搜索专项在 awesome-codex-skills 仓库中composio-skills/目录收录了数百个同构的自动化技能每个技能一个目录、一个SKILL.md其中与 Composio 官方直接对应的有两个姊妹技能composio-automation/SKILL.md对接composio工具集处理 Composio 平台自身的操作composio-search-automation/SKILL.md本文主角对接composio_search工具集专门自动化 Composio Search 任务。两者的结构完全同构——同样的 frontmatter 依赖声明、同样的三步工作流、同样的陷阱清单——仅use_case描述与 toolkit 参数不同。这种一工具集一技能的设计是该集合的统一范式技能本身不封装 API 调用代码而是为 Agent 提供一份精确的操作手册告诉它在什么前置条件下、以什么顺序调用哪些 Rube MCP 工具。Frontmatter元数据与 MCP 依赖声明技能的元数据决定了 Codex 何时触发它也声明了运行时依赖--- name: composio-search-automation description: Automate Composio Search tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---按 README.md 对 Codex 技能机制的说明每个技能是文件夹 SKILL.mdCodex 读取name与description元数据来决定是否触发正文指令主体只有在技能被触发后才加载以此保持上下文精简。这里有两个值得注意的设计点description末尾的 Always search tools first for current schemas 把该技能最重要的行为约束先搜索再执行直接写进了触发描述里使 Agent 在匹配到技能时就携带这条规则requires: mcp: [rube]显式声明该技能依赖 Rube MCP 服务。这对应文档Prerequisites的第一条Rube MCP 必须已连接RUBE_SEARCH_TOOLS可用。前置条件与 Rube MCP 接入文档给出的前置条件有三条缺一不可Rube MCP 已连接RUBE_SEARCH_TOOLS可响应通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为composio_search的活跃 Composio Search 连接任何执行前先调用RUBE_SEARCH_TOOLS获取当前工具 schema。接入步骤Setup非常轻量核心是一个无需 API Key 的 MCP 端点在客户端 MCP 配置中添加服务器https://rube.app/mcp文档明确说明No API keys needed — just add the endpoint and it works无需 API Key加上端点即可工作。认证不发生在客户端配置阶段而是推迟到连接建立阶段通过返回的 auth link 完成 OAuth 式授权。完整 Setup 四步确认RUBE_SEARCH_TOOLS有响应验证 Rube MCP 可用调用RUBE_MANAGE_CONNECTIONStoolkit 传composio_search若连接状态不是 ACTIVE按返回的 auth link 完成授权设置在任何工作流执行前确认连接状态显示 ACTIVE。工具发现RUBE_SEARCH_TOOLS 的调用形态发现优先是该技能的第一原则。首次发现的标准调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Composio Search operations, known_fields: }] session: {generate_id: true}返回内容包括四部分可用工具的 slug、输入 schema、推荐执行计划recommended execution plans、已知陷阱known pitfalls。session: {generate_id: true}会生成一个会话 ID后续同一工作流内的调用应复用它——这正是文档Known Pitfalls中 Session reuse 一节的来源。对比姊妹技能 composio-automation/SKILL.md 的调用唯一差异是use_case从 Composio operations 变为 Composio Search operations。从源码结构看这意味着RUBE_SEARCH_TOOLS的检索是按 use case 语义匹配工具集的use_case的措辞应当精确对应目标工具集否则可能召回无关工具。核心工作流发现 → 检查连接 → 执行文档定义了三步标准模式构成一个可复制的模板Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Composio Search task}] session: {id: existing_session_id}注意此处session从{generate_id: true}变为{id: existing_session_id}——即复用首次发现时生成的会话保证同一工作流内的上下文连续性。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [composio_search] session_id: your_session_id这一步是执行前的熔断检查只有返回 ACTIVE 才继续否则回到 Setup 第 3 步走授权链接。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 的搜索结果而非硬编码arguments必须与搜索返回的 schema 字段名和类型逐字一致memory参数即使为空对象也必须显式传{}。快速参考表原文档的 Quick Reference 完整覆盖了五种操作这里原样继承OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Composio Search-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitcomposio_searchExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef前三行对应核心工作流后两行是进阶路径批量操作走RUBE_REMOTE_WORKBENCH远程工作台并调用run_composio_tool()而带schemaRef标记的工具只返回 schema 引用而非完整定义需要额外调用RUBE_GET_TOOL_SCHEMAS拉取完整 schema。已知陷阱清单Known Pitfalls文档列出的 6 条陷阱是整套模式中最具复用价值的部分逐条展开Always search first先搜索工具 schema 会变化。未调用RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数是最常见的失效来源Check connection查连接执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态Schema complianceschema 合规字段名与类型必须与搜索结果完全一致大小写和嵌套结构都按返回原文使用Memory parametermemory 参数RUBE_MULTI_EXECUTE_TOOL调用必须包含memory即使为空也要传{}——这是一个容易被顺手省略的必填字段Session reuse会话复用同一工作流内复用 session ID新工作流才生成新会话Pagination分页检查响应中的分页 token持续拉取直到完整为止避免只拿到第一页数据就下结论。安装到 Codex结合仓库的安装说明该技能按仓库 README 的统一方式安装到$CODEX_HOME/skills默认~/.codex/skills推荐方式——用仓库自带的 skill-installer 安装脚本git 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/composio-search-automation安装脚本会把技能拉取并放置到$CODEX_HOME/skills/skill-name装完需重启 Codex 以加载新元数据。手动方式则是把技能目录复制到$CODEX_HOME/skills/下重启后在会话中描述 Composio Search 相关任务Codex 会基于description元数据自动匹配触发也可以用ls ~/.codex/skills与head ~/.codex/skills/skill/SKILL.md验证安装结果。适用前提本机已运行 CodexCLI 或 IDE 集成且能访问 Rube MCP 端点技能本身不含可执行脚本全部依赖运行时可用的 Rube MCP 工具因此 Rube MCP 不可用时该技能不具备任何执行能力。模式总结为什么这个技能值得作为模板把 composio-search-automation 与 composio-automation 并列阅读可以看到它代表的不是某个具体 API 的封装而是一套针对schema 动态演进的 MCP 网关的通用调用纪律元数据层frontmatter 里requires.mcp声明外部依赖description 内嵌最重要的行为约束控制触发时机与上下文成本连接层把认证状态ACTIVE作为执行前强制检查点用 auth link 完成一次性授权客户端零 API Key执行层工具身份slug与参数形态永远来自实时搜索session 贯穿工作流memory必填分页拉满。如果你要为自己常用的 SaaS 工具集编写同类技能只需替换use_case描述与 toolkit 名照搬这套发现 → 连接检查 → 执行 陷阱清单骨架即可——这正是 README.md 中Creating Skills一节所推荐的description 讲触发、正文讲执行步骤原则在 MCP 自动化场景下的落地形态。【免费下载链接】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），仅供参考