docmosis-automation

docmosis-automation skill 概览

docmosis-automation 能做什么

docmosis-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行与 Docmosis 相关的工作流自动化。它的目标是帮助 agent 发现当前可用的 Docmosis tool schema，验证 Docmosis 连接状态，并在执行文档自动化任务时减少普通 prompt 常见的猜测和试错。

它的核心价值并不是一套预置脚本库，而是一种执行模式：连接 Rube MCP，认证 docmosis toolkit，在采取操作前先调用 RUBE_SEARCH_TOOLS，再根据返回的 schema 选择正确的 Docmosis 操作。

这个 skill 适合什么场景

如果你希望 AI agent 在更大的工作流自动化体系中协助处理 Docmosis 操作，docmosis-automation skill 会比较适合。它尤其适用于任务依赖实时 tool 可用性、当前 API schema，或需要通过 Composio 访问已认证的 Docmosis 连接的情况。

比较典型的适用对象，是已经使用 Docmosis 生成文档，并希望 Claude 协助编排任务的团队，例如发现可用操作、准备输入、检查连接状态，或把 Docmosis action 串联进更大的业务流程中。

关键区别：先发现 schema

这个 skill 最重要的指令是：始终先搜索 tools。agent 不应该假设 Docmosis API 的形态是固定的，而应针对具体用例调用 RUBE_SEARCH_TOOLS，并依据返回的 tool slug、schema、执行计划和注意事项来行动。

因此，相比把参数硬编码进 prompt 的静态方式，docmosis-automation skill 更适合会变化的 MCP tool 环境。

安装前需要了解的事项

这个 skill 需要 Rube MCP，并且需要通过 RUBE_MANAGE_CONNECTIONS 管理一个有效的 Docmosis 连接。它不包含额外脚本、内置模板或本地辅助文件；仓库路径下只有 SKILL.md。如果你需要的是一套完整的文档模板系统，仍然需要自行准备 Docmosis 模板、数据模型和业务规则。

如何使用 docmosis-automation skill

docmosis-automation 的安装与设置背景

从 Composio skills repository 安装这个 skill：

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

然后在你的 AI client 中加入 Rube MCP 配置：

https://rube.app/mcp

使用这个 skill 之前，先确认 RUBE_SEARCH_TOOLS 可用。接着使用 toolkit docmosis 调用 RUBE_MANAGE_CONNECTIONS。如果连接状态不是 ACTIVE，需要完成返回的授权流程，并在尝试任何 Docmosis 操作前再次检查连接状态。

你需要提供哪些输入

如果你的 prompt 写清楚真实业务目标，而不只是说“使用 Docmosis”，docmosis-automation skill 的效果会更好。建议提供：

• 你希望执行的 Docmosis 任务
• Docmosis 连接是否已经处于 active 状态
• 已知的模板名称、文档标识符或期望输出格式
• 输入数据结构，例如客户字段、发票字段或报告字段
• 任何工作流限制，例如“未经我批准不要发送”或“只先发现 tools”

较弱的 prompt 是：“Create a document with Docmosis.”

更好的 prompt 是：“Use the docmosis-automation skill to discover current Docmosis tools through Rube MCP. Check the docmosis connection, then identify the correct operation for generating a contract from an existing template. I have template name Standard_Service_Agreement and JSON data with client name, address, service dates, and pricing. Do not execute generation until you show the required schema.”

可靠使用的实用工作流

每个工作流都应从 tool discovery 开始：

RUBE_SEARCH_TOOLS

查询内容要贴近真实任务，例如：“generate a PDF from a Docmosis template using customer JSON data” 或 “list available Docmosis templates before document generation.”

然后使用 RUBE_MANAGE_CONNECTIONS 检查 toolkit docmosis 的连接状态。只有在连接处于 active 状态后，agent 才应选择 tool 并准备调用。这个顺序很重要，因为 Rube 可能返回当前 schema、必填字段、推荐执行方案，或静态 skill 文件中看不到的已知风险点。

优先阅读的仓库文件

关键文件是：

• composio-skills/docmosis-automation/SKILL.md

在这个 skill 路径下，没有可见的 README.md、scripts/、references/、resources/ 或 rules/ 文件夹。先阅读 SKILL.md 了解预期工作流，然后依赖实时的 Rube MCP discovery 获取准确的 tool 名称和参数。

docmosis-automation skill 常见问题

docmosis-automation 是用于 Workflow Automation 还是文档设计？

docmosis-automation 主要用于围绕 Docmosis 操作进行 Workflow Automation，而不是用于可视化设计 Docmosis 模板。它可以帮助 agent 通过 Rube MCP 发现并调用可用的 Docmosis tools，但你的组织仍然需要准备底层的 Docmosis 模板、数据源和文档规则。

它比普通 prompt 好在哪里？

普通 prompt 可能会猜测 tool 名称，或者凭空编造参数。docmosis-automation skill 会明确要求 agent 先使用 RUBE_SEARCH_TOOLS，再基于当前 schema 工作。这样可以减少由过时假设导致的失败，也让工作流更能适配 Composio 的实时 toolkit interface。

这个 skill 适合新手吗？

只有在你能够接受连接 MCP server 并完成认证流程的前提下，它才算对新手友好。这个 skill 本身的说明很短，但外围设置很关键：Rube MCP 必须可用，并且 Docmosis toolkit 连接必须处于 active 状态，之后才可能真正开展有用的工作。

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

如果你需要离线文档生成、独立的 Docmosis SDK wrapper、内置示例模板，或不需要认证的演示环境，就不适合使用它。如果你的 AI client 无法使用 MCP tools，也应避免使用，因为这个 skill 依赖 Rube MCP 能力，而不是本地脚本。

如何改进 docmosis-automation skill

改进 prompt，提升 docmosis-automation 结果

提升 docmosis-automation 输出质量最快的方法，是把端到端的文档任务描述清楚。包括预期的 Docmosis 操作、已知模板信息、输入数据字段、期望输出类型、审批步骤，以及是否应在 schema discovery 后停止执行。

例如：“Discover tools first, verify Docmosis connection, then prepare but do not run the generation call for a PDF invoice using template Invoice_v3. Required data fields are invoice number, customer name, line items, subtotal, tax, total, and due date.”

需要避免的常见失败模式

最主要的失败模式是跳过 discovery，直接假设 schema。可以通过明确说明来避免：“Call RUBE_SEARCH_TOOLS before selecting any Docmosis tool.”

另一个常见问题是在认证尚未 active 时就尝试执行。你可以要求 agent 先检查 RUBE_MANAGE_CONNECTIONS，并在继续之前报告连接状态。如果必填字段尚不明确，应在 discovery 后暂停，把你已有的数据映射到返回的 schema 上。

在第一次 tool discovery 后继续迭代

把第一次 RUBE_SEARCH_TOOLS 的结果当作规划步骤。检查返回的 tool slug、必填输入和警告信息，然后细化任务。如果 schema 需要你尚未提供的字段，应把缺失值补充到 prompt 中，而不是让 agent 猜测。

这对文档自动化尤其重要，因为很小的字段不匹配都可能导致文档无效、合并不完整，或生成调用失败。

改进 skill 本身

如果你维护的是 fork，最有价值的改进包括：为常见 Docmosis 工作流补充示例、提供示例 prompt 模式，并增加一个简短的故障排查部分，覆盖连接 inactive 和 schema 缺失等情况。由于当前 skill 没有支持文件，增加关于模板生成、模板列表和输出处理的简明参考，会让 docmosis-automation guide 更容易上手，同时不削弱它以 schema 优先的使用方式。