基于 Rube MCP 的 Simplesat 自动化实战指南（awesome-claude-skills）

导读

本指南讲解如何基于 awesome-claude-skills 仓库中的 simplesat-automation 技能，通过 Composio 的 Simplesat 工具集（toolkit）与 Rube MCP 完成客户满意度调查平台 Simplesat 的端到端自动化。你将掌握 Rube MCP 的接入方式、RUBE_SEARCH_TOOLS 动态工具发现、连接状态管理、RUBE_MULTI_EXECUTE_TOOL 执行模式以及完整的避坑清单，可独立复现「发现工具 → 校验连接 → 执行操作」的标准化工作流，并推广到同一仓库中其他 77 个 SaaS 应用技能。

Simplesat 自动化技能概述

simplesat-automation 是 awesome-claude-skills 仓库中「App Automation via Composio」系列技能之一。该系列为 78 个 SaaS 应用提供了预构建的工作流技能，每个技能都包含工具调用序列（tool sequences）、参数指导（parameter guidance）、已知陷阱（known pitfalls）与速查表（quick reference tables），且全部使用从 Composio API 实际发现的真实工具 slug（real tool slugs）编写（见 README.md）。

本技能的文件结构遵循 Anthropic Skills 开放标准：一个目录包含 SKILL.md 文件，其中 YAML frontmatter 声明技能元数据，Markdown 正文承载操作指令。按 README.md 的说明，Skills 采用渐进式加载：会话启动时 Agent 只看到每个技能的 name 与 description（约 100 tokens），当判断技能与当前任务相关时才加载完整的 SKILL.md 正文。这意味着将本技能加入 Agent 配置后，并不会显著占用上下文窗口。

技能 frontmatter 的声明如下（composio-skills/simplesat-automation/SKILL.md）：

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

其中 requires.mcp: [rube] 明确了运行前提：必须挂载 Rube MCP 服务器，而 description 中 "Always search tools first" 则点出了整个技能的核心方法论——一切操作前先做工具发现。

前置条件

在执行任何 Simplesat 工作流之前，需要确认以下三个前置条件（SKILL.md）：

1. Rube MCP 已连接：RUBE_SEARCH_TOOLS 工具必须可用；
2. Simplesat 连接处于 ACTIVE 状态：通过 RUBE_MANAGE_CONNECTIONS 建立并激活 toolkit 为 simplesat 的连接；
3. 先搜索再执行：每次任务开始前必须调用 RUBE_SEARCH_TOOLS 获取最新的工具 schema。

第三条是本技能（也是整个 composio-skills 系列）的纪律性要求：Composio 侧的工具 schema 会随 API 演进而变化，硬编码工具 slug 或参数名必然导致调用失败。

环境搭建：接入 Rube MCP

Rube MCP 是 Composio 提供的 MCP 服务器端点，接入方式极为简单——在客户端（Claude Code、Claude.ai 等）的 MCP 配置中直接添加端点地址即可，无需任何 API Key：

https://rube.app/mcp

按 SKILL.md 的说明，添加端点后即自动生效。完成接入后，按以下四步完成初始化（SKILL.md）：

1. 验证 RUBE_SEARCH_TOOLS 能正常响应，确认 Rube MCP 可用；
2. 调用 RUBE_MANAGE_CONNECTIONS，指定 toolkit 为 simplesat；
3. 若连接状态不是 ACTIVE，按返回的认证链接完成 OAuth 授权；
4. 在运行任何工作流之前，再次确认连接状态显示为 ACTIVE。

工具发现：RUBE_SEARCH_TOOLS

工具发现是整个工作流的起点。技能要求在执行任何工作流之前先发现可用工具（SKILL.md），典型调用如下：

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

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

• 可用的工具 slug（tool slugs）：后续 RUBE_MULTI_EXECUTE_TOOL 中 tool_slug 字段的直接取值来源；
• 输入 schema：每个工具参数的字段名、类型与必填性，是构造 arguments 的依据；
• 推荐的执行计划：针对该 use case 建议的工具调用顺序；
• 已知陷阱：官方预先标注的易错点。

从同构系列技能 composio-automation 可以看到，该模式在全部 78 个技能中保持一致，区别仅在于 use_case 的取值——Simplesat 场景应使用 "Simplesat operations"。

核心工作流三步模式

技能定义了标准化的三步工作流（SKILL.md），适用于任何具体任务。

步骤一：发现可用工具

针对具体任务再次发起搜索。与初始化阶段的区别在于：如果工作流已在进行中，应复用已有会话 ID，而不是重新生成：

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

这里的 use_case 应替换为具体任务描述，例如 "create a survey in Simplesat" 或 "fetch survey responses"，以便搜索引擎返回最匹配的工具集合。

步骤二：检查连接

在执行任何工具前，通过 RUBE_MANAGE_CONNECTIONS 确认 Simplesat 连接仍处于 ACTIVE 状态：

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

这一步骤用于兜底校验：OAuth 令牌可能过期或被吊销，若跳过该检查，后续工具调用将返回认证错误。

步骤三：执行工具

一切就绪后，通过 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；
• memory：必须始终携带，即使没有跨工具状态传递也传空对象 {}（见下文陷阱说明）。

常见陷阱与规避策略

技能明确列出了六条已知陷阱（SKILL.md），这些来自 Composio API 实际使用经验的总结：

1. 先搜索再执行：工具 schema 会变化，不调用 RUBE_SEARCH_TOOLS 就硬编码 slug 或参数是失败的第一大来源；
2. 检查连接：执行工具前必须确认 RUBE_MANAGE_CONNECTIONS 返回 ACTIVE；
3. Schema 合规：参数必须使用搜索结果中的确切字段名与类型，字段名大小写、嵌套结构都不能自由发挥；
4. Memory 参数：RUBE_MULTI_EXECUTE_TOOL 调用必须包含 memory，即使内容为空也要传 {}，否则调用可能失败；
5. 会话复用：同一工作流内复用 session ID，新工作流再生成新 ID——这保证了跨步骤的上下文连续性，也避免了状态污染；
6. 分页处理：响应中可能带分页 token（pagination tokens），必须持续拉取直到取回完整数据，避免遗漏批量操作的结果。

操作速查表

技能末尾提供了精炼的速查表（SKILL.md），覆盖五种典型操作及其对应入口：

操作	入口方式
查找工具	RUBE_SEARCH_TOOLS，传入 Simplesat 相关 use case
建立连接	RUBE_MANAGE_CONNECTIONS，toolkit 指定为 simplesat
执行操作	RUBE_MULTI_EXECUTE_TOOL，使用发现到的工具 slug
批量操作	RUBE_REMOTE_WORKBENCH，配合 run_composio_tool()
获取完整 schema	RUBE_GET_TOOL_SCHEMAS，用于带 schemaRef 的工具

其中两个入口值得展开说明：批量操作场景（如批量拉取并分析多份问卷回复）可改用 RUBE_REMOTE_WORKBENCH 在远端执行环境通过 run_composio_tool() 编程式调用，摆脱逐条调用的开销；当搜索返回的工具带 schemaRef 引用而非完整内联 schema 时，则需用 RUBE_GET_TOOL_SCHEMAS 单独拉取完整定义。

把模式推广到其他技能

本技能的三步模式并非 Simplesat 独有。对比 composio-automation、composio-search-automation 等系列文件可以发现，78 个应用技能的骨架完全一致，差异仅在三处：frontmatter 中的 name/description、RUBE_MANAGE_CONNECTIONS 中的 toolkits 取值、以及 RUBE_SEARCH_TOOLS 中的 use_case 描述。

因此，掌握本技能后即可触类旁通：例如在 README.md 列出的 CRM、项目管理、通信、邮件等分类中，将 toolkit 名与 use case 替换为目标应用（如 salesforce、notion、slack），同一套「发现 → 校验 → 执行」流程即可复用，这正是本仓库将 78 个技能统一封装在同一模式下的设计意图。

总结

Simplesat 自动化技能给出了一条可复现、可扩展的 Agent 自动化路径：通过 Rube MCP 免密钥接入 Composio 生态，以 RUBE_SEARCH_TOOLS 的动态发现对抗 schema 漂移，以 RUBE_MANAGE_CONNECTIONS 的 ACTIVE 校验保障调用安全，以 RUBE_MULTI_EXECUTE_TOOL 完成实际业务操作。核心纪律——先搜索、再校验、后执行、携带 memory、复用会话、处理分页——是保证工作流在真实环境中稳定运行的关键。完整实现请以仓库中的 simplesat-automation/SKILL.md 为准，并始终遵循其「先搜索工具以获取当前 schema」的首要原则。