企业官网建设流程全解析

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

本文以 composio-skills/emailoctopus-automation/SKILL.md 为技术主线，讲解如何在 Claude 生态（Claude.ai / Claude Code / Claude API）中接入 EmailOctopus 自动化：只需添加一个 Rube MCP 端点，即可让 Claude 直接操作 EmailOctopus 的订阅者、邮件列表、营销活动与自动化等能力。读完本文，你将掌握 Rube MCP 的接入方式、工具发现机制、"搜索工具 → 检查连接 → 执行调用"的标准三步工作流，以及规避常见坑位的实战要点。

一、Skill 定位：一个开箱即用的 EmailOctopus 工作流指南

该 Skill 是 awesome-claude-skills 仓库中composio-skills/预构建自动化系列的一员。仓库 README.md 中 "App Automation via Composio" 一节明确说明：这一系列是为各 SaaS 应用预构建的工作流 Skill，均通过 Rube MCP（Composio）运行，每个 Skill 都包含真实的工具序列、参数指导、已知陷阱和快速参考表，并全部使用从 Composio API 实际发现到的工具 slug。

与仓库内其他 Skill（如 composio-automation/SKILL.md）一致，EmailOctopus Automation Skill 的SKILL.md使用 YAML frontmatter 声明元数据：

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

requires: mcp: [rube]意味着该 Skill 的运行前提是环境中存在名为rube的 MCP 服务器——Skill 本身不提供工具，而是指导 Claude如何使用 Rube MCP 暴露出的工具去操作 EmailOctopus。这与仓库 README.md 中对 Skills 的定位一致：Skill 定义的是"做什么、按什么顺序做、带什么护栏"的工作流，而连接与工具能力由 MCP 提供。

二、前置条件与连接建立

2.1 前置条件

在让 Claude 执行任何 EmailOctopus 操作前，需要满足三个条件：

• Rube MCP 已连接：环境中有RUBE_SEARCH_TOOLS可用，说明 MCP 服务器已注册成功；
• EmailOctopus 连接已激活：通过RUBE_MANAGE_CONNECTIONS并指定 toolkit 为emailoctopus，且连接状态为 ACTIVE；
• 每次先做工具发现：调用RUBE_SEARCH_TOOLS获取当前最新的工具 schema，切勿跳过。

2.2 安装 Rube MCP

接入方式极其简单，官方文档给出的方案是：在客户端配置中将https://rube.app/mcp添加为一个 MCP 服务器，无需任何 API Key，添加端点即可生效。

配置完成后，按以下顺序完成 EmailOctopus 的连接初始化：

1. 通过确认RUBE_SEARCH_TOOLS有响应，验证 Rube MCP 已就绪；
2. 调用RUBE_MANAGE_CONNECTIONS，toolkit 参数传入emailoctopus；
3. 若连接状态不是 ACTIVE，按返回的认证链接完成授权设置（OAuth 流程由 Composio 处理，connect/SKILL.md 中描述的"首次使用某应用时点击授权链接完成授权，之后连接持续有效"的机制在此同样适用）；
4. 在运行任何工作流之前，再次确认连接状态为 ACTIVE。

2.3 工具发现（Tool Discovery）

连接建立后，先执行工具发现请求，获取当前可用的 EmailOctopus 工具清单：

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

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

• 可用的工具 slug（tool slugs）；
• 每个工具的输入 schema（input schemas）；
• 推荐的执行计划（recommended execution plans）；
• 已知的坑位提示（known pitfalls）。

这是整个 Skill 设计的核心约束：工具 schema 会随 Composio API 变化，因此任何一次工作流执行前都必须先做工具发现，绝不能硬编码工具 slug 或参数。

三、核心工作流模式：三步执行法

该 Skill 为所有 EmailOctopus 任务定义了统一的三步工作流，下面逐一给出可复制的请求体。

Step 1：发现可用工具

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

把use_case替换为具体的 EmailOctopus 任务描述（例如"为邮件列表新增订阅者""创建营销活动"）。与首次发现不同，这里复用已有会话 ID，保持同一工作流内的会话连续性。

Step 2：检查连接状态

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

执行工具之前，必须确认返回的连接状态为 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 搜索结果的真实 slug，不要凭记忆或文档硬编码；
• arguments必须严格符合 Step 1 返回的 schema——字段名与类型以搜索结果为准；
• memory参数必须始终包含，即使为空也要传{}；
• session_id复用工作流内已有的会话 ID。

RUBE_MULTI_EXECUTE_TOOL支持在一个请求中传入多个工具调用（tools是数组），因此可以在单次往返中编排"先查列表、再新增订阅者"这类组合操作。

四、进阶能力：批量执行与全量 Schema

对于批量操作与完整 schema 需求，该 Skill 的快速参考还给出了两个进阶工具：

• RUBE_REMOTE_WORKBENCH：适用于批量操作，配合run_composio_tool()使用。当需要循环处理大量记录（如批量导入/更新订阅者）时，可在远程工作台环境中逐项调用 Composio 工具；
• RUBE_GET_TOOL_SCHEMAS：当搜索结果中某些工具带有schemaRef引用时，用该工具获取完整的 schema 定义，适合需要对参数做精细化控制的高级场景。

五、已知陷阱与最佳实践

该 Skill 总结了六条关键注意事项，全部来自真实执行经验的沉淀：

1. 始终先搜索（Always search first）：工具 schema 会变化。未经RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数，是失败的首要原因；
2. 检查连接（Check connection）：执行前确认RUBE_MANAGE_CONNECTIONS返回 ACTIVE；
3. Schema 合规（Schema compliance）：严格使用搜索结果中的精确字段名与类型，任何拼写或类型偏差都会导致调用失败；
4. Memory 参数（Memory parameter）：RUBE_MULTI_EXECUTE_TOOL的调用中始终携带memory，哪怕为空对象{}；
5. 会话复用（Session reuse）：同一工作流内复用 session ID，新工作流再生成新的 session，保证上下文连续且相互隔离；
6. 分页处理（Pagination）：检查响应中的分页 token，持续拉取直至数据完整，防止批量场景漏数据。

六、快速参考表

七、在仓库中的定位与延伸

该 Skill 不是孤立的：它属于仓库composio-skills/目录下大量同构的自动化 Skill 之一。以 composio-automation/SKILL.md 为例，其结构（Prerequisites / Setup / Tool Discovery / Core Workflow Pattern / Known Pitfalls / Quick Reference）与 EmailOctopus 版本完全一致——这种模板化设计使得开发者学会一个 Skill 后，可以无障碍迁移到其余所有 Composio 自动化 Skill。README 中 "App Automation via Composio" 一节将 EmailOctopus Automation 归于Email类别，与 Gmail、Outlook、Postmark、SendGrid 等邮件应用自动化 Skill 并列。

如果需要更宏观地理解 Skill 在 Claude 生态中的运行机制，可参阅 README.md 的 "What Are Claude Skills?" 一节：Skill 不是 MCP 服务器、也不是工具，而是定义"在拥有连接和工具之后的行为规范"；生产环境中三者协同——MCP 提供访问能力、工具提供动作、Skill 提供行为准则。这正是本文所讲 Skill 的设计哲学：让 Claude 不只会"起草一封 EmailOctopus 邮件"，而是真正完成"连接 → 发现 → 执行"的闭环动作。

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