docugenerate-automation

docugenerate-automation skill 概览

docugenerate-automation 能做什么

docugenerate-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP 集成来运行 Docugenerate 工作流。它的实际用途不是从零教学文档生成，而是帮助 agent 发现当前的 Docugenerate 工具 schema、验证用户连接，并在执行 Docugenerate 操作时减少自由提示词带来的猜测。

最适合工作流自动化团队

这个 skill 最适合已经在使用，或计划在更大自动化流程中使用 Docugenerate 的用户：例如从模板生成文档、触发文档相关操作，或把文档生成接入其他支持 MCP 的工作。如果你的 agent 环境支持 Rube MCP，并且你想为 Docugenerate automation 建立可重复的执行模式，而不是每次都手动检查工具名称和参数，那么它尤其适用。

主要差异点：先发现 schema

docugenerate-automation skill 最大的价值在于它的“先搜索工具”执行规则。它不会假设固定的 API 名称，而是要求 agent 在执行操作前先调用 RUBE_SEARCH_TOOLS。这一点很重要，因为 Composio toolkit 的 schema 可能会变化，而过时的假设正是工作流自动化失败的常见原因。

采用要求与限制

这是一个轻量级 skill，只包含一个 SKILL.md，没有随附脚本、示例或本地辅助文件。要成功使用它，你需要在客户端中可用的 Rube MCP、能够响应的 RUBE_SEARCH_TOOLS，以及一个通过 RUBE_MANAGE_CONNECTIONS 管理、toolkit 为 docugenerate 的有效 Docugenerate 连接。如果你需要离线文档生成、自定义 Docugenerate SDK 代码，或完整的终端用户应用，这个 skill 只能作为起点。

如何使用 docugenerate-automation skill

安装并检查 MCP 上下文

从仓库路径安装 skill：

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

然后确认你的 agent 客户端可以访问 Rube MCP。上游 skill 期望你在客户端中配置 MCP server endpoint https://rube.app/mcp，并依赖 RUBE_SEARCH_TOOLS 可用。在请求文档工作流之前，请使用 toolkit docugenerate 通过 RUBE_MANAGE_CONNECTIONS 验证你的 Docugenerate 连接是否处于 active 状态。

按正确顺序阅读源码

从 composio-skills/docugenerate-automation/SKILL.md 开始。提供的文件树中没有单独的 README.md、rules/、references/、resources/ 或 scripts/ 文件夹，因此这个 skill 的行为集中在这一个文件里。重点关注 prerequisites、setup sequence、tool discovery requirement 和 core workflow pattern；这些部分定义了 agent 应如何调用 Rube tools。

提供 skill 能执行的输入

较弱的提示词是：“Generate a document with Docugenerate.” 更好的 docugenerate-automation 使用提示词会包含任务、源数据、模板假设、期望输出，以及允许先发现工具：

“Use the docugenerate-automation skill. First call RUBE_SEARCH_TOOLS for the current Docugenerate schema. Check whether my docugenerate connection is active. I need to generate a contract from an existing Docugenerate template. The document should use these fields: client name, effective date, service package, monthly price, and billing address. If the tool schema requires template IDs or output format options, ask me for missing values before execution.”

这样可以给 agent 足够的上下文去发现正确工具，避免编造参数，并在缺少必要 ID 或认证时停止执行。

推荐执行流程

建议把这个 skill 作为四步工作流使用：先用 RUBE_SEARCH_TOOLS 发现工具，检查 Docugenerate 连接，选择搜索结果返回的相关工具，然后按照当前 schema 执行。尽可能保持同一个 Rube session ID，这样 agent 可以从发现阶段到执行阶段保留上下文。如果搜索响应中包含注意事项或推荐执行计划，应以它们为准，而不是依赖记忆或旧示例。

docugenerate-automation skill 常见问题

docugenerate-automation 适合新手吗？

如果已经配置好 Rube MCP，新手也可以使用它，但它不是 Docugenerate 本身的 no-code 教程。这个 skill 假设你能够完成认证链接、判断连接是否 active，并提供操作所需的文档模板或数据。

它比普通提示词好在哪里？

普通提示词可能会猜测 Docugenerate 的工具名称或输入字段。docugenerate-automation skill 明确要求先调用 RUBE_SEARCH_TOOLS，因此 agent 应先获取当前工具 slug、schema、执行计划和注意事项，再采取行动。对于工作流自动化来说，一个错误参数就可能中断运行，这种做法更可靠。

什么时候不应该安装这个 skill？

如果你的环境无法使用 Rube MCP，或者你需要纯本地的文档生成工作流，或者你的主要需求是模板设计指导而不是工具执行，就不应该安装它。也不要把它当作完整的自动化包来使用；它没有随附脚本、测试框架或现成文档模板。

它能在 Composio 生态之外使用吗？

这个 skill 是专门为 Composio 的 Rube MCP 和 Docugenerate toolkit 编写的。你可以在其他地方借鉴这种工作流思路，但实际调用如 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS 都是 Composio/Rube 特定的。

如何改进 docugenerate-automation skill

用具体工作流数据改进提示词

为了获得更好的 docugenerate-automation 结果，请向 agent 提供明确的任务类型、已知模板名称或 ID、必需的 merge fields、首选输出格式，以及任何下游动作。好的输入能减少来回确认，并帮助 agent 在发现工具后选择正确的 Docugenerate tool，而不是提出宽泛的澄清问题。

避免最常见的失败模式

主要失败模式包括 Docugenerate 连接未认证、跳过工具发现、缺少模板标识符，以及假设 schema。可以通过明确告诉 agent 来避免这些问题：“Do not execute until RUBE_SEARCH_TOOLS has returned the current schema and the Docugenerate connection is ACTIVE.” 这个约束比只是要求模型“be careful”更有用。

首次运行后继续迭代

第一次输出后，检查生成的文档是否使用了正确的模板、字段映射和输出设置。如果有问题，不要只说“fix it”。请提供失败的字段名、期望值，以及 Rube tool 返回的任何错误。下一条提示词应复用已发现的 schema；如果先前结果看起来已经过时，则要求 agent 重新搜索。

为团队使用扩展 skill

团队可以通过在 workflow pattern 附近加入内部示例来改进已安装的 skill：已批准的模板 ID、标准字段映射、命名规范和安全重试规则。请将这些补充内容与 secrets 分开保存。最有价值的增强是添加一个简短的 “known Docugenerate tasks” 部分，把业务请求（例如 “create invoice PDF” 或 “generate onboarding packet”）映射到 agent 在执行前必须收集的信息。