企业官网建设流程全解析

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化

deel-automation 是 awesome-claude-skills 仓库中面向 Deel（全球用工与薪酬管理平台）的预置工作流技能，它通过 Composio 的 Deel 工具包 + Rube MCP 通道，让 Claude 等 Agent 以"先发现工具、再校验连接、最后执行调用"三步法完成合同、薪酬、雇员信息等批量操作。读完本文，你将掌握从零接入 Rube MCP、理解工具发现机制、按规范执行RUBE_MULTI_EXECUTE_TOOL调用、规避常见坑位的完整实战路径。

一、技能定位：deel-automation 在仓库中的角色

本技能是仓库内 composio-skills 目录下的一支 Claude Skill。根据 README.md 的说明，该目录为 78 个 SaaS 应用预置了工作流技能，每个技能都包含工具调用序列、参数指引、已知陷阱和速查表，且全部使用从 Composio API 发现的真实工具 slug——这意味着技能的编写原则是"schema 以实时代码为准，而非硬编码臆测"。

与仓库中其他技能（如 composio-skills/composio-automation/SKILL.md）一样，deel-automation 的文件头部带有 YAML frontmatter：

--- name: deel-automation description: "Automate Deel tasks via Rube MCP (Composio). Always search tools first for current schemas." requires: mcp: [rube] ---

这里的三项元数据有明确作用：

• name：技能唯一标识，用于 Agent 在会话启动时按名检索；
• description：技能何时被加载的"触发器"——它显式强调"Always search tools first"，将"动态发现 schema"作为本技能的强制行为准则；
• requires.mcp: [rube]：声明技能运行依赖名为rube的 MCP 服务器，Agent 在加载该技能时即知道需要确保 Rube MCP 已连接。

结合 README.md 对 Skills 加载机制的说明：会话启动时 Agent 只看到每个技能的 name 与 description（约 100 tokens），只有当任务与该描述相关时才加载完整 SKILL.md 正文（通常不超过 5000 tokens）。因此这份 SKILL.md 本身就承担着"触发判断 + 执行规范"双重职责，写得精炼而可操作。

二、前置条件（Prerequisites）

在运行任何 Deel 自动化工作流之前，必须满足以下三条，缺一不可：

1. Rube MCP 必须已连接——以RUBE_SEARCH_TOOLS工具可用作为连通性判断标准；
2. Deel 连接必须处于 ACTIVE 状态——通过RUBE_MANAGE_CONNECTIONS以 toolkitdeel建立，未激活时工具调用会失败；
3. 每次执行前必须调用RUBE_SEARCH_TOOLS——获取当前最新的工具 schema，禁止跳过。

其中第 3 条是全技能的第一原则：Composio 的工具集随平台演进持续变化，工具 slug 与入参字段并非稳定常量，只有实时发现的结果才可信。

三、环境搭建：接入 Rube MCP

Rube MCP 的接入成本被刻意压到最低——不需要任何 API Key：

在客户端配置中把https://rube.app/mcp添加为一个 MCP Server 端点，添加后即可直接工作。

接入后按以下 4 步完成校验与连接：

1. 验证连通性：确认RUBE_SEARCH_TOOLS工具能被正常响应；
2. 建立连接：调用RUBE_MANAGE_CONNECTIONS，传入 toolkitdeel；
3. 完成授权：若返回的连接状态不是ACTIVE，点击返回的授权链接完成 Deel 账号的 OAuth 设置；
4. 状态确认：在运行任何工作流之前，确认连接状态显示为ACTIVE。

这套流程的价值在于把"授权失败"从执行阶段前置到连接阶段——大多数 Deel 自动化失败并非调用写法错误，而是连接从未真正激活。

四、工具发现：为什么"先搜索"是不可省略的第一步

在任何工作流执行之前，技能强制要求先执行工具发现：

RUBE_SEARCH_TOOLS queries: [{use_case: "Deel operations", known_fields: ""}] session: {generate_id: true}

这条调用返回四类关键信息：

• 可用的工具 slug（如具体的 Deel 操作名）；
• 输入 schema（字段名、类型、必填项、取值范围）；
• 推荐的执行计划（Composio 对同类任务的编排建议）；
• 已知陷阱（该工具集特有的坑位提示）。

session参数说明：{generate_id: true}表示本工作流启动一个新会话并自动生成 session ID；后续步骤应复用该 ID，保持工作流内的上下文连贯。known_fields留空字符串表示不做字段预过滤，交由搜索器按 use_case 全量匹配。

从实现层面看，这一步保证了 composio-skills/deel-automation/SKILL.md 中RUBE_MULTI_EXECUTE_TOOL的arguments永远填写"schema 兼容"的参数——由于工具集会迭代，任何把 slug 或字段硬编码进 Skill 的做法都会在平台升级后失效，这正是本技能反复强调动态发现的原因。

五、核心工作流：三步执行模式

整个 Deel 自动化遵循固定的三步模式，每一阶段对应一个 Rube 工具调用。

Step 1：发现可用工具

RUBE_SEARCH_TOOLS queries: [{use_case: "your specific Deel task"}] session: {id: "existing_session_id"}

与第四节不同，这里queries.use_case应替换为你具体的 Deel 业务任务描述（例如合同签署、薪酬发放、雇员信息变更等场景的英文表述），以便返回与该任务最相关的工具；同时复用上一步生成的existing_session_id，而不是再开新会话。

Step 2：检查连接状态

RUBE_MANAGE_CONNECTIONS toolkits: ["deel"] session_id: "your_session_id"

在真正执行前再确认一次 Deel 连接。若此处返回非 ACTIVE，应立即中断流程、走授权链接完成连接，而不是盲目继续——这是将"连接态"作为执行前置条件的第二次强校验（首次在环境搭建阶段）。

Step 3：执行工具

RUBE_MULTI_EXECUTE_TOOL tools: [{ tool_slug: "TOOL_SLUG_FROM_SEARCH", arguments: {/* schema-compliant args from search results */} }] memory: {} session_id: "your_session_id"

关键点拆解：

• tool_slug必须取自 Step 1 的搜索结果，不要凭记忆或文档历史值填写；
• arguments必须严格按搜索返回的 schema 填写字段名与类型，多字段、少字段或类型不匹配都会导致执行失败；
• memory参数必须始终包含，即使没有跨调用状态也传空对象{}——这是 Rube 执行器的入参约定，缺失该键会导致调用被拒绝；
• session_id沿用本工作流的会话 ID。

六、已知陷阱与规避（Known Pitfalls）

技能文档明确列出六条实战中最容易踩的坑，逐条解读如下：

• 永远先搜索：工具 schema 会变化。不调用RUBE_SEARCH_TOOLS就直接硬编码工具 slug 或参数，是最大的失败来源；
• 先查连接：执行工具前确认RUBE_MANAGE_CONNECTIONS显示 ACTIVE 状态，避免在断连状态下白跑一轮；
• 严格遵循 schema：字段名与类型必须与搜索结果完全一致，这是RUBE_MULTI_EXECUTE_TOOL参数校验的硬性要求；
• memory 参数不可缺：每次RUBE_MULTI_EXECUTE_TOOL调用都要带memory，哪怕内容为空{}；
• 会话复用：同一工作流内复用同一 session ID 保持上下文；新工作流必须生成新会话，避免串流；
• 分页处理：检查响应中的分页令牌（pagination token），令牌存在则持续拉取直到数据取完——批量操作（如导出全部合同或雇员列表）若忽略分页会得到不完整结果。

这六条本质上是"动态 schema、连接态校验、调用契约、会话生命周期、数据完整性"五个维度的工程约束，值得在编写任何 Composio 系技能时沿用。

七、速查表（Quick Reference）

下表是技能文档给出的操作速查，覆盖从查找到批量执行的完整工具面：

其中"批量操作"与"完整 schema"两条是对基础三步的进阶补充：当需要遍历多条 Deel 记录执行同类操作时，优先使用RUBE_REMOTE_WORKBENCH的run_composio_tool()在远端工作台批量执行，避免逐条往返调用；而当搜索结果仅返回schemaRef引用（而非内联完整 schema）时，需再调RUBE_GET_TOOL_SCHEMAS解析出完整字段定义。这与仓库内其他 78 个技能（如 composio-skills/composio-automation/SKILL.md）的速查表结构完全一致，属于该技能族共享的标准化接口面。

八、从技能到 Agent 运行时的整体视图

把 README.md 对三层架构的说明与本技能结合，可以看清 Deel 自动化在运行时各层各司其职：

• MCP 层（访问）：Rube MCP 提供认证、传输与工具发现，本技能通过requires: mcp: [rube]声明依赖；
• 工具层（动作）：RUBE_SEARCH_TOOLS/RUBE_MANAGE_CONNECTIONS/RUBE_MULTI_EXECUTE_TOOL等是 Agent 实际调用的函数；
• 技能层（行为）：本 SKILL.md 定义"先发现、再校验、后执行"的顺序与护栏，告诉 Agent 在拥有连接和工具之后做什么、按什么顺序、注意哪些坑。

生产环境中三层同时运行：Rube MCP 负责打通 Deel 授权通道，Composio 的 Deel 工具包提供真实操作能力，而 deel-automation 技能负责把整套行为约束成可复用、可测试、可维护的标准化流程。这也解释了为何技能的 frontmatter 中特意在 description 里写入 "Always search tools first for current schemas"——它既是给 Agent 的触发信号，也是给未来所有使用者的操作纪律。

总结

deel-automation 是一份"麻雀虽小、五脏俱全"的自动化技能文档：从零配置的 Rube MCP 接入、OAuth 激活校验、动态工具发现，到三步核心工作流与六条坑位规避，再到RUBE_REMOTE_WORKBENCH批量与RUBE_GET_TOOL_SCHEMAS深 schema 的进阶手段，构成了一条可独立落地、可横向复用到任意 Composio 支持应用（仓库内其余 77 个技能同构）的完整方法论。对希望让 Claude 真正"动手做事"而非只生成文本的开发者而言，这份技能是理解 Claude Skills × MCP × 工具三件套协作方式的最佳入口之一。

• AI 技能
• AI 插件
• 人工智能
• 工作流自动化