- AI 技能
- AI 插件
- 人工智能
- 工作流自动化
【免费下载链接】awesome-claude-skills
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
导读
本文围绕 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 列出的三项前置条件:
- Rube MCP 必须已连接:环境中存在
RUBE_SEARCH_TOOLS工具可用; - 存在 ACTIVE 状态的 Bolna 连接:通过
RUBE_MANAGE_CONNECTIONS以bolna作为 toolkit 名称建立; - 执行前先调用
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):
- 确认 Rube MCP 可用:验证
RUBE_SEARCH_TOOLS能正常响应; - 调用
RUBE_MANAGE_CONNECTIONS,toolkit 参数传bolna; - 若连接状态不是 ACTIVE,跟随返回的认证链接完成授权设置;
- 确认连接状态显示 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() |
| 获取完整 schema | RUBE_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
相关推荐
基于 Rube MCP(Composio)的 Apex27 自动化实战:awesome-claude-skills 中 Composio 工具集技能的完整指南
基于 Rube MCP(Composio)的 Apex27 自动化实战:awesome claude skills 中 Composio 工具集技能的完整指南
AI 技能AI 插件人工智能工作流自动化Frappe Island 页头协议:页面岛如何向上报告标题与操作(决策 0010 深度解析)
Frappe Island 页头协议:页面岛如何向上报告标题与操作(决策 0010 深度解析) 导读 Frappe 的 Island 子系统让第三方应用(如 C
AI 技能AI 插件人工智能工作流自动化基于 Rube MCP 与 Composio 的 Goodbits 自动化实战指南(awesome-codex-skills)
基于 Rube MCP 与 Composio 的 Goodbits 自动化实战指南(awesome codex skills) 本指南围绕仓库中的 Goodbi
AI 技能AI 插件工作流自动化人工智能
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考