bonsai-automation
作者 ComposioHQbonsai-automation 可帮助 Claude 通过 Composio Rube MCP 自动化 Bonsai 操作。安装该 skill 后，连接 Rube，验证 Bonsai 连接，然后先按 schema-first 的方式发现工具，再运行工作流。
该 skill 评分为 66/100，达到收录标准，但更适合已经在使用 Rube MCP 和 Bonsai 的用户。它提供了足够的触发和设置指引，能帮助 agent 正确起步；不过目录用户需要了解，大部分操作细节依赖实时工具发现，而不是内置示例或配套文档。
- 触发条件和适用范围清晰：明确用于通过 Rube MCP 调用 Composio 的 Bonsai toolkit 来自动化 Bonsai 操作。
- 已说明运行前提，包括 Rube MCP 可用、存在有效的 Bonsai 连接，以及必须先调用 RUBE_SEARCH_TOOLS 获取最新 schemas。
- 设置与发现流程为 agent 提供了可重复的路径：验证 Rube、管理 Bonsai 连接、搜索工具，然后基于返回的 schemas 执行操作。
- 未提供支持文件、脚本、参考文档或安装命令；该 skill 完全依赖单一的 SKILL.md 以及外部 Rube/Bonsai schemas。
- 工作流说明主要是通用的工具发现与连接设置；从仓库证据来看，具体 Bonsai 任务示例和边界情况处理都比较有限。
bonsai-automation skill 概览
bonsai-automation 能做什么
bonsai-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行 Bonsai 业务运营操作。它适合希望让 agent 自动发现当前 Bonsai tool schemas、验证 Bonsai 连接，并通过 bonsai toolkit 执行任务的用户，而不是让模型凭记忆猜测 API 字段。
这个 skill 最重要的指令是流程性的：始终先调用 RUBE_SEARCH_TOOLS。这很关键，因为 Rube 的 tool 名称、输入参数和执行计划可能会变化，而 Bonsai 工作流通常依赖最新的 schema 细节。
最适合的用户与工作流自动化场景
最适合使用它的人，是已经在使用 Bonsai，并且愿意通过 Rube MCP 连接 Bonsai 的用户。典型的 bonsai-automation for Workflow Automation 场景包括：让 agent 检查可用的 Bonsai actions，准备安全的执行计划，并且只有在确认当前连接和必填字段之后，才执行 client、project、invoice、task 或相关业务管理操作。
这不是一份通用的 Bonsai 使用教程。当你的目标是“让 Claude 通过已批准的 MCP tools 操作 Bonsai”，而不是“解释 Bonsai 怎么用”时，它最有价值。
核心差异：schema 优先的执行方式
普通提示词可能会让 Claude “在 Bonsai 里创建一张 invoice”，但模型可能会编造 tool 参数，或沿用过时的假设。bonsai-automation skill 通过强制采用发现流程来降低这种风险：
- 为具体 Bonsai 任务搜索可用的 Rube tools。
- 检查
bonsaitoolkit 连接是否处于活动状态。 - 阅读返回的 schema 和注意事项。
- 只使用符合当前 tool definition 的字段执行。
这种 schema 优先的模式，是安装该 skill 的主要理由。
如何使用 bonsai-automation skill
bonsai-automation 安装与 MCP 设置
使用以下命令从 Composio skill collection 安装该 skill：
npx skills add ComposioHQ/awesome-claude-skills --skill bonsai-automation
该 skill 需要 Rube MCP，而不是本地脚本包。请在你的 client configuration 中将 https://rube.app/mcp 添加为 MCP server，然后确认 MCP tools 已可见。该仓库唯一必读的源文件是 composio-skills/bonsai-automation/SKILL.md，建议先读它；没有额外的 scripts/、resources/ 或 rules/ 文件夹需要检查。
在期待它产出有用结果之前，请先确认：
RUBE_SEARCH_TOOLS可用。RUBE_MANAGE_CONNECTIONS可以管理 toolkit connections。bonsai连接状态为ACTIVE。- 如果连接未激活，请先完成返回的 auth flow，再运行 Bonsai actions。
实用的 bonsai-automation 使用流程
一个可靠的 bonsai-automation usage 流程是：
- 明确告诉 agent 你想要达成的 Bonsai 结果。
- 要求它针对该具体任务调用
RUBE_SEARCH_TOOLS。 - 要求它总结可用的 tool slug、必填字段、可选字段和已知注意事项。
- 让它通过
RUBE_MANAGE_CONNECTIONS检查 Bonsai 连接。 - 补充缺失的业务细节。
- 只有当执行计划与你的意图一致后，才批准执行。
一个更有效的提示词示例：
“Use bonsai-automation to help create a Bonsai invoice for client Acme Ltd for the completed website audit. First search Rube tools for the current Bonsai invoice schema, then check that the bonsai connection is active. Before executing, show me the required fields, any assumptions, and the exact values you plan to send.”
这比“帮我开一张 invoice”效果更好，因为它提供了意图、实体名称、审批要求，以及必须执行的发现步骤。
能提升输出质量的输入信息
为了获得更好的结果，请提供工具无法安全推断的业务细节：
- Bonsai object type：client、project、invoice、proposal、task、payment 或 time entry。
- 已知的名称或 ID。
- 日期、币种、line items、数量、费率、税务处理方式和到期日。
- 你希望 agent 只起草、搜索、更新，还是实际执行。
- 确认规则，例如“发送前先询问”、“不要修改现有 invoices”或“先展示匹配记录”。
如果你不知道准确的 Bonsai IDs，请让 agent 先搜索并展示候选项。除非搜索结果明确无歧义，否则不要让它仅凭名称更新或删除记录。
优先阅读的仓库文件
先从 composio-skills/bonsai-automation/SKILL.md 中的 SKILL.md 开始。重点阅读 Prerequisites、Setup、Tool Discovery 和 Core Workflow Pattern。这个文件很精简，但一个对采用至关重要的细节很容易被忽略：tool discovery 不是可选步骤。任何跳过 RUBE_SEARCH_TOOLS 的 agent 工作流，都不再符合该 skill 的安全模型。
bonsai-automation skill 常见问题
bonsai-automation 适合新手吗？
适合，前提是你能完成 Rube MCP 连接并授权 Bonsai。与直接编写原始 API 调用相比，这个 skill 依赖 Rube 的当前 schemas，对新手更安全。不过，它仍然默认你理解自己要执行的业务操作。agent 可以发现字段，但无法在没有输入的情况下替你决定 invoice 条款、client 身份或审批策略。
它和普通 Bonsai 提示词有什么不同？
普通提示词依赖模型的通用知识。bonsai-automation 会指示 agent 通过 RUBE_SEARCH_TOOLS 使用实时 MCP discovery，然后通过 RUBE_MANAGE_CONNECTIONS 管理 Bonsai 连接。因此，在真实工作流自动化中，它更适合处理那些会因字段错误、schema 过时或认证未激活而导致执行失败的任务。
什么时候不应该使用 bonsai-automation？
如果你只需要 Bonsai 产品建议、会计指导或手动 UI 操作说明，就不该使用它。对于高风险的批量变更，也应避免直接使用，除非你添加了严格的 review steps、record matching rules 和 confirmation gates。这个 skill 是执行辅助工具，不能替代业务审核。
它必须依赖 Composio 或 Rube MCP 吗？
是的。这个 skill 围绕通过 Rube MCP 暴露的 Composio Bonsai toolkit 构建。如果你的 client 无法连接到 https://rube.app/mcp，或无法暴露 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS，核心工作流就无法按预期运行。
如何改进 bonsai-automation skill
用执行约束优化 bonsai-automation 提示词
提升 bonsai-automation 结果最快的方法，是把发现、计划和执行分开。例如：
“Search Bonsai tools for updating a project status. Do not execute yet. Show required fields, matching project candidates, and the proposed update payload. Ask for confirmation before running the tool.”
这样可以避免 agent 从模糊意图过快跳到真实变更。
需要留意的常见失败模式
最常见的采用障碍包括：Bonsai 授权未激活、跳过 tool discovery、记录匹配不明确，以及缺少必填字段。如果 agent 卡住，请让它明确报告失败发生在哪一步：MCP 可用性、Bonsai 连接状态、schema discovery、缺失输入，还是执行错误。这种诊断比反复提交同一个宽泛请求更有帮助。
在第一次 tool 结果后继续迭代
拿到第一次输出后，应根据 Rube 返回的证据继续细化，而不是依赖假设。如果某个 schema 出现了意料之外的必填字段，请明确提供这些值。如果搜索返回多个 Bonsai records，请通过 ID 或可区分的细节选择其中一个。如果执行计划包含高风险操作，请先要求进行只读查询。
这个 skill 还可以怎样变得更强
如果上游 skill 增加常见 Bonsai 操作的示例任务提示词、明确的 read-before-write 指导，以及针对 invoices、payments 和 record updates 的 confirmation gates 示例，会更有帮助。在这些内容加入之前，用户应围绕 RUBE_SEARCH_TOOLS、RUBE_MANAGE_CONNECTIONS、schema review 和执行前人工批准，建立自己的检查清单。