企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化

导读

本文以 composio-skills/whautomate-automation/SKILL.md 为核心，讲解如何通过 Rube MCP（Composio 提供的 MCP 端点）连接并自动化 Whautomate 平台的操作。你将掌握从添加 MCP 服务器、建立 ACTIVE 连接、动态发现工具 Schema，到通过RUBE_MULTI_EXECUTE_TOOL安全执行 Whautomate 工具调用的一整套标准化流程，同时了解避免 Schema 硬编码、会话管理与分页处理等关键陷阱。该 Skill 是 awesome-claude-skills 仓库中 "App Automation via Composio" 类别下 78 个 SaaS 应用预构建工作流之一，同类的技能模板还包括 composio-automation 等，它们共享同一套基于 Rube MCP 的自动化范式。

一、前置条件：让 Rube MCP 与 Whautomate 连接就绪

在开始任何自动化流程之前，需要满足三个前置条件（见 SKILL.md 的 Prerequisites 小节）：

1. Rube MCP 已连接：环境必须提供RUBE_SEARCH_TOOLS工具，这是判断 Rube MCP 是否可用的标志；
2. Whautomate 连接为 ACTIVE 状态：需要通过RUBE_MANAGE_CONNECTIONS以 toolkitwhautomate建立并确认连接；
3. 始终先调用RUBE_SEARCH_TOOLS：工具 Schema 会随 API 演进而变化，执行任何操作前都要先获取最新的工具定义。

这三个条件对应了 Skill 前端 YAML 中声明的依赖requires: mcp: [rube]——也就是说，本 Skill 的元信息层面就明确要求宿主 Agent 具备 Rube MCP 能力，这与仓库中其余 Composio 系 Skill（如 composio-automation/SKILL.md 的相同声明）保持一致的约定。

二、Setup：添加 Rube MCP 端点并完成认证

Rube MCP 的接入方式非常轻量：只需在客户端配置中将https://rube.app/mcp添加为 MCP 服务器，无需任何 API Key——添加端点后即可直接使用。随后按以下四步完成连接初始化：

1. 调用RUBE_SEARCH_TOOLS确认 Rube MCP 已正常响应；
2. 调用RUBE_MANAGE_CONNECTIONS，参数指定 toolkit 为whautomate；
3. 若返回的连接状态不是ACTIVE，跟随返回的认证链接完成 Whautomate 账号授权；
4. 在运行任何工作流之前，再次确认连接状态为ACTIVE。

这里需要强调一个核心设计理念：连接管理（连接谁）与工具执行（做什么）是解耦的。RUBE_MANAGE_CONNECTIONS只负责管理 OAuth 授权与连接生命周期，而具体的业务操作由后续的工具执行步骤完成。这种解耦让同一个 Rube MCP 端点可以服务数百个不同的应用 toolkit（仓库 README 的 App Automation via Composio 一节即描述了这套预构建技能体系），而每个 Skill 只需声明自己依赖的 toolkit 名称即可。

三、Tool Discovery：先搜索，再执行

Whautomate 自动化遵循"搜索优先（Search First）"原则。由于 Composio 的工具列表与输入 Schema 会持续更新，硬编码工具 slug 或参数会导致执行失败，因此第一步永远是动态发现。文档给出了标准的发现请求：

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

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

• 可用工具的 slug（如 Whautomate 相关的各类操作标识符）；
• 输入 Schema（每个工具要求的字段名、类型与格式）；
• 推荐的执行计划（针对目标用例的编排建议）；
• 已知陷阱（Composio 根据经验标注的常见错误点）。

第一次发起时使用session: {generate_id: true}让服务端生成新的会话 ID；而在同一工作流内部，后续调用则应复用已有会话 ID（见下文"会话管理"）。

四、Core Workflow Pattern：三步标准工作流

文档给出了一个可复用的三步执行模式，这也是使用本 Skill 的核心骨架：

Step 1：发现可用工具

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

将use_case替换为具体的 Whautomate 任务描述（例如针对某个业务对象的增删改查场景），复用当前工作流的existing_session_id。

Step 2：检查连接状态

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

在执行任何业务工具前，通过此调用确认 Whautomate 连接仍为ACTIVE。若认证过期或已断开，需重新走认证流程。

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参数必须始终携带，即使为空也要传{}；
• session_id复用当前工作流的会话 ID。

RUBE_MULTI_EXECUTE_TOOL支持在tools数组中同时传入多个工具调用，因此可以在一次请求中编排一组 Whautomate 操作序列，实现多步骤业务的原子化编排。

五、Known Pitfalls：六个必须规避的常见陷阱

文档明确列出了自动化过程中的六个高发陷阱，实操中应逐条对照：

1. 永远先搜索：工具 Schema 会变化，未经RUBE_SEARCH_TOOLS确认就硬编码工具 slug 或参数是最大的失败来源；
2. 检查连接：执行工具前必须通过RUBE_MANAGE_CONNECTIONS确认ACTIVE状态，防止在断连状态下产生无效调用；
3. Schema 合规：严格使用搜索结果中的字段名与类型，任何偏差（如类型错误、字段缺失）都会导致工具执行失败；
4. memory 参数：RUBE_MULTI_EXECUTE_TOOL的调用必须始终包含memory，即使为空（{}），否则调用可能因缺参而报错；
5. 会话复用：同一工作流内复用会话 ID 以保持上下文连续；开启新工作流时再生成新 ID；
6. 分页处理：检查响应中的分页 token，持续翻页直到数据拉取完整，避免遗漏后续批次的数据。

这六条陷阱并非 Whautomate 独有——对比 composio-automation/SKILL.md 可以看到完全一致的清单，说明它们是整个 Rube MCP 自动化体系通用的防御性编程规范。

六、Quick Reference：操作速查表

文档末尾提供了一张速查表，概括了五种典型操作的正确姿势：

其中两点值得展开说明：

• RUBE_REMOTE_WORKBENCH+run_composio_tool()：当需要执行大批量、重复性的 Whautomate 操作时，可将执行逻辑放入远程工作台环境中批量运行，避免逐次发起 MCP 调用带来的上下文开销；
• RUBE_GET_TOOL_SCHEMAS：部分工具的 Schema 通过schemaRef引用外部定义，若搜索结果的摘要不够完整，可用此工具拉取全量 Schema 以确保参数构造准确。

七、从 Skill 文档到可落地的 Agent 工作流

综合上述内容，一个完整的 Whautomate 自动化任务在 Agent 侧的落地方案可以概括为如下流水线：

1. 引导阶段：确认RUBE_SEARCH_TOOLS可用 → 通过RUBE_MANAGE_CONNECTIONS建立并验证whautomate连接为ACTIVE；
2. 规划阶段：调用RUBE_SEARCH_TOOLS获取工具 slug、输入 Schema 与执行建议，据此构造参数；
3. 执行阶段：通过RUBE_MULTI_EXECUTE_TOOL（或批量场景下的RUBE_REMOTE_WORKBENCH）执行工具调用，始终携带memory并复用会话 ID；
4. 收尾阶段：检查响应中的分页 token 以拉全数据，记录本工作流会话 ID 以备复用。

这套模式的优势在于：无需维护任何应用相关的硬编码知识，所有工具定义与认证状态都通过 Rube MCP 在运行时动态获取，因此即使 Whautomate 侧的 API 或 Composio 的工具集发生变更，只要遵循"先搜索、后执行"的纪律，Agent 也能自动适应。从仓库结构看，composio-skills 目录下上百个同构 Skill 均采用这一范式，本技能文档即是这套方法论在 Whautomate 场景下的标准实践模板，可直接作为 Claude Code 等支持 Skills 标准的 Agent 的指令包加载使用。

本文内容依据 composio-skills/whautomate-automation/SKILL.md 整理，并结合仓库内 composio-skills/composio-automation/SKILL.md 及 README.md 中的同构说明交叉印证。

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化