signwell-automation

signwell-automation skill 概览

signwell-automation 的作用

signwell-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 自动化 Signwell 工作流。它不会把 Signwell API 调用硬编码进流程，而是要求 agent 先发现当前的 Composio Signwell tool schemas，确认用户的 Signwell 连接状态，然后再执行匹配的 Rube tools。

signwell-automation 最适合希望让 AI agent 在工作流自动化环境中准备或执行 Signwell 相关操作的用户，尤其适用于可用 tool 名称和 schemas 可能随时间变化的场景。

最适合的使用场景

当你的目标是通过 Rube MCP 把 Claude 连接到 Signwell actions 时，可以使用 signwell-automation skill，例如搜索可用的 Signwell automation tools、检查授权状态，或在处理文档和收件人之前先构建一个安全的执行计划。

它最适合的并不是“从零编写一个 Signwell API integration”，而是“帮助我的 agent 正确使用当前的 Composio Signwell toolkit”。

这个 skill 为什么有用

它最重要的区别在于强制要求发现步骤：skill 会指示 agent 在运行工作流之前先调用 RUBE_SEARCH_TOOLS。这一点很关键，因为 MCP tool schemas、必填字段和执行计划，可能与静态 prompt 中假设的内容不同。

对于是否安装的判断，关键依赖非常明确：只有在 Rube MCP 可用，并且可以通过 RUBE_MANAGE_CONNECTIONS 激活 Signwell 连接时，这个 skill 才真正有价值。

需要了解的主要限制

这个 skill 的仓库有意保持很小：主要实现是 SKILL.md，没有配套脚本、规则、参考资料或 examples 文件夹。这让它很容易检查，但也意味着用户必须在 prompt 中提供实际的 Signwell 任务细节、文档上下文、收件人信息和审批约束。

不要把 signwell-automation 当成完整的文档生成系统或独立的 Signwell client 来安装。

如何使用 signwell-automation skill

signwell-automation 安装上下文

如果你使用兼容的 skills installer，可以从源仓库安装：

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

然后在你的 client 中添加 MCP server endpoint 来配置 Rube MCP：

https://rube.app/mcp

这个 skill 依赖可用的 rube MCP server。在尝试执行 Signwell 工作之前，请确认 agent 能够访问 RUBE_SEARCH_TOOLS。

自动化前必须完成的设置

有效的 signwell-automation 使用流程应从连接验证开始，而不是直接执行文档操作。

1. 要求 agent 验证 RUBE_SEARCH_TOOLS 是否可用。
2. 使用 RUBE_MANAGE_CONNECTIONS，toolkit 设为 signwell。
3. 如果连接不是 ACTIVE，完成返回的授权流程。
4. 只有当 Signwell 连接状态为 active 后再继续。
5. 在执行前，要求 agent 针对你的具体 Signwell 使用场景搜索 tools。

这套顺序可以避免一种常见失败：agent 编造参数，或假设过期的 tool schemas 仍然可用。

获得更好结果的 prompt 写法

较弱的 prompt 是：

Send this contract through Signwell.

更适合 signwell-automation skill 的 prompt 是：

Use signwell-automation for Workflow Automation. First call RUBE_SEARCH_TOOLS for the current Signwell tools and schemas. Then check my Signwell connection with RUBE_MANAGE_CONNECTIONS. If active, create an execution plan for sending a contract for signature. The document is already available at [location or attachment]. Recipients are: name, email, signing order, role. Do not send until you show me the exact action, required fields, and confirmation step.

这种写法效果更好，因为它同时告诉 agent 要完成的任务、安全边界、必须执行的发现步骤，以及 Signwell 工作流通常需要的业务输入。

优先阅读的文件

先阅读 composio-skills/signwell-automation/SKILL.md。它包含实际操作说明：前置条件、设置、tool discovery、连接检查，以及核心工作流模式。

这个 skill 没有列出 scripts/、references/、resources/ 或 rules/ 等支持目录，因此不要花时间寻找隐藏的实现逻辑。它的价值在于约束 agent 如何执行 MCP 工作流。

signwell-automation skill 常见问题

signwell-automation 适合新手吗？

适合，前提是你已经在使用支持 MCP 的 client，并且能够添加 Rube MCP endpoint。这个 skill 的流程很简单：发现 tools，检查连接，必要时对 Signwell 进行授权，然后运行选定的 tool。

如果你从未配置过 MCP servers，或者还不清楚自己想自动化哪个 Signwell action，它对新手就没那么友好。

它比普通 prompt 好在哪里？

普通 prompt 可能只是要求模型“use Signwell”，但模型可能会猜测 tool 名称，或依赖过时的假设。signwell-automation skill 明确要求先执行 RUBE_SEARCH_TOOLS，因此 agent 应该在采取行动前获取当前的 tool slugs、schemas、执行计划和潜在问题。

相比通用的 Signwell prompt，这让它在实时工作流自动化中更安全。

我需要 Signwell API key 吗？

skill 源文件说明，Rube MCP 设置使用 endpoint https://rube.app/mcp，仅添加 MCP server 不需要 API keys。不过，你仍然需要通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit signwell 建立 active 的 Signwell 连接。如果需要授权，tool 应该会返回 auth link。

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

如果你只需要离线起草文档、自定义 Signwell API wrapper、批量法律审阅，或不能依赖 Rube MCP 的工作流，就不要使用 signwell-automation。若你无法提供收件人详情、文档来源、签署顺序或审批规则，也应避免使用；这些信息 skill 无法可靠推断。

如何改进 signwell-automation skill

执行前明确输入

提升 signwell-automation 结果的最佳方式，是一开始就提供完整的操作细节：文档位置、收件人姓名和邮箱、角色、签署顺序、消息文本、截止日期、提醒偏好，以及 agent 是否可以立即发送，还是必须先请求审批。

对于敏感文档，请明确告诉 agent：生成 tool plan 后停止，并等待确认。

避免 schema 和 tool 名称错误

在 prompt 中保持发现要求清晰可见：

Always call RUBE_SEARCH_TOOLS for this exact Signwell task before choosing tools. Use the returned schema, not memory.

这可以减少幻觉参数，尤其重要的是，这个 skill 的设计基础是当前 Rube MCP tool discovery，而不是静态的 Signwell commands。

在第一版计划后迭代

把第一轮输出当作执行计划，而不是最终操作。要求 agent 展示：

• selected tool slug
• required fields
• missing inputs
• connection status
• irreversible actions
• confirmation point before sending

然后用缺失的数据修订 prompt。相比让 agent 尝试执行一个信息不完整的文档工作流，这样更快也更安全。

改进 skill 本身

如果要扩展这个仓库，最有价值的补充是实用示例：常见 Signwell tasks、sample prompts、approval checkpoints，以及预期的 RUBE_SEARCH_TOOLS discovery patterns。增加一小段 troubleshooting，覆盖 inactive connections、missing schemas 和 authorization loops，也能让 signwell-automation guide 在不改变核心工作流的情况下更容易上手。