carbone-automation

carbone-automation skill 概览

carbone-automation skill 能做什么

carbone-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 运行与 Carbone 相关的工作流自动化。它可以帮助 agent 发现当前可用的 Carbone tool schemas、验证 Carbone 连接，并执行文档/报表自动化任务，避免凭空猜测 tool 名称或使用过期参数。

这个 skill 更适合已经在使用，或计划使用 Carbone 做基于模板的文档生成的用户；如果你希望让 AI agent 通过 MCP 操作 Carbone，而不是每次都手动查 Composio toolkit 文档，它会很有用。

最适合的使用场景

当你的任务依赖实时 Carbone tooling 时，可以使用 carbone-automation skill，例如从模板生成文档、检查可用的 Carbone 操作，或把 Carbone 接入更大的工作流自动化流程。

它尤其适合以下情况：

• 你的 MCP client 支持 Rube MCP tools。
• 你需要 agent 在执行前检查当前 schemas。
• 你的 Carbone 账号或连接状态可能会在不同会话之间变化。
• 你想要一个可复用的“discover, connect, execute, verify”流程，而不是一次性的 prompt。

关键采用前提

主要门槛不在 skill 本身，而在外部工具设置。carbone-automation 需要 Rube MCP，并且需要通过 Composio 建立有效的 Carbone 连接。上游 skill 明确依赖 rube MCP server，并预期 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 可用。

如果你的环境无法连接到 https://rube.app/mcp，或者你无法授权 Carbone toolkit，这个 skill 就不能真正执行 Carbone 操作。

如何使用 carbone-automation skill

carbone-automation 的安装与设置路径

从 Composio skill collection 安装该 skill：

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

然后在你的 AI client 中添加 Rube MCP：

https://rube.app/mcp

源 skill 说明，添加 MCP endpoint 不需要 API key，但 Carbone toolkit 仍然需要有效连接。MCP 可用后，先让 agent 验证 RUBE_SEARCH_TOOLS 是否响应，然后为 carbone toolkit 调用 RUBE_MANAGE_CONNECTIONS。如果连接状态不是 ACTIVE，请先完成返回的授权流程，再请求任何 Carbone 执行操作。

你需要提供哪些输入

一个高质量的 carbone-automation 使用 prompt 应该包含业务目标、你预期的 Carbone 对象或操作、模板或文档上下文、输入数据结构、输出格式以及成功标准。

较弱的 prompt：

Generate my report with Carbone.

更好的 prompt：

Use the carbone-automation skill. First discover current Carbone tools with RUBE_SEARCH_TOOLS. Check that the carbone connection is active. I need to generate a PDF invoice from a Carbone template. The data includes customer name, invoice number, line items, tax, and total. Tell me which tool schema you found before executing, and stop if required fields are missing.

这样效果更好，因为 agent 会明确知道要先发现 schemas、验证连接状态，并避免编造参数。

真实任务中的推荐流程

要更稳定地用 carbone-automation 处理 Workflow Automation，建议按这个顺序执行：

1. 让 agent 使用你的具体 Carbone 任务调用 RUBE_SEARCH_TOOLS，不要只写“Carbone operations”。
2. 要求它在执行前总结可用的 tool slugs、必填字段和风险。
3. 使用 RUBE_MANAGE_CONNECTIONS 检查 Carbone 连接。
4. 补充缺失的 template IDs、文件引用、data payloads 或输出偏好。
5. 只有在 schema 和连接都确认后，才执行选定的 tool。
6. 查看返回结果；如果失败，要求 agent 给出结构化的排障摘要。

这个 skill 最重要的规则是：先搜索 tools。Rube schemas 可能变化，而源 skill 的设计目的就是避免过期 tool call。

优先阅读的仓库文件

仓库路径是：

composio-skills/carbone-automation/SKILL.md

在提供的文件树中，没有额外的 resources/、references/、scripts/ 或 README.md 文件，因此 SKILL.md 是主要来源。请优先阅读它来了解前置条件、设置方式、tool discovery 以及核心工作流模式。外部能力细节可参考 composio.dev/toolkits/carbone 上链接的 Composio toolkit 文档，但 tool schemas 应以实时 RUBE_SEARCH_TOOLS 输出为最终依据。

carbone-automation skill 常见问题

carbone-automation 只适合开发者吗？

不只适合开发者，但对于熟悉 MCP-based automation 和账号授权流程的用户来说最容易上手。非开发者也可以使用，前提是 MCP client 已经配置好，并且能够提供具体的文档生成信息，例如模板名称、数据字段和期望输出。

它比普通 Carbone prompt 好在哪里？

普通 prompt 可以描述你想要什么，但可能会幻觉出 Carbone tool 名称、漏掉认证检查，或使用过期参数。carbone-automation skill 固化了最关键的操作习惯：先用 RUBE_SEARCH_TOOLS 发现当前 tools，检查 Carbone 连接，再基于返回的 schema 执行。

什么时候不应该安装 carbone-automation？

如果你只是需要关于 Carbone 模板的一般建议、你的 client 不支持 Rube MCP，或者你无法通过 Composio 授权 Carbone 连接，就不建议安装。对于不需要实时执行 Carbone tool 的工作流，它也没有必要。

它包含现成脚本或模板吗？

不包含。现有仓库信息显示只有一个 SKILL.md，没有 scripts/、resources/ 或 references/ 等支持目录。它的价值在于 MCP 工作流模式，而不是内置模板或辅助代码。

如何改进 carbone-automation skill

用 schema-aware 细节改进 prompt

想让 carbone-automation 的效果更好，第一条用户请求应当偏“操作型”，而不是只做描述。请包含：

• 你想完成的确切 Carbone 任务。
• 已知的 template IDs、文档名称或文件引用。
• 期望的输入数据结构。
• 输出类型、命名规则和目标位置。
• agent 是应该立即执行，还是先等待确认。

这能减少来回澄清，并帮助 RUBE_SEARCH_TOOLS 返回更相关的 tool plan。

需要提前规避的常见失败模式

最常见的问题包括缺少 MCP 访问、Carbone 授权未激活、任务描述过于模糊，以及跳过 tool discovery。可以要求 agent 在执行前展示发现到的 schema，以此规避这些问题。

一个有用的防护型 prompt 是：

Do not call any Carbone execution tool until you have searched tools for this exact use case, checked the carbone connection status, and listed required fields I still need to provide.

首次输出后继续迭代

第一次运行后，不要只说“fix it”。请提供返回的错误、使用的 tool slug、必填字段、payload 摘要，以及你原本期望的结果。要求 agent 将失败调用与 RUBE_SEARCH_TOOLS 返回的最新 schema 进行对比。

好的迭代 prompt：

The Carbone call failed with this error: [paste error]. Re-run tool discovery for the same use case, compare the required schema with the payload used, identify the mismatch, and propose the smallest corrected call.

改进 skill 本身

如果你维护的是 fork，最有价值的改进包括：为常见 Carbone 工作流添加示例、提供基于模板生成 PDF 的 sample prompts，以及补充针对连接未激活或字段缺失的排障说明。由于当前 skill 很精简，加入经过验证的示例，可以在不改变其核心“discover first”设计的前提下，让 carbone-automation guide 更容易被采用。