
awesome-codex-skills 实战通过 Rube MCP 与 Composio 自动化 Loomio 协作决策工作流【免费下载链接】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/loomio-automation/SKILL.md 为骨架讲解如何在 Codex 中借助 Composio 的 Rube MCP 网关对 Loomio协作式群体决策与讨论平台执行自动化的连接、工具发现与工具执行操作。读完本文你将掌握RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等核心 Rube 工具的正确调用姿势理解先搜索 schema、再检查连接、最后执行的可靠工作流并能避开工具 schema 变化、连接失效等典型坑位。技能定位这条 SKILL 解决什么问题loomio-automation是 awesome-codex-skills 仓库 composio-skills 系列技能之一它的目标非常聚焦让 Codex Agent 通过 Composio 的 Loomio toolkit 完成对 Loomio 的各类操作而这一切通过Rube MCP这一中间层完成。该技能的 SKILL.md 元数据 声明了三件事--- name: loomio-automation description: Automate Loomio tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---name技能唯一标识即loomio-automationdescription描述技能用途并刻意强调Always search tools first for current schemas执行前永远先搜索工具以获取当前 schema——这是全篇最重要的行为准则requires.mcp声明该技能依赖名为rube的 MCP 服务器Codex 只有在该 MCP 已配置时才会正确触发技能。从仓库 README.md 的定位来看Composio 的 MCP Gateway 提供单个 MCP endpoint即可统一接入 1000 集成并内置认证、团队级访问控制与审计日志。Rube MCP 正是这一思路在技能层的落地形态Agent 不需要为每个应用单独维护 API Key而是通过统一的 Rube 工具集完成发现、连接与执行。前置条件连接 Rube MCP 与 Loomio原文档明确列出了运行该技能必须满足的三项前提Rube MCP 必须已连接且RUBE_SEARCH_TOOLS工具可用必须存在一个 ACTIVE 的 Loomio 连接该连接通过RUBE_MANAGE_CONNECTIONS以 toolkitloomio建立永远先调用RUBE_SEARCH_TOOLS获取当前工具 schema再执行任何操作。第三条不是建议而是纪律Loomio toolkit 暴露的工具 slug 与参数结构可能随上游更新而变动只有先向 Rube 搜索工具才能拿到与当前版本一致的输入 schema。添加 Rube MCP 服务器Rube MCP 的接入成本极低无需任何 API Key在客户端配置中把https://rube.app/mcp添加为 MCP 服务器即可仅需添加 endpoint无需额外密钥。在 Codex 中完成添加后可先确认RUBE_SEARCH_TOOLS是否有响应以此验证 Rube MCP 已就绪。随后按原文档给出的 4 步完成 Loomio 连接初始化确认 Rube MCP 可用RUBE_SEARCH_TOOLS能正常响应调用RUBE_MANAGE_CONNECTIONStoolkit 指定为loomio若连接状态不是ACTIVE跟随返回的认证链接完成授权设置通常是 OAuth 流程在运行任何工作流之前确认连接状态显示为ACTIVE。这里的关键点是连接建立不等于连接可用。跳过第 3、4 步直接执行工具大概率会得到认证类错误因此原文档把ACTIVE 状态确认列为正式工作流的固定前置动作。工具发现RUBE_SEARCH_TOOLS 与动态 SchemaRube MCP 模式下Agent 面对的不是一份写死的 API 文档而是运行时动态发现。原文档给出了工具发现的初始请求RUBE_SEARCH_TOOLS queries: [{use_case: Loomio operations, known_fields: }] session: {generate_id: true}该调用的返回内容包含四类关键信息返回内容用途可用工具 slugtool slugs确定该连接下可以调用哪些 Loomio 操作输入 schemainput schemas每个工具参数的字段名、类型、必填项推荐执行计划recommended execution plansRube 针对该 use case 建议的多步调用序列已知陷阱known pitfalls该工具组合下常见的失败模式与规避方式注意到请求中的session: {generate_id: true}——首次发现工具时让 Rube 生成一个会话 ID后续工作流中的连接检查与工具执行都应复用该 ID保持上下文连续。从仓库内其他技能如 composio-automation/SKILL.md、composio-search-automation/SKILL.md可以看到RUBE_SEARCH_TOOLS的请求结构完全一致仅use_case文案随目标应用不同而变化这说明该发现流程是整套 composio-skills 的通用基础能力。核心工作流三步模式详解原文档将 Loomio 自动化固化为一个可复用的三步模式任何具体任务都遵循同一骨架。Step 1发现可用工具RUBE_SEARCH_TOOLS queries: [{use_case: your specific Loomio task}] session: {id: existing_session_id}把use_case替换为你的具体任务描述例如创建 Loomio 讨论/投票并邀请成员并传入已有会话 IDsession.id而不是重新生成。这样 Rube 能在已建立的上下文中返回更贴合任务的工具组合。Step 2检查连接RUBE_MANAGE_CONNECTIONS toolkits: [loomio] session_id: your_session_id确认 toolkitloomio的连接状态为ACTIVE。若为其他状态如PENDING、EXPIRED应先回到 Setup 步骤完成或刷新授权再继续。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必须始终携带即使没有跨步骤状态也要显式传空对象{}——它是 Rube 工作流记忆机制的固定参数session_id复用同一工作流中的会话 ID。RUBE_MULTI_EXECUTE_TOOL的tools是一个数组意味着可以在一次调用中批量执行多个工具这为读取讨论 → 统计投票 → 生成结论这类多步 Loomio 流程提供了单次往返的编排能力。已知陷阱清单逐条拆解原文档的 Known Pitfalls 是全篇最具实战价值的部分值得逐条展开Always search first永远先搜索工具 schema 会变化。不调用RUBE_SEARCH_TOOLS就硬编码 tool slug 或参数是失败率最高的做法——上游一旦调整参数结构调用立刻 404 或校验失败。搜索开销极小是唯一可靠的防错手段。Check connection检查连接执行工具前必须确认RUBE_MANAGE_CONNECTIONS返回ACTIVE。Loomio 的 OAuth 令牌可能过期或被吊销状态检查能在报错前暴露问题。Schema complianceschema 合规使用搜索结果中的精确字段名和类型。不要猜参数名例如把group_id猜成groupIdRube 返回的 schema 才是唯一权威。Memory parameter记忆参数RUBE_MULTI_EXECUTE_TOOL调用中必须包含memory即使为空也要写{}。漏传该参数会导致调用结构不完整。Session reuse会话复用同一工作流内复用 session ID新工作流才生成新 ID。混用会话会导致 Rube 无法正确关联上下文与连接状态。Pagination分页检查响应中的分页令牌持续拉取直到数据完整。Loomio 讨论、投票、成员等列表类操作通常分页返回只看第一页会导致数据缺失。快速参考表原文档用一张表概括了所有关键操作与对应工具这里完整保留并补充说明OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Loomio-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitloomioExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef其中前三种构成日常主链路后两种面向进阶场景详见下一节。进阶批量操作与完整 Schema除三步主流程外原文档的快速参考表还揭示了两个进阶工具RUBE_REMOTE_WORKBENCHrun_composio_tool()面向批量操作。当需要对大量 Loomio 记录如几十个讨论、多轮投票执行同类调用时可通过远程工作台以run_composio_tool()方式批量驱动 Composio 工具避免逐条RUBE_MULTI_EXECUTE_TOOL的低效往返。RUBE_GET_TOOL_SCHEMASschemaRef当搜索结果中的某些工具带有schemaRef引用时可用该工具拉取完整 schema 定义。这适用于参数较多、需要精确构造复杂arguments的场景例如带嵌套结构的分组配置。这两个工具在仓库 composio-skills 下的全部技能文档中保持一致的约定可见 composio-automation/SKILL.md说明它们是 Rube MCP 平台的稳定能力面可以直接信任并复用。从源码结构看模板化技能模式的工程意义从仓库结构可以推断composio-skills/目录下存在数百个结构高度同构的自动化技能如composio-automation、composio-search-automation、-2chat-automation等它们共享同一套元数据声明 前置条件 Setup 工具发现 三步工作流 陷阱清单 快速参考的骨架仅 toolkit 名称与 use case 文案不同。这意味着学习成本可迁移掌握了loomio-automation的调用模式就等于掌握了整个 composio-skills 系列的使用方法行为可预期Codex 依据 SKILL.md 的 description frontmatter 自动触发匹配技能规范的元数据保证了描述任务 → 命中技能 → 按步骤执行的稳定链路安装方式统一可通过 skill-installer 安装到$CODEX_HOME/skills默认~/.codex/skills或手动复制技能目录后重启 Codex 加载与 README.md 中描述的通用安装流程一致。相关资源技能原文composio-skills/loomio-automation/SKILL.md技能总览与安装说明README.md同构技能示例composio-automation/SKILL.md、composio-search-automation/SKILL.md技能创建规范skill-creator、template-skill综上loomio-automation并非一份孤立的工具清单而是一套以动态 schema 发现为核心、以连接状态校验为护栏、以三步工作流为骨架的可靠自动化方法论。只要严格遵守先搜索、再检查、后执行的顺序并时刻留意分页、会话与 memory 参数就能在 Codex 中稳定地驱动 Loomio 完成讨论、投票等协作决策类工作流。【免费下载链接】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),仅供参考