企业官网建设流程全解析

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

导读

本文基于 awesome-claude-skills 仓库中的 veo-automation Skill，完整讲解如何让 Claude 等 Agent 通过 Rube MCP 调用 Composio 的 Veo 工具包，实现视频生成任务的自动化。读完本文你将掌握 Rube MCP 的接入方式、Veo 连接的建立与校验、工具发现到执行的三步工作流，以及避免踩坑的关键要点。

一、从 Skill 到工具：三层架构如何让 Agent 真正"动手"生成视频

在深入 Veo 自动化之前，先厘清本项目依赖的三个核心概念。根据仓库 README.md 的说明，Claude Skills 是可复用的指令包，每个 Skill 是一个包含SKILL.md的目录，通过 YAML frontmatter（name、description）声明能力；Skills 本身不是 MCP 服务器，也不是工具——MCP 负责连接外部系统的认证与传输，工具是 Agent 实际调用的函数，而 Skill 定义的是"做什么、按什么顺序做、有什么约束"的工作流。在生产环境中三者协同运行：MCP 提供访问通道，工具执行动作，Skill 约束行为。

veo-automation正是这一架构的典型实践：它是一个 Skill，声明依赖名为rube的 MCP 服务器，通过该通道调用 Composio 暴露的 Veo 工具。其 frontmatter 明确写道：

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

其中description中"Always search tools first for current schemas"（总是先搜索工具以获取当前 schema）是全篇最重要的行为准则，后文会反复强调。

二、前置条件：接入前必须确认的三件事

在执行任何工作流前，veo-automation/SKILL.md 要求确认三项前置条件：

1. Rube MCP 必须已连接：RUBE_SEARCH_TOOLS工具可用；
2. Veo 连接必须处于 ACTIVE 状态：通过RUBE_MANAGE_CONNECTIONS使用veotoolkit 建立连接；
3. 每次执行前先调用RUBE_SEARCH_TOOLS：获取当前最新的工具 schema。

这三项缺一不可：没有 MCP 通道则无法发现工具，连接未激活则工具调用必然失败，而跳过工具发现直接硬编码工具 slug 则是本 Skill 明令禁止的行为。

三、Setup：Rube MCP 接入与 Veo 连接建立

3.1 获取 Rube MCP

Rube MCP 的接入极其轻量——将https://rube.app/mcp作为 MCP server 添加到你的客户端配置即可，无需任何 API Key。这与 Composio 官方 SDK 需要COMPOSIO_API_KEY的方式（参见 connect/SKILL.md 中export COMPOSIO_API_KEY="your-key"的说明）形成对比：Rube 作为网关层屏蔽了密钥管理，客户端只需指向端点即可工作。

3.2 四步连接流程

接入完成后，按以下顺序建立并确认 Veo 连接：

1. 验证 Rube MCP 可用：确认RUBE_SEARCH_TOOLS能正常响应；
2. 调用RUBE_MANAGE_CONNECTIONS，指定 toolkit 为veo；
3. 若连接状态非 ACTIVE：跟随返回的认证链接完成授权设置；
4. 确认连接 ACTIVE：在任何工作流运行之前，务必确保连接状态为 ACTIVE。

四、工具发现：永远先搜索，再执行

本 Skill 将"工具发现"提升为独立步骤，理由是工具 schema 会变化。示例调用如下：

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

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

• 可用工具的 slug（tool slugs）；
• 输入 schema（input schemas）；
• 推荐的执行计划（recommended execution plans）；
• 已知陷阱（known pitfalls）。

session: {generate_id: true}表示由 Rube 为该次搜索生成新的会话 ID；后续工作流内应复用该 ID（详见"会话复用"一节）。known_fields留空表示本次不提供预知字段，完全交由 Rube 检索。

五、核心工作流模式：发现 → 检查 → 执行

整个 Veo 自动化的核心工作流由三个步骤组成，对应三个 Rube 工具调用。

Step 1：发现可用工具

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

与第四节不同，此处在queries.use_case中填入你具体的 Veo 任务描述，并复用既有会话 ID（session: {id: "existing_session_id"}）。搜索结果的tool_slug与argumentsschema 是第三步执行的唯一合法依据。

Step 2：检查连接

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

此步返回当前会话下 Veo 工具包的连接状态。仅当状态为 ACTIVE 时才可继续；若为 PENDING 或其他状态，需回到 Setup 流程完成认证。

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"

RUBE_MULTI_EXECUTE_TOOL支持一次提交多个工具调用（tools为数组）。其中：

• tool_slug必须来自 Step 1 的搜索结果，严禁硬编码；
• arguments必须严格符合搜索结果返回的 schema——字段名、类型都必须精确匹配；
• memory参数必须始终携带，即使为空也要传{}；
• session_id沿用当前工作流会话。

从仓库中同构的 composio-automation/SKILL.md 可以看到，该三步模式在 Composio 系列 Skill 中是统一模板，veo 只是将 toolkit 替换为veo、use_case 替换为 Veo 相关描述，因此熟练掌握后可迁移到仓库内 300+ 个 composio-skills 中的任意一个。

六、已知陷阱：六条必须遵守的规则

veo-automation/SKILL.md 明确列出六条坑点，这些是保证自动化稳定性的硬性约束：

其中"总是先搜索"与"Schema 合规"共同构成一条防御原则：Composio 工具 schema 会随上游 API 演进而更新，只有以搜索结果的实时 schema 为准，才能避免参数不匹配导致的执行失败。

七、快速参考：操作到 Rube 工具的映射

这张表覆盖了从单次调用到批量执行的完整操作面：日常任务用RUBE_MULTI_EXECUTE_TOOL；需要将工具嵌入远端工作台批量运行时用RUBE_REMOTE_WORKBENCH的run_composio_tool()；当搜索返回的工具带schemaRef引用、需要完整 schema 定义时，则调用RUBE_GET_TOOL_SCHEMAS补齐。

八、在仓库中的位置与延伸阅读

veo-automation位于仓库的 composio-skills/ 目录下，与 300+ 个同类自动化 Skill 共享同一套 Rube MCP 模式，例如 composio-automation/SKILL.md、-21risk-automation/SKILL.md 等。它们的前置条件、Setup 步骤、三步工作流与陷阱清单完全一致，仅 toolkit 名称与 use case 描述不同，学习本 Skill 后可举一反三。

想要进一步理解整个生态，可以继续阅读：

• README.md：了解 Claude Skills 的整体定位与 MCP/Skills/Tools 三层关系；
• connect/SKILL.md：了解 Composio 官方 SDK 的接入方式（API Key、pip/npm 安装）与 Skill 层编排思路；
• template-skill/SKILL.md：了解 Skill 的标准文件结构与 frontmatter 规范。

总结

Veo 自动化并非魔法，而是一条纪律严明的流水线：以 Rube MCP 为通道，以RUBE_SEARCH_TOOLS为信息源，以 ACTIVE 连接为前提，以 schema 合规的RUBE_MULTI_EXECUTE_TOOL为执行手段。只要守住"先搜索、再连接、后执行"的顺序与六条陷阱规则，即可稳定、可复用地把 Veo 视频生成任务交给 Agent 全自动完成。

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