基于 Rube MCP 的 Kaleido 自动化实战:kaleido-automation 技能全解析 AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载本文以 awesome-claude-skills 仓库中 kaleido-automation 技能文档 为核心系统讲解如何通过 Rube MCP 与 Composio 的 Kaleido toolkit 打通工具发现—连接管理—工具执行的完整自动化链路。读完本文你将掌握RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL三个核心 MCP 工具的调用范式、会话复用与分页处理的避坑要点并能在自己的 Agent 客户端中复现一套可复用的 Kaleido 工作流。技能定位composio-skills 系列中的 Kaleido 自动化kaleido-automation是 awesome-claude-skills 仓库composio-skills/目录下预置的 SaaS 自动化技能之一。根据仓库 README.md 的说明composio-skills/收录了面向 78 个 SaaS 应用的预构建工作流技能每个技能都包含工具调用序列、参数指导、已知陷阱与快速参考表且全部使用从 Composio API 发现的真实工具 slugtool slug。该技能的文件本身即是一个标准 Claude Skill 结构--- name: kaleido-automation description: Automate Kaleido tasks via Rube MCP (Composio). Always search tools first for current schemas. requires: mcp: [rube] ---从 YAML frontmatter 可以看出三个关键信息name为kaleido-automation与其他 composio-skills 技能如composio-automation、-21risk-automation等保持一致的命名规范description中明确要求先搜索工具再执行Always search tools first for current schemas这是整个技能的核心设计原则requires.mcp声明该技能依赖名为rube的 MCP 服务器即 Rube MCP。理解这个技能需要先理清 Skill、MCP、Tool 三层的关系。README 的说明指出MCP 定义 Agent 如何连接外部系统认证、传输、工具发现Tool 是 Agent 实际调用的函数而 Skill 定义的是工作流——一旦 Agent 具备连接与工具Skill 规定做什么、按什么顺序做、带什么护栏。README.md 明确总结在生产环境中三层协同运转MCP 负责访问、Tools 负责动作、Skills 负责行为。kaleido-automation正是这一模式的直接落地它不实现 Kaleido 的任何 API 调用而是编排 Rube MCP 暴露的工具完成对 Kaleido 的自动化操作。前置条件在开始任何 Kaleido 自动化工作流之前需要满足以下三个前提均来自原技能文档Rube MCP 必须已连接RUBE_SEARCH_TOOLS工具可用存在 ACTIVE 状态的 Kaleido 连接通过RUBE_MANAGE_CONNECTIONS以 toolkit 为kaleido建立连接始终先调用RUBE_SEARCH_TOOLS获取当前的工具 schema 后再执行具体操作。第三条值得特别强调Kaleido toolkit 的工具集合与参数结构会随 Composio API 演进而变化任何硬编码的工具 slug 或参数都存在失效风险因此先搜索、后执行不是可选项而是强制要求。环境搭建接入 Rube MCPRube MCP 的接入方式非常轻量获取 Rube MCP在客户端配置中将https://rube.app/mcp添加为 MCP 服务器即可。无需 API Key——只需添加端点即可工作。接入后的初始化流程分为四步验证可用性确认RUBE_SEARCH_TOOLS能正常响应说明 Rube MCP 已成功接入建立连接调用RUBE_MANAGE_CONNECTIONS并传入 toolkit 为kaleido完成授权如果连接状态不是 ACTIVE则跟随返回的认证链接auth link完成 OAuth 设置确认状态在运行任何工作流之前确认连接状态显示为 ACTIVE。这种无需 API Key、动态授权的机制与仓库 connect/SKILL.md 描述的能力模型一致Composio 底层的 Tool Router 会自动处理 OAuth用户只需点击授权链接即可连接建立后会持久化复用。工具发现先搜索再执行在每次执行工作流之前必须执行工具发现步骤。技能文档给出的标准发现调用如下RUBE_SEARCH_TOOLS queries: [{use_case: Kaleido operations, known_fields: }] session: {generate_id: true}该调用会返回以下四类结果可用的工具 slugtool slugs供后续RUBE_MULTI_EXECUTE_TOOL引用输入 schema每个工具的完整参数结构包括字段名、类型与必填项推荐的执行计划recommended execution plansRube 基于 use_case 给出的多步编排建议已知陷阱known pitfalls针对该工具或操作场景的注意事项。注意session: {generate_id: true}的使用这是首次发起发现时的会话初始化方式Rube 会生成一个会话 ID供后续步骤复用。核心工作流模式三步走技能文档将完整的 Kaleido 自动化工作流规范为三个步骤发现工具 → 检查连接 → 执行工具。Step 1发现可用工具针对具体的 Kaleido 任务发起工具搜索RUBE_SEARCH_TOOLS queries: [{use_case: your specific Kaleido task}] session: {id: existing_session_id}与初始化发现不同这里复用已有会话session: {id: existing_session_id}中的 ID 应来自首次调用时generate_id: true生成的会话。use_case的描述越具体例如Kaleido 网络成员管理Kaleido 应用部署返回的工具推荐与执行计划就越精准。Step 2检查连接状态在调用任何工具之前确认 Kaleido 连接处于 ACTIVERUBE_MANAGE_CONNECTIONS toolkits: [kaleido] session_id: your_session_id这里的toolkits使用数组形式传入即使只检查一个 toolkit 也要用[kaleido]包裹。如果返回的连接状态不是 ACTIVE应回到初始化流程第 3 步跟随返回的认证链接完成授权后再继续。Step 3执行工具拿到搜索结果中的工具 slug 与参数 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该调用支持在tools数组中一次传入多个工具实现多步骤串联执行。三个参数各有讲究tool_slug必须来自RUBE_SEARCH_TOOLS的搜索结果禁止凭记忆硬编码arguments必须与搜索返回的输入 schema 完全一致——字段名、字段类型、必填项都不能有偏差memory即使为空也必须显式传入{}技能文档将其列为已知陷阱之一说明 Rube 在执行路径上依赖该参数承载跨工具的状态。session_id在整个工作流中保持一致确保多次工具调用共享同一个执行上下文。已知陷阱与避坑指南技能文档总结了六条经过实战验证的注意事项每条都对应一个常见的失败模式始终先搜索工具 schema 会变化。不调用RUBE_SEARCH_TOOLS就硬编码工具 slug 或参数是失效的最常见原因。检查连接执行工具前务必通过RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE。连接过期或未授权时直接执行会得到认证类错误。Schema 合规严格使用搜索结果中的字段名与类型。参数名拼写错误、类型不匹配例如字符串传成数字都会被 Rube 拒绝。Memory 参数必填RUBE_MULTI_EXECUTE_TOOL调用中始终携带memory即使内容为空也要传{}。遗漏该参数可能导致执行失败或状态丢失。会话复用同一工作流内复用会话 ID跨工作流则生成新会话。会话承载了工作流的上下文混用会话会让不同任务的状态互相污染。分页处理检查响应中是否包含分页令牌pagination tokens如有则继续请求直到数据取完。大批量操作如遍历 Kaleido 的资源列表时忽略分页会导致数据不完整。快速参考表技能文档末尾提供了操作速查表覆盖五类典型操作OperationApproachFind toolsRUBE_SEARCH_TOOLSwith Kaleido-specific use caseConnectRUBE_MANAGE_CONNECTIONSwith toolkitkaleidoExecuteRUBE_MULTI_EXECUTE_TOOLwith discovered tool slugsBulk opsRUBE_REMOTE_WORKBENCHwithrun_composio_tool()Full schemaRUBE_GET_TOOL_SCHEMASfor tools withschemaRef对照前文的三步工作流这张表补充了两个进阶入口批量操作Bulk ops当需要大规模处理时改用RUBE_REMOTE_WORKBENCH并在其中调用run_composio_tool()函数式地编排工具适合循环执行同类操作的高吞吐场景完整 schemaFull schema当RUBE_SEARCH_TOOLS返回的工具带有schemaRef引用schema 未内联展开时使用RUBE_GET_TOOL_SCHEMAS获取完整定义避免因 schema 不完整导致参数构造错误。底层原理工具路由与动态授权从仓库 connect/SKILL.md 的How It Works一节可以印证 Rube MCP 背后的机制Composio Tool Router 的工作流程是——用户向 Agent 提出操作请求 → Tool Router 在 1000 集成中匹配正确工具 → OAuth 自动处理 → 动作执行并返回结果。kaleido-automation的编排与此完全同构RUBE_SEARCH_TOOLS承担匹配正确工具的发现职责返回工具 slug 与 schemaRUBE_MANAGE_CONNECTIONS承担OAuth 自动处理的连接职责返回授权链接并持久化 ACTIVE 连接RUBE_MULTI_EXECUTE_TOOL承担动作执行的职责按 schema 组装参数并返回结果。这也解释了技能为何反复强调先搜索再执行Tool Router 的匹配结果工具集合与 schema是动态的Agent 只有在执行前实时获取当前 schema才能保证参数组装与 Rube 的预期完全一致。小结kaleido-automation技能展示了在 Claude 生态中自动化第三方 SaaS 的标准范式用 Skill 定义工作流骨架用 Rube MCP 提供工具发现、连接管理与批量执行能力用先搜索、后执行的纪律规避 schema 漂移风险。将 composio-skills/kaleido-automation/SKILL.md 中的三步工作流、六条陷阱与速查表组合使用即可在任意支持 MCP 的客户端中以会话为单位构建稳定、可复用的 Kaleido 自动化任务同一套方法论也适用于composio-skills/目录下其他 77 个 SaaS 技能只需替换对应的 toolkit 名称与 use_case 描述。赞分享AI 技能AI 插件人工智能工作流自动化【免费下载链接】awesome-claude-skillsA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows项目地址https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills点击查看免费下载相关推荐EIP-7701 原生账户抽象Native Account Abstraction交易流程详解从 Simple Flow 到验证/执行两阶段模型EIP 7701 原生账户抽象Native Account Abstraction交易流程详解从 Simple Flow 到验证/执行两阶段模型 EIPAI 技能AI 插件人工智能工作流自动化基于 Rube MCP 的 Dotsimple 自动化实战awesome-codex-skills 之 dotsimple-automation 技能全解基于 Rube MCP 的 Dotsimple 自动化实战awesome codex skills 之 dotsimple automation 技能全解 本AI 技能AI 插件工作流自动化人工智能基于 Rube MCP 的 Goody 自动化实战解析 awesome-codex-skills 的 goody-automation 技能基于 Rube MCP 的 Goody 自动化实战解析 awesome codex skills 的 goody automation 技能 导读 本文围绕AI 技能AI 插件工作流自动化人工智能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考