企业官网建设流程全解析

使用 Piggy Automation Skill 通过 Rube MCP 实现 Piggy 工作流自动化

【免费下载链接】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/piggy-automation/SKILL.md 为骨架，完整讲解如何在 Codex CLI/API 环境中，通过 Rube MCP（Composio 提供的 MCP 网关）驱动 Composio 的 Piggy toolkit 完成业务操作自动化。读完本文，你将掌握 Rube MCP 的接入方式、Piggy 连接的生命周期管理、"先发现工具、再校验连接、最后执行"的三步工作流范式，以及避免踩坑的关键守则，可直接在 Codex 会话中复现整套流程。

Skill 定位与触发机制

Piggy Automation 是 awesome-codex-skills 仓库 composio-skills 目录下的一个 Codex Skill。其核心定位写在 SKILL.md 的 YAML frontmatter 中：

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

从仓库根目录 README.md 对 Codex Skills 的说明可以确认：name与description是 Codex 判断何时触发该 Skill 的唯一元数据；当用户请求涉及 Piggy 相关任务且 Rube MCP 已连接时，Codex 会加载正文指令执行。requires.mcp: [rube]声明了该 Skill 运行时的硬性依赖——本 Skill 不直接调用 Piggy REST API，而是通过 Rube MCP 暴露的RUBE_*工具间接执行，这正是它"永远先搜索工具 schema"这一设计原则的由来。

前置条件

在触发该 Skill 之前，需要满足以下三项条件（对应原文档 Prerequisites 小节）：

1. Rube MCP 已连接：客户端环境中可调用RUBE_SEARCH_TOOLS；
2. Piggy 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS以 toolkit 标识piggy建立并激活；
3. 每次执行前先调RUBE_SEARCH_TOOLS：获取当前最新的工具 schema，禁止凭记忆硬编码工具 slug 或参数。

接入 Rube MCP

原文档明确指出：Rube MCP 的接入极其轻量——只需在 MCP 客户端配置中把https://rube.app/mcp添加为 MCP server，无需申请 API key，添加端点即可使用。这是整个自动化的通信基础：Rube 作为统一网关，把 Piggy toolkit 的数百个动作（action）映射为可供 Codex 调用的RUBE_*工具。

完成端点添加后，按以下顺序完成连通性验证（对应原文档 Setup 四步）：

1. 调用RUBE_SEARCH_TOOLS，确认其有响应；
2. 调用RUBE_MANAGE_CONNECTIONS，传入 toolkitpiggy；
3. 若连接状态不是 ACTIVE，则跟随返回的授权链接（auth link）完成第三方账号授权；
4. 在所有工作流开始前，再次确认连接状态显示为 ACTIVE。

建立并激活 Piggy 连接

连接管理统一由RUBE_MANAGE_CONNECTIONS负责。建立连接的调用示例（对应原文档 Core Workflow Pattern 第 2 步）：

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

要点：

• toolkits使用数组形式，即使只连接一个 toolkit 也要以["piggy"]传入；
• 若返回的 status 不是ACTIVE，说明尚未完成 OAuth 授权，需打开返回的 auth link 完成授权；
• 会话内后续所有工具执行都应复用同一个session_id，保证连接与执行上下文的连续性。

工具发现：永远先搜 schema

这是整个 Skill 最核心的纪律。由于 Piggy toolkit 的工具 schema 会随服务端版本演进，任何硬编码都可能因字段改名、参数增删而失效。因此每次工作流启动前必须执行工具发现（对应原文档 Tool Discovery 小节）：

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

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

• 可用工具的 tool slug 列表：后续RUBE_MULTI_EXECUTE_TOOL中tool_slug字段的取值来源；
• 输入 schema：每个工具参数的字段名、类型与必填约束；
• 推荐的执行计划：Rube 根据 use_case 给出的编排建议；
• 已知陷阱（known pitfalls）：针对该 use_case 的常见错误提示。

session.generate_id: true用于在工作流起始时生成新的会话 ID；而在同一工作流内部的后续发现请求中，应改为复用已有会话：session: {id: "existing_session_id"}。

核心工作流模式（三步范式）

结合原文档 Core Workflow Pattern，一个标准的 Piggy 自动化任务严格遵循三步：

第 1 步：发现可用工具

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

将use_case替换为具体的业务描述（如 Piggy 的转账、查询余额、账单管理等具体操作场景），从返回结果中确定本次要用的tool_slug及参数 schema。

第 2 步：校验连接

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

确认连接状态为 ACTIVE 后再继续，避免执行阶段因未授权而失败。

第 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必须来自第 1 步搜索结果，而不是凭记忆填写；
• arguments的字段名、类型、枚举值必须与搜索结果 schema 完全一致；
• memory参数必须显式携带，即使无跨工具状态需要传递，也要传空对象{}。

RUBE_MULTI_EXECUTE_TOOL支持在tools数组中一次编排多个工具调用，适合串联执行多步骤业务操作；memory则用于在多次调用之间传递状态，支撑有上下文依赖的复合流程。

批量操作与完整 Schema 获取

对于批量或需要更强控制力的场景，原文档 Quick Reference 表补充了另外两个入口：

• RUBE_REMOTE_WORKBENCH：用于批量操作（Bulk ops），在远端工作台环境中通过run_composio_tool()编程式地循环执行多次工具调用，适合需要对同一工具跑大批量任务、且希望减少往返次数的场景；
• RUBE_GET_TOOL_SCHEMAS：当搜索结果中的工具带有schemaRef引用时，调用它获取该工具的完整 schema 定义，用于确认嵌套参数结构、复杂对象字段等细节，确保参数组装精确无误。

五个RUBE_*工具各司其职：RUBE_SEARCH_TOOLS负责发现、RUBE_MANAGE_CONNECTIONS负责连接、RUBE_MULTI_EXECUTE_TOOL负责常规执行、RUBE_REMOTE_WORKBENCH负责批量执行、RUBE_GET_TOOL_SCHEMAS负责深度 schema 查询。这套分工在仓库其他 composio-skills（如 composio-automation/SKILL.md）中完全一致，属于该系列 Skill 的通用架构，可相互印证。

已知陷阱与规避守则

原文档 Known Pitfalls 小节给出的六条守则，每一条都对应一类真实失败模式：

快速参考速查表

原文档 Quick Reference 表是日常使用的浓缩索引，完整继承如下：

建议把此表作为编写触发指令时的对照清单：任何 Piggy 任务都按"Find → Connect → Execute"的主链路组织，批量场景升级为RUBE_REMOTE_WORKBENCH，复杂嵌套参数场景补充RUBE_GET_TOOL_SCHEMAS。

将 Skill 安装到 Codex

本 Skill 作为仓库的一部分，可通过仓库提供的 skill-installer 安装到本地 Codex 环境。安装方式为把 composio-skills/piggy-automation 目录复制到$CODEX_HOME/skills/（默认~/.codex/skills/），重启 Codex 使其加载 frontmatter 元数据；之后在会话中自然描述 Piggy 相关任务，Codex 会根据description自动触发该 Skill。安装完成后仍需按本文"前置条件"一节接入 Rube MCP 并激活 Piggy 连接，Skill 才能真正跑通。

从 skill-creator/SKILL.md 对 Skill 加载机制的说明可以看出，本 Skill 遵循了"渐进式披露"的设计：frontmatter 元数据常驻上下文用于触发，正文（本文所讲解的全部指令）仅在触发后加载，因此它在保持上下文精简的同时，为 Codex 提供了完整、可执行的自动化规程——这正是该 Skill 可以在真实 Piggy 业务中稳定复用的根本原因。

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