企业官网建设流程全解析

基于 Rube MCP 自动化 Conveyor 运维：awesome-codex-skills 技能实战指南

【免费下载链接】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

本指南以仓库 conveyor-automation 技能 为核心，讲解如何通过 Composio 提供的 Rube MCP 网关，让 Codex Agent 以「先搜索工具、再校验连接、最后执行」的标准化流程驱动 Conveyor 业务操作。读完本文，你将掌握 Rube MCP 的接入方式、RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三大核心工具的组合用法，以及避免踩坑的六条工程实践。

技能定位：让 Codex 真正操作 Conveyor

在 awesome-codex-skills 仓库中，composio-skills 目录下汇集了数百个「某应用 × Rube MCP」的自动化技能模板，conveyor-automation正是其中之一。它的核心思路是：Codex Skill 本身只负责"如何做"的指令编排，真正的第三方 API 调用能力由 Rube MCP 网关统一提供。

Conveyor 是一套面向制造/生产环境的业务流程平台，通过该技能，Agent 可以在对话中直接完成查询、创建、更新等 Conveyor 操作，而不是停留在"生成一段建议文本"的层面。这一点与仓库 README.md 对 Codex Skills 的定义一脉相承——技能是"可执行指令包"，描述（description）决定何时触发，正文决定如何执行。

该技能在 frontmatter 中声明了触发条件与依赖：

name: conveyor-automation description: "Automate Conveyor tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube]

其中requires.mcp: [rube]明确告知 Codex：运行此技能前必须确保 Rube MCP 已连接，这是技能可用的硬性前提。

前置条件

在运行任何 Conveyor 工作流之前，需要同时满足三个条件：

1. Rube MCP 已连接：RUBE_SEARCH_TOOLS工具可用，这是后续所有操作的基础；
2. Conveyor 连接为 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS以conveyor为 toolkit 建立连接，未激活的连接无法执行任何工具；
3. 执行前先调用RUBE_SEARCH_TOOLS：这是技能反复强调的铁律——工具 schema 会随版本演进，绝不能凭记忆硬编码工具 slug 与参数。

其中第三点尤为关键：Rube MCP 的元数据（工具列表、输入 schema、推荐执行计划、已知陷阱）全部是动态下发的，只有先搜索才能拿到"当前时刻"的准确契约。

环境搭建：接入 Rube MCP 并激活 Conveyor 连接

添加 MCP 服务器

Rube MCP 的接入成本极低——无需任何 API Key，只需在客户端配置中添加 MCP 服务器端点https://rube.app/mcp，添加后即可直接使用。这一步与仓库中其他 Rube 系技能（如 composio-automation、composio-search-automation）完全一致，说明 Rube 网关是一套统一的多工具接入基础设施。

四步激活流程

按以下顺序完成连接初始化：

1. 验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS有响应；
2. 发起连接：调用RUBE_MANAGE_CONNECTIONS，传入toolkits: ["conveyor"]；
3. 完成授权：若连接状态不是 ACTIVE，跟随返回的认证链接完成 OAuth 设置；
4. 确认状态：在运行任何工作流前，再次确认连接状态显示为 ACTIVE。

从源码结构看，仓库中的全部 Rube 系技能（几百个*-automation目录）都复用了这一套「验证 → 连接 → 授权 → 确认」的启动序列，区别仅在于 toolkit 名称，因此本流程同样适用于其他技能的初始化排错。

工具发现：用 RUBE_SEARCH_TOOLS 获取动态契约

执行任何 Conveyor 工作流之前，必须先做工具发现。技能的推荐写法如下：

RUBE_SEARCH_TOOLS queries: [{use_case: "Conveyor operations", known_fields: ""}] session: {generate_id: true}

该调用会返回四类关键信息：

• 可用工具的 slug：后续执行时作为tool_slug使用；
• 输入 schema：每个工具的参数结构、字段名与类型；
• 推荐执行计划：针对当前用例的最佳调用顺序；
• 已知陷阱：官方预置的易错点提示。

值得注意的参数语义：

核心工作流：三步标准模式

技能将一次完整的 Conveyor 自动化收敛为「发现 → 校验 → 执行」三步，任何任务都可以套用该骨架。

Step 1：发现可用工具

RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Conveyor task"}] session: {id: "existing_session_id"}

注意此处与前文初始发现的差异：同一工作流内要复用已有的session_id，只有新工作流才生成新 ID。会话贯穿工作流全周期，是后续连接校验与工具执行共用的上下文标识。

Step 2：校验连接

RUBE_MANAGE_CONNECTIONS toolkits: ["conveyor"] session_id: "your_session_id"

执行工具前必须确认连接为 ACTIVE。若连接已失效或从未激活，这一步会暴露问题，避免在错误状态下发起昂贵的 API 调用。

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"

执行时有两个强制要求：

• 参数必须 schema 合规：字段名、类型严格取自 Step 1 的搜索结果，arguments中的占位注释/* schema-compliant args from search results */即指此意；
• 必须携带memory字段：即使没有状态需要传递，也要显式传入空对象{}，省略该字段可能导致调用失败。

RUBE_MULTI_EXECUTE_TOOL的tools是一个数组，意味着单次调用可批量编排多个工具，适合需要多步骤串联的业务场景。

高级能力：批量执行与完整 Schema 获取

当任务规模超出单次调用时，技能提供了两个进阶工具：

RUBE_REMOTE_WORKBENCH+run_composio_tool()：用于批量操作。通过远程工作台以编程方式循环调用run_composio_tool()，适合数据回填、批量更新、批量查询等场景。

RUBE_GET_TOOL_SCHEMAS：当搜索结果返回的工具带有schemaRef引用时，使用该工具拉取完整的工具 Schema。schemaRef通常意味着工具的完整定义没有内联在搜索结果中，需要二次请求展开，用于获取字段级注释、枚举值、嵌套结构等深度信息。

已知陷阱与工程实践

技能明确列出了六条易错点，这既是运行规范，也是排查问题的检查清单：

1. 永远先搜索：工具 schema 会变化，禁止在未调用RUBE_SEARCH_TOOLS的情况下硬编码工具 slug 或参数——这是所有 Rube 系技能的第一原则；
2. 先查连接：执行工具前必须确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE；
3. 严格 schema 合规：字段名与类型必须逐字采用搜索结果中的定义，不要凭直觉推断参数名；
4. memory必须存在：RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory参数，哪怕为空对象{}；
5. 会话复用策略：同一工作流内复用会话 ID，新工作流再生成新 ID，避免上下文串扰；
6. 处理分页：检查响应中是否带有分页 token，有则持续拉取直到数据完整，防止结果被截断。

快速参考表

在仓库生态中的定位

conveyor-automation技能是 awesome-codex-skills 仓库 composio-skills 大规模「应用自动化」技能族的一员。仓库 README.md 说明了 Codex Skills 的通用机制：技能位于$CODEX_HOME/skills（默认~/.codex/skills），每个子目录需包含带name和descriptionfrontmatter 的SKILL.md；Codex 依据 description 与任务描述的匹配度自动触发技能，正文仅在触发后加载以节省上下文。

因此，本文所述的技能既可以直接使用，也是编写其他 Conveyor 业务场景技能的可复用骨架——保持「搜索先行、连接校验、会话复用、分页兜底」四项纪律，即可将任意 Conveyor 操作稳定地纳入 Codex 的自动化工作流。

本文基于 composio-skills/conveyor-automation/SKILL.md 编写，文中所有命令、参数与流程均以该文档及仓库中同类 Rube 技能（如 composio-automation）的当前实现为准。

【免费下载链接】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