borneo-automation

borneo-automation skill 概览

borneo-automation 适合做什么

borneo-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行与 Borneo 相关的操作。它的核心价值不在于提供一组固定写死的动作，而是引导 agent 先发现当前可用的 Borneo toolkit tools，验证用户连接状态，再基于 Rube 返回的最新 schema 执行操作。

当你希望 AI agent 通过 MCP 操作 Borneo，而不是手动查 Composio toolkit 文档、猜测 tool 名称，或编写可能使用过期参数的一次性 prompt 时，适合使用这个 skill。

最适合的用户和工作流

borneo-automation skill 最适合已经在 Composio/Rube 中拥有 Borneo connection，或能够创建该连接的用户，并希望让 Claude 协助处理可重复的 workflow automation。对于 tool schema 可能变化的场景，它尤其合适，因为该 skill 明确要求在执行前先使用 RUBE_SEARCH_TOOLS。

它适合以下场景：

• 使用 Claude 和支持 MCP 的客户端的团队。
• 通过 Composio 的 Borneo toolkit 自动化 Borneo 任务的用户。
• 对 connection status、auth state 和 tool schema 准确性有要求的工作流。
• 需要可靠的“发现-检查-执行”模式的 agent。

这个 skill 有什么不同

它最重要的差异点是 schema-first 工作流。borneo-automation 不会假设某个 tool 名称或沿用过期的参数结构，而是要求 agent 调用 RUBE_SEARCH_TOOLS，检查可用的 Borneo tools，然后使用 RUBE_MANAGE_CONNECTIONS 确认 borneo toolkit connection 处于 active 状态。

这让该 skill 适合真实的 workflow automation，因为 MCP tools 会随时间演进。它的取舍也很明确：这个 skill 刻意保持轻量，不包含 scripts、本地 helper、示例业务工作流或内嵌参考文件。它的效果取决于 Rube MCP 的可用性，以及 Composio Borneo toolkit 的实时返回结果。

如何使用 borneo-automation skill

borneo-automation 安装与 MCP 设置

使用以下命令从源仓库安装该 skill：

npx skills add ComposioHQ/awesome-claude-skills --skill borneo-automation

然后确保你的 Claude 兼容客户端已经配置好 Rube MCP。该 skill 的源码指向：

https://rube.app/mcp

MCP 可用后，确认 RUBE_SEARCH_TOOLS 显示为可调用 tool。然后使用 RUBE_MANAGE_CONNECTIONS，并指定 toolkit borneo，检查 connection 是否为 ACTIVE。如果 Rube 返回 auth link，请先完成授权，再让 agent 执行 Borneo 操作。

你需要提供哪些输入

要更好地使用 borneo-automation，不要只说“执行这个 Borneo 任务”。你需要给 agent 足够的操作上下文，让它在完成发现后选择并校验正确的 tool。

较弱的 prompt：

Use Borneo to update the record.

更好的 prompt：

Use borneo-automation for Workflow Automation. First discover current Borneo tools with RUBE_SEARCH_TOOLS, then check my borneo connection. I need to update the Borneo item matching [identifier] so that [field] becomes [new value]. If multiple tools or records match, show the options and ask before executing.

有用的输入包括：

• 具体的 Borneo 任务或业务目标。
• 已知的 ID、名称、筛选条件、日期或记录字段。
• agent 是否可以执行变更，还是只应准备方案。
• 如何处理歧义、重复项、缺失记录或授权失败。

Claude 中推荐的工作流

可靠的 borneo-automation 使用流程应按以下顺序进行：

1. 要求 Claude 使用已安装的 borneo-automation skill。
2. 让它结合你的具体用例调用 RUBE_SEARCH_TOOLS，不要使用泛泛的查询。
3. 让它检查返回的 tool slugs、schemas、execution plans 和 pitfalls。
4. 使用 RUBE_MANAGE_CONNECTIONS 确认 borneo connection status。
5. 只有在必填字段已知且 connection 为 active 后才执行。
6. 要求给出简短的执行摘要，包括使用的 tool、输入、结果以及任何未解决事项。

如果任务在对话中途发生变化，请让 Claude 重新搜索。上游 skill 明确要求先发现当前 schemas。

优先阅读的仓库文件

这个 skill 目前只包含 SKILL.md。如果你想在安装前确认范围、前置条件和 MCP 模式，请先阅读该文件。skill 目录中没有捆绑 scripts、README.md、references、rules 或示例 workflow 文件夹，因此实时的 Rube 搜索结果才是 tool 级细节的真正来源。

外部参考方面，源码指向 Composio Borneo toolkit 文档：composio.dev/toolkits/borneo。

borneo-automation skill 常见问题

没有 Rube MCP 时，borneo-automation 有用吗？

没有。该 skill 需要 Rube MCP，特别是需要访问 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 等 tools。没有 MCP tool access 时，它只剩下一种 prompt pattern，无法自动化执行 Borneo 操作。

它比普通 prompt 好在哪里？

普通 prompt 可能会猜测 Borneo tool 名称、参数或 auth state。borneo-automation skill 强制采用更安全的顺序：先发现 tools，验证 connection，再使用当前 schema 执行。这能减少因文档过期、tool 改名或缺少必填字段导致的失败。

适合新手使用吗？

如果你的 MCP client 已经配置好，它可以比较适合新手。设置概念并不复杂，但用户必须理解：agent 需要实时 tool access，并且需要一个 active 的 Borneo connection。如果你刚接触 MCP，第一次会话很可能主要用于 connection setup，而不是直接执行任务。

什么时候不该使用这个 skill？

当你需要离线处理、本地专用 scripts，或希望仓库中包含完整记录好的 Borneo workflow template 时，不应使用 borneo-automation。如果你的组织不允许 agent 调用外部 MCP tools，或不允许其管理已连接应用的授权，也应避免使用它。

如何改进 borneo-automation skill

改进 borneo-automation 的 prompts

提升结果质量最快的方法，是让目标操作可验证。请包含目标对象、选择条件、允许的操作和确认规则。

更好的 prompt 模式：

Use borneo-automation. Search current Borneo tools for [exact task]. Check my borneo connection. If the matching tool requires fields I have not provided, ask for them before execution. Do not modify data until I confirm the planned tool call.

这能帮助 agent 避免过早执行，并让 schema discovery 真正发挥作用，而不是变成形式化步骤。

需要预防的常见失败模式

最常见的失败是跳过 tool discovery，直接使用假设的 schemas。另一个常见问题是在 Borneo connection 未激活时尝试执行。第三类问题是记录引用过于模糊，导致 agent 选错对象。

可以通过以下要求来预防：

• 每种新任务类型执行前都先使用 RUBE_SEARCH_TOOLS。
• 写入操作前先使用 RUBE_MANAGE_CONNECTIONS。
• 对破坏性或不可逆操作增加确认步骤。
• 明确处理“无匹配”和“多个匹配”的情况。

首次输出后继续迭代

在第一次执行或给出方案后，要求 Claude 汇报它实际从 Rube 学到了什么：tool slug、必填输入、可选输入、返回的 warnings 和执行结果。如果结果不完整，请围绕缺失字段或失败假设来细化下一条 prompt，而不是笼统地重新开始。

后续提问示例：

Re-run discovery only if needed. Use the same session if possible. The previous attempt failed because [field] was missing. Ask me only for fields required by the selected Borneo tool, then continue.

面向团队的实用补充

团队可以通过添加本地 examples、已批准的 workflow prompts、写入操作的 risk rules，以及组织内部的 naming conventions 来改进这个 skill。增加一个小型 references/ 文件，记录常见 Borneo 任务和必需的业务上下文，可以让 borneo-automation 更容易复用，同时不削弱它的 schema-first 设计。