文档模板方案助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/carbone-automation。
技能介绍
解决什么问题
在文档自动化场景里,很多团队依赖 Carbone 这类模板引擎来批量生成报告、合同、发票等结构化文档。但要让自动化流程真正跑起来,开发者通常要面对两件琐事:一是搞清楚当前账号下到底有哪些可用操作、参数字段是什么,二是保证调用链路上的连接是通的。本技能把这套「先发现、再连接、后执行」的流程封装成一条可复用的工作流,让 Agent 能够按需调用 Carbone 能力,而不是在每个脚本里重复手写鉴权与工具查找逻辑。
核心能力与执行流程
技能基于 Rube MCP,底层通过 Composio 提供的 Carbone 工具包转发请求。它的关键步骤很明确:
- 工具发现:任何工作流执行前,必须先调用
RUBE_SEARCH_TOOLS获取当前可用的工具 slugs、输入 schema、推荐的执行计划以及已知坑点。这一步不能跳过,因为工具的字段和结构会随上游更新而变化。 - 连接管理:通过
RUBE_MANAGE_CONNECTIONS指定toolkit carbone发起连接;如果返回的不是 ACTIVE 状态,需要按照返回的授权链接完成授权,确认状态变为 ACTIVE 后才能继续。 - 批量执行:使用
RUBE_MULTI_EXECUTE_TOOL按发现的 slug 依次执行,并配合RUBE_REMOTE_WORKBENCH完成批量操作。 - Schema 校验:对带有
schemaRef的工具,可通过RUBE_GET_TOOL_SCHEMAS拉取完整 schema,避免凭记忆填参数。
适用边界与注意点
- 技能只负责编排与转发,Carbone 本身的模板渲染逻辑不在本技能范围内。
- 不要在脚本里硬编码工具 slug 或参数,务必以
RUBE_SEARCH_TOOLS的返回结果为准。 - 调用
RUBE_MULTI_EXECUTE_TOOL时即使没有上下文,也要显式传一个空的memory对象。 - 同一工作流内尽量复用 session ID,新工作流再重新生成。
- 分页响应需要检查 token 并循环拉取,否则可能拿到不完整的结果集。
使用场景
- 运营每周要把几十份销售数据套进同一套 Carbone 模板生成周报,手动逐份填表太耗时
- 法务需要把数据库中的合同条款批量填入 Carbone 模板,生成标准化合同文档
- 产品团队定期从数据库拉取最新数据,批量生成 PDF 发布说明并归档
- Agent 在执行文档生成工作流时报连接断开,需要先确认 Carbone 连接是否激活
适合人员
- 后端工程师,正在搭建 Agent 自动化工作流,需要集成文档生成能力
- SaaS 平台运维人员,负责管理 MCP 客户端配置,需要快速定位 Carbone 连接问题
- 批量文档交付的系统架构师,要保证多次调用的 schema 一致性与 session 隔离
- 数据团队工程师,要把数据库中的最新记录自动填入模板生成报表