bubble-automation
作者 ComposioHQbubble-automation 帮助 agent 通过 Rube MCP 使用 Composio 的 Bubble toolkit 自动执行 Bubble 操作，并采用 schema-first 的工具发现、连接检查和更安全的执行模式。
该技能评分为 66/100，属于可接受但能力有限的目录条目。它为 agent 提供了足够的触发与设置指引，可通过 Rube MCP 操作 Bubble；但目录用户应了解，它更偏向轻量级连接器技能，而不是包含丰富 Bubble 自动化工作流的完整库。
- 有效的 frontmatter 清楚标明该技能用于通过 Rube MCP 进行 Bubble 自动化，并声明了所需的 MCP 依赖。
- 前置条件和设置步骤说明必须连接 Rube MCP，Bubble toolkit 连接必须为 ACTIVE，并且应先调用 RUBE_SEARCH_TOOLS。
- 该技能提供了可复用的“先发现”模式，使用 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，相比通用的 Bubble 提示词可减少猜测。
- 除 SKILL.md 外未包含支持文件、脚本、参考资料或 README，因此能否顺利采用完全取决于简短的内联说明。
- 工作流指导主要是通过 Rube MCP 进行通用工具发现；如果用户需要具体的 Bubble 任务配方或边界情况处理，可能会觉得内容偏薄。
bubble-automation skill 概览
bubble-automation 能做什么
bubble-automation 是一项 Claude skill，用于通过 Rube MCP 调用 Composio 的 Bubble toolkit，自动执行 Bubble app 相关操作。它的核心并不是让模型猜测 Bubble API 调用，也不是依赖可能已经过时的工具名称；而是要求先发现当前可用的 Rube tools，确认 Bubble 连接状态，再基于返回的 schema 执行工作流。
适合 Bubble 用户和工作流自动化场景
bubble-automation skill 适合需要在更大的 Workflow Automation 流程中重复执行 Bubble 操作的构建者、运营团队和 AI agents：例如检查 app 数据、创建或更新记录、把 Bubble 任务与其他 SaaS 工具联动，或将自然语言描述的 Bubble 需求转化为由工具驱动的执行计划。当前环境已经支持 MCP，并且你希望 assistant 通过已认证的 Composio tools 真正执行操作，而不只是起草说明时，它最有价值。
核心差异：schema 优先的执行方式
bubble-automation skill 的主要价值不在于文件数量庞大；当前 repository 基本围绕 SKILL.md 展开。它的价值在于强制执行一种工作流纪律：执行前先调用 RUBE_SEARCH_TOOLS，使用当前返回的 tool slugs 和 input schemas，通过 RUBE_MANAGE_CONNECTIONS 管理 Bubble 连接，并避免硬编码假设。这一点很重要，因为 MCP tool schemas 和可用的 Bubble 操作都可能发生变化。
重要采用前提
不要期待在没有 Rube MCP 的情况下安装后即可独立完成 Bubble 自动化。bubble-automation skill 需要 rube MCP server 和一个有效的 Bubble 连接。如果你的 AI client 无法调用 MCP tools，或者无法通过 Composio/Rube 完成 Bubble 认证，这项 skill 就无法执行真实操作。
如何使用 bubble-automation skill
bubble-automation 安装与配置路径
在兼容 skills 的环境中安装该 skill，例如：
npx skills add ComposioHQ/awesome-claude-skills --skill bubble-automation
然后按照 skill 中记录的 endpoint，将 Rube MCP 添加到你的 client 配置中：https://rube.app/mcp。MCP server 可用后，先确认 RUBE_SEARCH_TOOLS 能够响应。接着使用 toolkit bubble 调用 RUBE_MANAGE_CONNECTIONS；如果连接状态不是 ACTIVE，请按返回的授权链接完成授权，并在要求 agent 修改 Bubble 中任何内容之前重新检查状态。
你需要提供哪些输入
要更好地使用 bubble-automation，请向 assistant 提供明确的 Bubble 目标、目标 app 或环境、object/data type 名称、field 名称、filters，以及允许变更的范围。较弱的请求是：“Update Bubble records.” 更好的请求是：“Use the Bubble connection to find all Order records where status is pending_review and created_date is before 2025-01-01, then prepare a plan before changing status to archived. Search tools first and show the schema you plan to use.”
这些额外信息可以降低两类常见风险：选错 Bubble 操作，以及在约束不足的情况下执行大范围修改。
安全执行的实用工作流
每个任务开始时，都应要求 agent 针对具体用例执行工具发现，而不是笼统地查找 “Bubble operations”。该 skill 推荐的模式是：
- 使用
RUBE_SEARCH_TOOLS搜索 tools。 - 查看返回的 tool slugs、必填字段和 warnings。
- 使用
RUBE_MANAGE_CONNECTIONS检查 Bubble 连接。 - 基于当前 schema 起草执行计划。
- 尽可能先执行只读或小范围操作。
- 只有在确认目标 records 和 fields 后，才执行写入操作。
对于生产 app，建议增加一个明确的确认关卡：“Do not create, update, or delete records until you summarize the exact tool call and affected objects.”
优先阅读的 repository 文件
先阅读 composio-skills/bubble-automation/SKILL.md；其中包含操作约定、前提条件、配置说明和 Rube 调用示例。当前文件树中没有额外的 rules/、resources/、references/ 或 scripts，因此这项 skill 有意保持轻量。如果你需要更深入了解 Bubble toolkit，请查看 skill 中链接的上游 toolkit 文档：https://composio.dev/toolkits/bubble。
bubble-automation skill 常见问题
没有 Rube MCP，bubble-automation 够用吗？
不够。bubble-automation skill 是一层用于通过 Rube MCP 和 Composio 操作 Bubble 的指令层。它不自带 Bubble API client、辅助脚本或离线执行器。如果你的 client 中无法使用 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，assistant 只能讨论工作流，不能真正执行。
它比普通 Bubble prompt 好在哪里？
普通 prompt 可能产出泛泛的 Bubble 建议，或基于过时的 API 假设生成方案。这个 skill 会要求 agent 在行动前发现实时 tool schemas，这对可靠的 Workflow Automation 很关键。实际收益是：工具调用格式错误更少，对必填字段、连接状态和可用 Bubble 操作的猜测也更少。
bubble-automation skill 适合新手吗？
如果你已经是 Bubble 用户，并且拥有支持 MCP 的 AI client，也能完成类似 OAuth 的连接流程，那么它对新手是友好的。如果你刚接触 MCP，它的上手门槛会更高，因为关键配置步骤并不在 Bubble 内部完成，而是要连接 Rube MCP、验证 tools 可用性，并激活 Bubble toolkit connection。
什么时候不应该使用这个 skill？
不要用它来做可视化 Bubble editor 设计、plugin 开发、未经审核的复杂数据库迁移，或在无法定义精确 filters 的情况下进行大范围生产更新。如果你需要确定性的 CI/CD 风格部署脚本，它也不太适合；这项 skill 更适合由 agent 参与执行的 Bubble 操作，其中工具发现和人工确认都是可接受的流程环节。
如何改进 bubble-automation skill
用精准 prompt 提升 bubble-automation 效果
影响最大的改进方式是把任务描述得更清楚。请包含 Bubble data type、operation、field names、filter logic、environment，以及 agent 是只需要检查数据还是也可以修改数据。例如：“Search Rube tools for Bubble record lookup. Find Customer records with plan = trial and last_login older than 60 days. Return a count first; do not update records until I approve.” 这样可以让 skill 从工具发现到实际执行拥有更安全的路径。
避免常见失败模式
最常见的失败是跳过 RUBE_SEARCH_TOOLS，直接假设 tool schema。第二类是 Bubble 连接尚未处于 ACTIVE 状态就尝试执行操作。第三类是在没有验证步骤的情况下请求大规模更新。要避免这些问题，请把工具发现、连接检查和确认步骤写进每一次 prompt。如果某个输出在没有展示工具发现的情况下显得过于肯定，请要求 agent 从 schema discovery 重新开始。
在第一次工具响应后迭代
收到第一次 Rube 响应后，应基于实际返回的 schema 细化计划。要求 agent 识别必填字段、可选字段、rate 或 pagination 相关问题，以及任何破坏性操作 warning。对于多步骤 Workflow Automation，可以先让它执行一次范围很窄的读取操作，汇总结果；只有在匹配集合正确时，才继续写入。
给维护者和高级用户的改进建议
当前 skill 简洁且可用，但如果增加一些常见 Bubble 任务示例，会更强，例如列出 records、创建 records、更新 fields，以及检查连接状态。增加一个小型 troubleshooting 章节，覆盖 inactive connections、missing tools 和 schema mismatches，也会提升采用率。如果你 fork 或扩展 bubble-automation，请继续把 schema-first 规则放在核心位置，而不是添加可能很快过时的硬编码 tool calls。