基于 Rube MCP 的 Neutrino 自动化：awesome-claude-skills 技能实战指南

本指南以仓库中的 composio-skills/neutrino-automation/SKILL.md 为骨架，讲解如何通过 Composio 的 Rube MCP 网关驱动 Neutrino 工具包，让 Claude 直接执行 Neutrino 相关的 API 操作。读完本文，你将掌握 Rube MCP 的接入方式、RUBE_SEARCH_TOOLS 工具发现流程、RUBE_MANAGE_CONNECTIONS 连接管理，以及一套可复用的「搜索 → 检查连接 → 执行」三步自动化工作流，并避开常见的 schema 失效、会话管理、分页等坑。

一、技能定位：Neutrino 工具包 × Rube MCP

neutrino-automation 是 awesome-claude-skills 仓库 composio-skills/ 目录下、为 78 个 SaaS 应用预构建的工作流技能之一（见 README.md）。它的核心职责是：通过 Composio 的 Neutrino 工具包（toolkit 名为 neutrino）自动化 Neutrino 相关操作，并以 Rube MCP 作为中间网关完成工具发现、连接管理与工具执行。

技能文件的 YAML frontmatter 清晰声明了它的身份与依赖：

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

其中两个关键设计点值得注意：

• description 中的 "Always search tools first"：这不是泛泛的提示语，而是整个技能的运行铁律——工具 schema 会随版本变化，任何工作流的第一步都必须是动态发现，而非硬编码。
• requires.mcp: <a href="https://link.gitcode.com/i/e7ccd3932e7c02b07d295693831c67a4" target="_blank">rube]：声明该技能强依赖 Rube MCP 服务器，这与仓库 [skill-creator/SKILL.md 中「技能元数据决定 Claude 何时调用它」的规范一致——元数据既告诉 Agent 该技能做什么，也告诉它依赖什么外部连接。

二、前置条件

在运行任何 Neutrino 自动化工作流之前，需要满足三项前置条件：

1. Rube MCP 已连接：环境中必须可用 RUBE_SEARCH_TOOLS 工具，这是后续所有工具发现的入口。
2. Neutrino 连接处于 ACTIVE 状态：通过 RUBE_MANAGE_CONNECTIONS 建立并激活 toolkit 为 neutrino 的连接。
3. 先搜索、后执行：任何时候都要先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema，再决定使用哪个工具 slug 与参数。

这三条是有因果顺序的：没有 Rube MCP 就没有工具入口；没有激活的 Neutrino 连接，工具执行会失败；不搜索 schema 就执行，则可能因为 API 变更而调用无效工具。

三、环境配置：接入 Rube MCP

Rube MCP 的接入非常轻量，无需申请 API key：

在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器即可，无需任何 API key——添加端点后即可直接使用。

接入后按以下 4 步完成连接初始化：

1. 验证 Rube MCP 可用——确认 RUBE_SEARCH_TOOLS 有响应；
2. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 参数传入 neutrino；
3. 如果连接状态不是 ACTIVE，跟随返回的认证链接完成授权设置；
4. 在运行任何工作流之前，确认连接状态已显示为 ACTIVE。

这 4 步构成了一个「先验证、再建连、后确认」的安全启动流程，避免在连接未就绪时浪费执行调用。

四、工具发现：永远从 RUBE_SEARCH_TOOLS 开始

执行任何 Neutrino 工作流之前，必须先做工具发现。标准发现调用如下：

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

该调用的返回内容非常丰富，包括：

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

其中 session.generate_id: true 表示让服务端生成一个新的会话 ID，适用于工作流起步阶段；后续步骤则复用该 ID 以保持上下文。

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

技能文档给出了标准的 Neutrino 自动化三步模式，可以直接套用到大多数任务上。

Step 1：发现可用工具

用具体任务描述作为 use_case，并在已有会话中继续：

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

注意这里传入的是 existing_session_id，即复用上一步生成的会话 ID，保证工具发现与后续执行处于同一会话上下文。

Step 2：检查连接

执行工具前再次确认 Neutrino 连接状态：

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

连接必须是 ACTIVE 状态，否则后续执行会因未授权而失败。

Step 3：执行工具

拿到工具 slug 并确认连接后，通过 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：必须来自 RUBE_SEARCH_TOOLS 的搜索结果，绝不能凭记忆硬编码；
• arguments：必须严格符合搜索结果返回的 schema，字段名与类型都不能想当然；
• memory：即使为空也必须包含该参数（{}），这是技能文档明确强调的约定。

RUBE_MULTI_EXECUTE_TOOL 支持在 tools 数组中传入多个工具调用，适合批量执行同一工作流中的多个步骤。

六、已知陷阱清单

技能文档总结了 6 条经过实战验证的注意事项，是规避失败的关键：

1. 永远先搜索：工具 schema 会变。不调用 RUBE_SEARCH_TOOLS 就硬编码 tool slug 或参数，是最大的错误来源；
2. 检查连接：执行前必须确认 RUBE_MANAGE_CONNECTIONS 显示 ACTIVE 状态；
3. Schema 合规：严格使用搜索结果中的精确字段名与类型；
4. Memory 参数：RUBE_MULTI_EXECUTE_TOOL 调用中始终携带 memory，即使是空对象 {}；
5. 会话复用：同一工作流内复用会话 ID，新工作流再生成新的 ID；
6. 分页处理：检查响应中是否包含分页 token，有则持续拉取直到数据完整。

第 5、6 条尤其容易被忽视：会话 ID 决定了工具发现、连接检查与执行是否共享上下文；分页 token 则决定批量数据是否被完整获取。

七、快速参考表

下表浓缩了 Neutrino 自动化的全部关键操作，可作为日常开发速查：

操作	方式
查找工具	RUBE_SEARCH_TOOLS，传入 Neutrino 相关 use case
建立连接	RUBE_MANAGE_CONNECTIONS，toolkit 传 neutrino
执行工具	RUBE_MULTI_EXECUTE_TOOL，使用搜索发现的 tool slug
批量操作	RUBE_REMOTE_WORKBENCH，配合 run_composio_tool()
完整 schema	RUBE_GET_TOOL_SCHEMAS，用于带 schemaRef 的工具

其中两个补充入口值得关注：

• RUBE_REMOTE_WORKBENCH：当需要执行批量操作时，可在远程工作台中通过 run_composio_tool() 编程式调用 Composio 工具，适合流程化、可脚本化的场景；
• RUBE_GET_TOOL_SCHEMAS：当搜索结果中的工具带 schemaRef（即 schema 以引用形式给出）时，用它拉取完整 schema，补齐执行所需的全部参数定义。

八、在仓库中的使用上下文

neutrino-automation 并非孤立存在。它遵循与 composio-skills/ 目录下所有技能（如 composio-automation/SKILL.md、composio-search-automation/SKILL.md）完全一致的模板：同样的 frontmatter 结构、同样的三步工作流、同样的陷阱清单与快速参考表。这种一致性意味着：掌握本文的三步执行法与陷阱清单后，可以无障碍迁移到其他 77 个 SaaS 应用的自动化技能上，只需把 toolkit 名从 neutrino 换成对应应用的名称。

从 README.md 可以确认，这批技能的设计目标正是「包含工具序列、参数指引、已知陷阱与快速参考表，且全部使用从 Composio API 实际发现的工具 slug」——即技能本身是动态 schema 时代的产物，强调「先发现、后执行」而非静态编写。

作为 Claude Skill，它的装载方式与其他技能一致：将技能目录放入 Claude Code 的 ~/.config/claude-code/skills/ 后，Claude 会根据会话任务自动判断相关性并加载执行（详见 README.md 的 Getting Started 部分）。由于技能采用渐进式加载设计——元数据常驻上下文、SKILL.md 正文按需加载——这类包含完整工作流说明的技能不会显著膨胀上下文窗口。

总结

neutrino-automation 技能的价值在于它把「连接第三方 API → 发现工具 → 校验连接 → 执行 → 处理分页」这一整套自动化流程固化成了可复用的技能指令。实战中的核心纪律只有一条：永远不要跳过 RUBE_SEARCH_TOOLS。schema 是动态的，连接需要显式激活，会话需要复用，memory 必须携带，分页需要拉满——遵守这五条纪律，Neutrino 自动化工作流就能稳定、可靠地运行在 Rube MCP 之上。