使用 Rube MCP 自动化 Placid 设计任务基于 Composio Placid Toolkit 的 Codex Skill 实战指南【免费下载链接】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/placid-automation/SKILL.md 展开讲解如何在 Codex 环境中通过 Rube MCP 网关调用 Composio 的 Placid toolkit以统一的三步工作流完成 Placid 设计任务的发现、连接与执行。读完本文你将掌握 Rube MCP 的接入方式、RUBE_SEARCH_TOOLS动态发现工具的模式、RUBE_MANAGE_CONNECTIONS的连接校验方法以及RUBE_MULTI_EXECUTE_TOOL的安全执行规范并能直接套用到 Composio 生态中其他数百个 toolkit 上。一、这个 Skill 是什么定位与核心设计思想placid-automation是 awesome-codex-skills 仓库composio-skills/系列中的一个 Codex Skill其 frontmatter 定义如下--- name: placid-automation description: Automate Placid tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---三行元数据承载了三个关键信息nameSkill 的唯一标识安装后对应$CODEX_HOME/skills/placid-automation/目录description决定了 Codex 何时自动触发该 Skill。根据仓库 README.md 的说明Codex 通过读取 SKILL.md 的 description 元数据判断是否匹配当前任务因此这里明确写明了适用场景——通过 Rube MCP 自动化 Placid 任务requires.mcp声明该 Skill 强依赖名为rube的 MCP 服务器必须在客户端配置中先行接入。该 Skill 的核心设计思想可以用一句话概括永远不要硬编码工具参数先搜索再执行。由于工具 schema 会随平台更新而变化Skill 将动态工具发现作为一切工作流的强制前置步骤。这一模式并非 Placid 专属composio-skills/目录下的 composio-automation/SKILL.md、composio-search-automation/SKILL.md 等大量同族 Skill 采用了完全相同的结构区别仅在于连接的 toolkit 名称与 use_case 描述因此本文讲解的流程可以无障碍迁移到其他集成上。二、前置条件在开始任何 Placid 工作流之前需要满足以下三个条件Rube MCP 已连接客户端环境中必须存在可用的RUBE_SEARCH_TOOLS工具这是验证网关连通性的首要标志Placid 连接处于 ACTIVE 状态通过RUBE_MANAGE_CONNECTIONS建立 toolkit 为placid的连接且状态必须显示为 ACTIVE首次调用RUBE_SEARCH_TOOLS任何工作流执行前都必须先调用它获取当前最新的工具 schema禁止直接使用记忆中的工具 slug 或参数结构。三、环境设置接入 Rube MCP 并建立 Placid 连接3.1 添加 Rube MCP 服务器接入方式非常轻量在客户端Codex、Claude 或其他支持 MCP 的客户端的 MCP 服务器配置中添加https://rube.app/mcp作为服务器地址即可。该端点无需 API Key只需添加地址即可连通。3.2 四步建立连接接入 Rube MCP 后按以下顺序完成 Placid 连接的建立验证连通性调用RUBE_SEARCH_TOOLS确认其正常响应证明 Rube MCP 已就绪发起连接调用RUBE_MANAGE_CONNECTIONS传入toolkits: [placid]发起 Placid 的授权连接完成授权如果连接状态不是 ACTIVE跟随返回的 auth 链接完成认证流程一般为 OAuth 授权确认状态再次检查连接状态确认显示 ACTIVE 后再开始运行任何工作流。注意RUBE_MANAGE_CONNECTIONS属于 Rube MCP 网关层的能力它统一托管了 Composio 平台的连接凭证使得 Skill 本身无需保存任何敏感密钥——这正是该方案相比直接在各应用侧管理凭证的核心优势。四、工具发现先搜索、再执行4.1 为什么要永远先搜索Placid toolkit 暴露的工具会随 Composio 平台迭代而演进工具 slug 可能调整、入参字段可能新增、必填项可能变化。如果 Agent 硬编码了过期的工具名或参数结构执行必然失败。因此 Skill 强制规定任何工作流的第一步都是调用RUBE_SEARCH_TOOLS。4.2 首次发现生成新会话在尚无会话上下文时使用generate_id: true让网关自动生成一个新的 session IDRUBE_SEARCH_TOOLS queries: [{use_case: Placid operations, known_fields: }] session: {generate_id: true}use_case用自然语言描述你要完成的 Placid 任务场景越具体返回的工具越精准known_fields如果你已知某些字段信息可以填入未知则传空字符串session.generate_id置为true时网关自动生成新会话 ID适用于全新工作流。4.3 搜索结果包含什么一次成功的搜索会返回四类关键信息可用工具 slug 列表当前 toolkit 暴露的全部工具标识输入 schema每个工具的参数结构字段名、类型、必填项、取值范围推荐的执行计划网关根据 use_case 给出的建议调用序列已知陷阱该工具在实战中的常见坑点提示。五、核心工作流模式三步完成一次 Placid 任务Step 1发现可用工具针对具体任务再次搜索此时复用已有会话 ID而非生成新 IDRUBE_SEARCH_TOOLS queries: [{use_case: your specific Placid task}] session: {id: existing_session_id}将use_case替换为你真实的任务描述例如创建社交媒体图片模板之类的具体诉求实际描述以你需要的 Placid 操作为准。同一工作流内复用 session ID可以保持上下文连续便于网关给出更贴合的执行计划。Step 2检查连接状态在执行任何工具之前确认 Placid 连接仍然有效RUBE_MANAGE_CONNECTIONS toolkits: [placid] session_id: your_session_idtoolkits数组形式此处传入[placid]session_id沿用 Step 1 的会话 ID。只有返回的状态为 ACTIVE 才能继续。这一步防止了连接过期导致工具调用静默失败的常见问题——OAuth 类连接可能因 token 过期而失效事前校验远比事后排错高效。Step 3执行工具拿到工具 slug 和 schema 后通过RUBE_MULTI_EXECUTE_TOOL批量执行RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: TOOL_SLUG_FROM_SEARCH, arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: your_session_id参数要点tools数组可一次提交多个工具调用。每个元素包含tool_slug必须来自 Step 1 的搜索结果和arguments必须严格符合搜索结果返回的 schema——字段名、类型、大小写都要精确一致memory必须始终携带即使为空也要显式传入{}这是该 API 的强制约定session_id与前后步骤保持同一会话。需要批量处理大量任务时Skill 还提供了两种进阶工具RUBE_REMOTE_WORKBENCH配合run_composio_tool()函数执行批量操作适合需要对多个 Placid 资源重复执行同一工具的场景RUBE_GET_TOOL_SCHEMAS当搜索结果中的某个工具带有schemaRef引用时用它获取该工具的完整 schema 定义确保参数填写无误。六、已知坑点与最佳实践原 Skill 文档总结了六条实战经验逐条展开如下永远先搜索工具 schema 会变。不经过RUBE_SEARCH_TOOLS就使用硬编码的工具 slug 或参数是这类自动化最常见的失败原因执行前检查连接每次工作流执行前都用RUBE_MANAGE_CONNECTIONS确认 ACTIVE 状态避免在连接失效时白白消耗调用严格 schema 合规字段名与类型必须与搜索结果完全一致多一个拼写错误或少一个必填字段都会导致调用失败memory 参数不可省略RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory即使内容为空也要写成{}会话复用策略同一工作流内复用 session ID 保持上下文新工作流则生成新的 ID避免上下文污染与状态串扰留意分页检查响应中是否包含分页 token若有则继续请求直到取完全部数据避免遗漏批量结果。七、快速参考表以下速查表完整收录了 Skill 文档中的五种操作模式操作方式查找工具RUBE_SEARCH_TOOLS传入 Placid 相关的 use_case建立连接RUBE_MANAGE_CONNECTIONStoolkit 传placid执行工具RUBE_MULTI_EXECUTE_TOOL使用搜索发现的工具 slug批量操作RUBE_REMOTE_WORKBENCH配合run_composio_tool()获取完整 schemaRUBE_GET_TOOL_SCHEMAS适用于带schemaRef的工具八、将 Skill 安装到 Codex 并使用根据仓库 README.md 的说明Skill 需要放入$CODEX_HOME/skills/默认~/.codex/skills/目录才能被 Codex 加载推荐使用仓库自带的安装脚本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/placid-automation安装后重启 Codex 以加载新 Skill 元数据。之后在会话中描述 Placid 相关任务时Codex 会根据placid-automation的 description 自动触发该 Skill在 Skill 触发后Agent 会按照本文所述的三步工作流发现工具 → 检查连接 → 执行工具完成整个自动化流程。结语placid-automationSkill 的价值不仅在于它本身更在于它所示范的搜索驱动、连接校验、schema 合规的稳健自动化范式。将这套模式复制到 composio-skills/ 目录下的任何其他 toolkit Skill你就能以同样的可靠度去自动化成百上千个第三方服务——动态发现让代码永不过期显式校验让失败提前暴露而这正是生产级 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），仅供参考
