deel-automation

deel-automation skill 概览

deel-automation 能做什么

deel-automation 是一个 Claude skill，用于通过 Composio 的 Rube MCP server 执行与 Deel 相关的工作流自动化。它的核心价值不在于提供一段固定的 Deel 脚本，而是指导 agent 先用 RUBE_SEARCH_TOOLS 发现当前可用的 Deel tool schema，再用 RUBE_MANAGE_CONNECTIONS 验证 Deel 连接状态，最后才执行合适的 Rube MCP tool。

当你希望让 agent 协助处理 Deel 操作，同时又需要它基于实时 tool catalog 行动、而不是猜测旧 API 字段时，适合使用这个 deel-automation skill。

最适合的用户和任务

deel-automation skill 适合已经在使用 Deel，并希望用 AI 辅助执行可重复管理任务的运营、财务、HR、创始人和自动化搭建者。它尤其适合那些 tool 名称或 input schema 可能会变化的工作流，因为这个 skill 明确要求 agent 在执行前先做 tool discovery。

典型用例包括：让 agent 找到正确的 Deel MCP action、准备安全的执行计划、检查 Deel 连接是否处于可用状态，并在确认后运行范围清晰的操作。

面向 Workflow Automation 的关键差异

对于 Workflow Automation 来说，关键点是 Rube-first 模式：先发现 tools，再检查连接状态，接着查看 schema，最后执行。普通 prompt 可能会幻觉出一个 Deel endpoint，或者跳过认证检查。deel-automation 通过把实时 schema 查询纳入工作流，降低了这类风险。

这个 skill 刻意保持精简。它不包含脚本、模板或本地资源；它真正的实用价值在于强制 agent 遵循正确的 MCP 调用顺序。

如何使用 deel-automation skill

deel-automation 安装与设置背景

可以通过你的 skill manager 从仓库路径安装该 skill，例如：

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

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

https://rube.app/mcp

该 skill 需要 Rube MCP，以及一个处于可用状态的 Deel 连接。实际使用时，agent 必须能够调用 RUBE_SEARCH_TOOLS 和 RUBE_MANAGE_CONNECTIONS。如果 Deel toolkit connection 尚未激活，请使用 toolkit deel 调用 RUBE_MANAGE_CONNECTIONS，并完成返回的认证流程，然后再让 agent 执行真实任务。

你需要提供哪些输入

一个高质量的 deel-automation 使用 prompt 应该包含明确的业务目标、Deel object type、约束条件、审批要求，以及 agent 是可以执行操作，还是只应准备计划。

较弱的 prompt：

Handle my Deel task.

更好的 prompt：

Use deel-automation to find the current Rube MCP tools for Deel. I need to review contractor payment-related options for a contractor named Jane Doe. First search available Deel tools, confirm the Deel connection is active, show me the matching tool schemas and required fields, then wait for approval before executing anything.

这样效果更好，因为 agent 可以把目标映射到实时 tool schema，并避免过早执行。

执行前推荐的工作流

先阅读 composio-skills/deel-automation/SKILL.md；这是主要源文件，里面包含必需的 MCP 调用顺序。这个 skill 没有额外的 scripts/、references/、resources/ 或 README.md 文件，因此不要期待还有隐藏的实现辅助内容。

一个更安全的工作流是：

1. 要求 agent 针对具体的 Deel 用例调用 RUBE_SEARCH_TOOLS。
2. 要求它总结候选 tool slugs、必填字段和潜在风险点。
3. 使用 RUBE_MANAGE_CONNECTIONS 检查 Deel 连接。
4. 提供缺失的业务标识符，或批准一次查询步骤。
5. 对任何会修改 Deel 数据的操作，都要求最终确认后再执行。

实用 prompt 模板

调用 deel-automation skill 时，可以使用这个模式：

Use deel-automation. My goal is: [specific Deel outcome]. First discover current Deel tools with RUBE_SEARCH_TOOLS; do not assume tool names or fields. Check the Deel connection with RUBE_MANAGE_CONNECTIONS. If the task is read-only, proceed after showing the schema. If the task changes data, show the proposed tool call and wait for my approval.

这能给 agent 足够明确的结构，让它按照 skill 的流程执行，而不是把问题当成一个普通的 Deel 咨询来处理。

deel-automation skill 常见问题

deel-automation 是 Deel API wrapper 吗？

不是。deel-automation 是一个 skill，用来指导 AI agent 通过 Rube MCP 使用 Composio 的 Deel toolkit。实时 tools、schemas 和连接状态都来自 Rube，而不是来自 skill 自带的文件。

最常见的采用阻碍是什么？

常见阻碍包括：缺少 Rube MCP 访问权限、Deel 连接未激活，或者 prompt 没有足够清楚地说明 Deel 任务。如果 RUBE_SEARCH_TOOLS 不可用，这个 skill 就无法按照预期流程运行。如果 Deel 连接不是 ACTIVE 状态，应暂停执行，直到认证完成。

它比普通 Deel prompt 更好吗？

当你需要通过 MCP 执行动作时，是的。普通 prompt 可能会解释在 Deel 里应该做什么，但未必会检查当前 tool schema 或验证连接状态。deel-automation guide 的价值在于，它会强制 agent 在执行前先做 tool discovery，这对可靠的自动化非常关键。

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

不要把它用于通用 HR 政策建议、法律解释、薪资合规决策，或任何你无法通过 Rube MCP 授权 AI client 访问 Deel 的任务。如果你需要的是完全脚本化的批处理流程，也不适合使用它；这个 skill 提供的是 agent 工作流模式，而不是生产级代码。

如何改进 deel-automation skill

用更清晰的范围改进 deel-automation prompt

提升结果质量最快的方法，是把任务范围收窄。请包含姓名、可用的 ID、相关国家或合同背景、只读还是写入意图，以及审批边界。

更好的输入示例：

• “Find the current Deel tools for contractor lookup and list required fields.”
• “Prepare, but do not execute, the tool call needed to retrieve invoice information for this contractor.”
• “After schema discovery, ask me for any missing required fields before running the action.”

留意常见失败模式

最主要的失败模式，是跳过 discovery 并直接编造 tool call。如果 agent 没有先调用 RUBE_SEARCH_TOOLS，应立即纠正它。另一个风险是把连接检查当成可选步骤；对于 Deel workflow automation，在使用任何 operational tool 之前，都应该验证连接状态。

对于破坏性操作或涉及资金的操作，要求 agent 提供一份人类可读的执行预览：tool slug、input JSON、预期影响，以及已知的回滚或取消限制。

根据首次输出继续迭代

拿到第一次 discovery 结果后，不要让 agent 过快选择某个 tool，而是要求它比较候选 tools：

Which Deel tool best matches this task, what fields are mandatory, what fields are optional, and what could go wrong if we use it?

然后补充缺失的标识符，并在批准前要求它给出类似 dry-run 的摘要。这样可以把 deel-automation 从一次性命令，变成一个可控的运营工作流。

改进 skill 本身

如果你维护本地 fork，可以考虑增加只读和写入工作流的具体示例 prompt、针对付款或合同变更的简短安全 checklist，以及指向内部审批政策的链接。核心规则不要改变：deel-automation skill 在尝试执行 Deel 操作前，始终应该先发现当前的 Rube MCP tool schema。