企业官网建设流程全解析

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

导读

本文以 composio-skills/godial-automation/SKILL.md 为骨架，完整讲解如何在 Claude 环境中通过 Rube MCP（Composio 的托管 MCP 网关）发现、连接并执行 Godial 的各类操作。读完本文，你将掌握一套可复制的「先搜索工具 → 再检查连接 → 最后执行调用」三阶段自动化范式，理解RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等核心工具的正确用法，以及 Schema 合规、会话复用、分页处理等关键注意事项。

Godial 自动化技能是什么

Godial 是 Composio 支持的一类业务应用（Toolkit）。在本仓库中，godial-automation是 composio-skills 目录下数百个「应用自动化」技能之一，与其他技能（如composio-automation、composio-search-automation）共用同一套 Rube MCP 调用模式，只是将目标工具箱替换为godial。

该技能的定位非常明确：不要硬编码任何工具参数，而是让 Claude 在每次执行前先通过 Rube MCP 动态发现 Godial 当前的可用工具与输入 Schema，从而对抗上游 API 的频繁变更。技能的前置声明（YAML frontmatter）也写明了触发条件：

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

其中requires: mcp: [rube]表明该技能运行时必须挂载名为rube的 MCP 服务器，这是整个自动化链路的基础依赖。

前置条件

在开始任何 Godial 自动化流程之前，需要满足三项前置条件：

1. Rube MCP 已连接：会话中必须存在RUBE_SEARCH_TOOLS工具，否则无法发现任何 Godial 工具；
2. Godial 连接处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS以 toolkitgodial建立的活动连接；
3. 始终先调用RUBE_SEARCH_TOOLS：获取最新的工具 Schema，再据此构造调用参数。

这三条顺序不可颠倒——先有网关，再有连接，最后才谈执行。

环境搭建：接入 Rube MCP

Rube MCP 的接入非常轻量，无需申请 API Key，只需在客户端配置中把https://rube.app/mcp添加为 MCP 服务器即可。这是它与传统 Composio 直连方式（如 connect/SKILL.md 中通过COMPOSIO_API_KEY+session.mcp.url的方式）最主要的区别：连接信息由 Rube 托管，客户端侧零密钥管理。

接入后按以下 4 步完成连接验证：

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

工具发现：先搜索，再动手

Rube MCP 的核心设计理念是「动态 Schema 发现」。由于工具别名（tool slug）、输入参数乃至推荐执行计划都可能随 Godial 侧更新而变化，技能强制要求每次工作流开始前执行一次发现动作：

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

一次典型的RUBE_SEARCH_TOOLS调用会返回四类信息：

• 可用工具别名列表（tool slugs）：当前 Godial 工具箱对外开放的工具标识；
• 输入 Schema：每个工具的参数定义，含字段名、类型与必填约束；
• 推荐执行计划：针对目标用例（use_case）的官方建议调用顺序；
• 已知陷阱（known pitfalls）：官方标注的常见错误与规避方式。

首次发现时使用generate_id: true生成新会话；同一工作流内的后续查询复用已有session.id（见下文「会话管理」）。

核心工作流：三阶段调用模式

技能定义了一条固定的三阶段执行路径，任何 Godial 任务都按此展开。

第一步：发现可用工具

针对具体任务重新定向搜索，缩小范围：

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

将use_case替换为实际任务描述（例如创建联系人、拉取通话记录、管理跟进任务等），并复用上一阶段生成的会话 ID。这一步的输出决定了后续tool_slug与arguments的取值，绝不能跳过。

第二步：检查连接状态

执行前确认授权仍然有效：

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

返回结果中的连接状态必须为ACTIVE。若已失效，需要按返回的认证链接重新完成授权——这正是自动化流程中最常见的断点之一，提前检查可避免执行中途失败。

第三步：执行工具

将搜索到的工具别名与 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"

要点解读：

• tool_slug必须来自第一步的搜索结果，禁止硬编码；
• arguments中的字段名与类型必须与搜索返回的 Schema 完全一致（见下文「Schema 合规」）；
• memory参数必须始终携带，即使为空也要传{}；
• session_id贯穿同一工作流全程，保证上下文连续。

进阶用法：批量操作与完整 Schema

当单个任务需要批量执行多个 Godial 工具时，技能提供了两条进阶路径：

• 批量操作：使用RUBE_REMOTE_WORKBENCH，在其远程执行环境中通过run_composio_tool()函数驱动工具调用，适合需要循环、条件判断等编排逻辑的场景；
• 完整 Schema 获取：当搜索结果的 Schema 信息不完整（存在schemaRef引用标记）时，调用RUBE_GET_TOOL_SCHEMAS拉取对应工具的完整定义。

这两者与前三步配合，构成完整的工具链：RUBE_SEARCH_TOOLS（发现）→RUBE_GET_TOOL_SCHEMAS（补全 Schema）→RUBE_MANAGE_CONNECTIONS（授权）→RUBE_MULTI_EXECUTE_TOOL（执行）→RUBE_REMOTE_WORKBENCH（复杂批量编排）。

已知陷阱与规避清单

技能将长期实践中踩过的坑总结为 6 条硬性规则：

其中「分页」是最容易被忽略的一环：Godial 的列表类操作（如通话记录、联系人列表）可能返回多页结果，若只消费第一页会造成数据不全，务必检查响应并继续获取后续页。

快速参考速查表

技能末尾提供了面向日常操作的速查表，可直接对照使用：

模式复用：这套范式不止于 Godial

值得注意的是，本文所述的三阶段模式并非 Godial 独有，而是整个 composio-skills 目录的统一范式。对照同目录下的 composio-automation/SKILL.md、composio-search-automation/SKILL.md 可以看到，除toolkits值（godial/composio/composio_search）与use_case描述不同外，前置条件、发现、连接、执行、陷阱清单与速查表结构完全一致。这意味着：

• 学会本技能即可举一反三，接入 Composio 生态中的任意应用工具箱；
• 从仓库结构看，composio-skills/下数百个*-automation目录均采用同款 SKILL.md 模板（每个目录仅含一个 SKILL.md 文件），构成一套可规模化复制的「应用自动化技能工厂」。

这套模式之所以采用「先搜索后执行」的强约束，核心原因在于 Composio 托管了上千个应用的 API 适配层，工具定义随上游迭代频繁变化；动态发现机制让技能在任何时刻都能拿到权威的最新 Schema，从而兼顾了鲁棒性与可维护性。

总结

Godial 自动化技能给出了一条清晰、可验证的执行链：接入 Rube MCP → 发现 Godial 工具 → 建立 ACTIVE 连接 → Schema 合规地执行调用 → 正确处理分页与会话。本文所述的所有命令与参数均来自 composio-skills/godial-automation/SKILL.md 原文，可在仓库中直接复核；结合 README.md 对 Claude Skills 加载机制与 MCP/工具/技能三层架构的说明，以及 connect/SKILL.md 对 Composio 授权链路的补充介绍，读者可以从「技能指令」一路追到「网关层机制」，形成完整的认知闭环。

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