☰
Bolna 自动化实战指南:基于 Rube MCP 与 Composio 的 awesome-claude-skills 技能详解
2026/9/30 2:20:11 网站建设 项目流程
  • AI 技能
  • AI 插件
  • 人工智能
  • 工作流自动化

【免费下载链接】awesome-claude-skills

A 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 仓库中 composio-skills/bolna-automation/SKILL.md 展开,系统讲解如何通过 Rube MCP(Composio 提供的 MCP 端点)让 Claude 直接驱动 Bolna 平台的相关业务操作。读完本文,你将掌握 Rube MCP 的接入方式、RUBE_SEARCH_TOOLS工具发现机制、RUBE_MANAGE_CONNECTIONS连接管理、RUBE_MULTI_EXECUTE_TOOL工具执行这一完整工作流,并学会规避该技能明确标注的六大常见陷阱。

技能定位:一个封装 Bolna 自动化的 Claude Skill

bolna-automation是 awesome-claude-skills 仓库中 composio-skills 目录下的一个标准 Claude Skill。按照仓库 README.md 的说明,composio-skills 目录整体定位为 "App Automation via Composio",包含面向 78 个 SaaS 应用的预构建工作流技能,每个技能都包含工具调用序列、参数指引、已知陷阱和快速参考表,且全部使用从 Composio API 发现的真实工具 slug(tool slug)。

该技能的 YAML frontmatter(见 SKILL.md)定义如下:

--- name: bolna-automation description: "Automate Bolna tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube] ---
  • name:技能的唯一标识符,供 Agent 会话内按名加载;
  • description:告诉 Agent 该技能"何时适用"——当任务涉及 Bolna 平台操作时激活,并强调"先搜索工具以获取当前 schema"这一铁律;
  • requires.mcp:声明该技能依赖名为rube的 MCP 服务器,即 Rube MCP。

结合仓库对 Claude Skills 机制的说明(README.md),可以理解该技能的设计初衷:Skill 本身不是 MCP 服务器也不是工具,它定义的是"工作流"——在已有 MCP 连接和工具的前提下,规定"做什么、按什么顺序做、加什么护栏"。bolna-automation正是把"发现工具 → 检查连接 → 执行工具"这一可复用流程固化成了 Agent 可遵循的指令包。

前置条件

在启用bolna-automation技能之前,需要满足 SKILL.md 列出的三项前置条件:

  1. Rube MCP 必须已连接:环境中存在RUBE_SEARCH_TOOLS工具可用;
  2. 存在 ACTIVE 状态的 Bolna 连接:通过RUBE_MANAGE_CONNECTIONS以bolna作为 toolkit 名称建立;
  3. 执行前先调用RUBE_SEARCH_TOOLS:任何工作流开始前都必须先获取当前工具 schema。

其中第 3 条尤为关键:Composio 的工具 schema 会随平台演进而变化,硬编码工具 slug 或参数名必然导致调用失败。

设置 Rube MCP 并建立 Bolna 连接

第一步:接入 Rube MCP

按 SKILL.md 的说明,Rube MCP 的接入成本极低——无需任何 API Key,只需在客户端(如 Claude Code、Claude.ai 或其他支持 MCP 的 Agent)的 MCP 服务器配置中添加一个端点:

https://rube.app/mcp

添加完成后即获得RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、RUBE_MULTI_EXECUTE_TOOL等一组 RUBE_ 前缀的 MCP 工具。

第二步:建立 Bolna 连接

连接建立分为四个步骤(SKILL.md):

  1. 确认 Rube MCP 可用:验证RUBE_SEARCH_TOOLS能正常响应;
  2. 调用RUBE_MANAGE_CONNECTIONS,toolkit 参数传bolna;
  3. 若连接状态不是 ACTIVE,跟随返回的认证链接完成授权设置;
  4. 确认连接状态显示 ACTIVE 后再开始运行任何工作流。

连接状态是执行的前提:未 ACTIVE 的连接意味着工具调用会因未授权而失败,因此"先查连接、再执行"是技能强调的固定顺序。

工具发现:执行任何任务前的第一步

RUBE_SEARCH_TOOLS是技能定义的"信息入口"。参考 SKILL.md 中的发现调用示例:

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

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

  • 可用的工具 slug 列表:本次工作流中可以调用的具体工具标识;
  • 输入 schema:每个工具的参数字段名、类型与必填约束;
  • 推荐执行计划:Composio 基于 use_case 给出的步骤建议;
  • 已知陷阱(known pitfalls):该工具集常见的易错点提示。

在具体任务场景中,将use_case替换为你的实际需求描述即可(如"your specific Bolna task")。若复用会话,可改用session: {id: "existing_session_id"}保持上下文连续。

核心工作流模式:三步完成一次自动化

技能将一次完整的 Bolna 自动化操作规范为三个步骤(SKILL.md):

Step 1:发现可用工具

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

用具体任务替换 use_case,获取该任务对应的工具 slug 与参数 schema。

Step 2:检查连接

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

确认bolnatoolkit 的连接处于 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 的搜索结果,禁止硬编码;
  • arguments必须严格遵循搜索结果返回的 schema——字段名、类型、必填性都要与 schema 完全一致;
  • memory参数必须始终携带,即使为空也要传{};
  • session_id复用 Step 1/2 中的会话 ID,保证多步操作上下文连贯。

六大已知陷阱与规避方法

技能在 Known Pitfalls 一节 明确列出了六条易错点,逐一说明如下:

陷阱规避方法
工具 schema 会变化永远先调用RUBE_SEARCH_TOOLS,绝不硬编码工具 slug 或参数
连接未就绪执行前用RUBE_MANAGE_CONNECTIONS确认状态为 ACTIVE
参数不符合 schema严格使用搜索结果中的精确字段名与类型
遗漏 memory 参数RUBE_MULTI_EXECUTE_TOOL调用中始终包含memory,空则传{}
会话 ID 使用不当同一工作流内复用会话 ID;开启新工作流时生成新的
响应未取全检查响应中的分页令牌(pagination token),持续获取直至数据完整

前四条是参数与状态层面的硬性约束,后两条则是工作流层面的最佳实践。从仓库结构看,这六条陷阱在 composio-skills 目录下全部技能(如 ably-automation/SKILL.md)中保持一致,是 Rube MCP 工作流的通用经验沉淀。

快速参考表:五类操作的对应方式

SKILL.md 末尾给出了一张可直接照用的速查表:

操作方式
查找工具RUBE_SEARCH_TOOLS,携带 Bolna 相关的 use case
建立连接RUBE_MANAGE_CONNECTIONS,toolkit 为bolna
执行工具RUBE_MULTI_EXECUTE_TOOL,使用发现的工具 slug
批量操作RUBE_REMOTE_WORKBENCH,配合run_composio_tool()
获取完整 schemaRUBE_GET_TOOL_SCHEMAS,用于带schemaRef的工具

其中批量操作与完整 schema 两条是进阶能力:当单个任务涉及多次工具调用时,RUBE_REMOTE_WORKBENCH允许在远端工作台中以run_composio_tool()编程方式编排;而RUBE_GET_TOOL_SCHEMAS可拉取工具的完整参数定义,适合 schema 较大、需要精确构造参数的场景。

在 Claude Code 中安装与使用该技能

从仓库的通用说明(README.md)可以推断该技能的典型落地方式:将技能目录放置到 Claude Code 的技能目录后即可自动加载:

mkdir -p ~/.config/claude-code/skills/ cp -r composio-skills/bolna-automation ~/.config/claude-code/skills/

验证元数据无误后启动:

head ~/.config/claude-code/skills/bolna-automation/SKILL.md claude

技能采用渐进式加载机制(README.md):会话启动时 Agent 仅看到技能的名称与描述(约 100 token),只有在任务被判定与 Bolna 相关时,完整的 SKILL.md 正文才会加载——这正是该技能能把RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS等完整工作流指令装入上下文而不过度消耗 token 的原因。同时在客户端中添加 Rube MCP 端点https://rube.app/mcp后,requires.mcp: [rube]声明的依赖即可满足,技能便能在会话中按本文所述三步流程驱动 Bolna 自动化。

总结

bolna-automation技能的价值在于把"动态发现、按需授权、schema 合规执行"这一 Rube MCP 工作流范式固化成了可直接复用的指令包:接入https://rube.app/mcp端点 →RUBE_SEARCH_TOOLS发现工具 →RUBE_MANAGE_CONNECTIONS确认连接 →RUBE_MULTI_EXECUTE_TOOL执行操作,再辅以六条陷阱护栏与一张快速参考表。该技能与仓库中其余 70 余个*-automation技能共享同一模板结构(可对比 ably-automation/SKILL.md),掌握这一个,即可触类旁通地使用整个 Composio 自动化技能家族。

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

【免费下载链接】awesome-claude-skills

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

项目地址:https://gitcode.com/GitHub_Trending/aw/awesome-claude-skills
点击查看免费下载

相关推荐

上一篇:从 SQL 与 ORM 到 Gel:Gel 数据模型的设计哲学与实战对比
下一篇:Dism++完整指南:如何用免费工具3步搞定Windows系统优化与维护

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询