企业官网建设流程全解析

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

本篇技术指南围绕 awesome-claude-skills 仓库中预置的 Ashby Automation 技能 展开，讲解如何通过 Rube MCP（Composio）把 Ashby ATS 招聘系统接入 Claude Code，用自然语言完成候选人管理、职位发布、申请流转、面试日程查看与人才管道报表等招聘操作。读完本文，你将掌握该技能的全部工具清单、核心参数、六类典型工作流以及踩坑避雷要点，能够直接在终端里指挥 Claude 自动化日常招聘事务。

技能定位：为招聘运营插上自然语言接口

Ashby 是一款面向现代招聘团队的人才招聘系统（ATS），涵盖候选人、职位、申请、面试与内部备注等核心对象。本仓库将其封装为独立的 Claude Skill，核心描述为："通过自然语言命令自动化 Ashby 中的招聘与雇佣工作流——管理候选人、职位、申请、面试和备注"（见 composio-skills/ashby-automation/SKILL.md 的元数据声明）。

从仓库 README.md 的说明可以确认，这类技能属于"App Automation via Composio"板块：仓库为 78 个 SaaS 应用预构建了工作流技能，每个技能都包含工具序列、参数指引、已知陷阱和快速参考表，且全部使用从 Composio API 发现的实际工具 slug（tool slug）。Ashby 技能正是其中之一，这意味着它并非手工臆造的"提示词模板"，而是与 Composio 工具运行时真实对应的可执行技能。

技能的前置依赖声明为mcp: [rube]，即所有 Ashby 操作都经由Rube MCP 服务器（https://rube.app/mcp）中转，由 Rube 负责连接认证、工具发现与执行调度。这种"技能 + MCP 网关"的架构，让 Claude 无需关心 Ashby REST API 的细节，只需按工具 slug 调用即可。

安装与认证：三步接入

依据 composio-skills/ashby-automation/SKILL.md 的 Setup 章节，接入只需三步：

1. 添加 Rube MCP 服务器：在 Claude Code 的配置中新增 MCP 服务器，URL 填https://rube.app/mcp。无需 API Key，添加端点即可工作（该细节在同仓库的 composio-skills/composio-automation/SKILL.md 中有明确说明）。
2. 认证 Ashby 账号：按提示通过返回的连接链接完成 OAuth 式授权，将你的 Ashby 工作区与 Rube 建立连接。
3. 开始用自然语言自动化招聘工作流：连接建立后，Claude 即可调用 Ashby 系列工具。

技能安装到 Claude Code

如果你想完整复用本仓库技能，可参照 README.md 的 Getting Started 章节，将技能目录复制到 Claude Code 的 skills 目录：

mkdir -p ~/.config/claude-code/skills/ cp -r composio-skills/ashby-automation ~/.config/claude-code/skills/

随后校验技能元数据（head ~/.config/claude-code/skills/ashby-automation/SKILL.md），再启动claude，技能会自动加载并在相关任务中激活。技能元数据中的name: Ashby Automation与requires.mcp: [rube]声明是 Claude 判断何时激活该技能的关键依据。

推荐的连接与执行检查模式

在真正执行 Ashby 工具前，建议先遵循同仓库 composio-automation 技能总结的通用模式：先用RUBE_SEARCH_TOOLS查询当前可用的工具 schema，再用RUBE_MANAGE_CONNECTIONS确认 Ashby 连接状态为 ACTIVE，最后通过RUBE_MULTI_EXECUTE_TOOL携带memory参数与session_id执行具体工具。工具 schema 会随版本变化，因此"先搜索、再执行"是避免硬编码失效 slug 的最佳实践。

核心工作流一：候选人管理

候选人管理是招聘流程的起点，涉及创建、列表、搜索、详情与更新五类操作。

工具：ASHBY_CREATE_CANDIDATE、ASHBY_LIST_CANDIDATES、ASHBY_SEARCH_CANDIDATES、ASHBY_GET_CANDIDATE_INFO、ASHBY_UPDATE_CANDIDATE

自然语言示例：

Create a candidate named "Jane Smith" with email jane@example.com and LinkedIn profile https://linkedin.com/in/janesmith

关键参数说明

ASHBY_CREATE_CANDIDATE参数：

ASHBY_SEARCH_CANDIDATES参数：

ASHBY_LIST_CANDIDATES参数：

需要注意的是，ASHBY_SEARCH_CANDIDATES只支持精确邮箱或部分姓名两类单一条件，不支持组合查询或其他字段；需要更宽泛的筛选时，应改用ASHBY_LIST_CANDIDATES配合分页遍历。

核心工作流二：创建与查看职位

发布新职位、浏览现有岗位是招聘团队的高频操作。

工具：ASHBY_CREATE_JOB、ASHBY_LIST_JOBS、ASHBY_GET_JOB_INFO

自然语言示例：

Create a new "Senior Software Engineer" job in team dept-123 at location loc-456 with brand brand-789

关键参数说明

ASHBY_CREATE_JOB参数：

ASHBY_LIST_JOBS参数：perPage（上限 100）、cursor、syncToken，用于分页与增量同步。

关键注意点

新建职位默认处于 "Draft"（草稿）状态。只有设置了defaultInterviewPlanId并将职位开放后，申请人才能够提交申请。这是自动化发职位时最容易遗漏的一步。由于teamId、locationId、brandId都是内部 ID，应先用部门、地点、品牌的列表接口发现合法 ID 再传入。

核心工作流三：管理申请

申请（Application）把候选人与职位连接起来，并承载其在招聘管道中的流转状态。

工具：ASHBY_CREATE_APPLICATION、ASHBY_LIST_APPLICATIONS

自然语言示例：

Apply candidate cand-abc123 to job job-xyz789 with source src-referral

关键参数说明

ASHBY_CREATE_APPLICATION参数：

ASHBY_LIST_APPLICATIONS参数：perPage（上限 100）、cursor、syncToken，用于分页与增量同步。

关键注意点

必须先有候选人，才能创建申请。创建申请前请先创建或找到候选人，否则会失败。另外，所有 ID（候选人、职位、申请、阶段）均为 UUID 格式，传入格式非法的 ID 会返回 400 错误。

核心工作流四：查看面试日程

工具：ASHBY_LIST_INTERVIEW_SCHEDULES

自然语言示例：

Show me all upcoming interview schedules

该工具可列出已排定的面试，包含时间安排、面试官与候选人详情。

参数说明：perPage（上限 100）/cursor用于分页；syncToken用于增量获取发生变更的日程，适合需要持续跟踪面试变动的场景。

核心工作流五：候选人内部备注

工具：ASHBY_LIST_CANDIDATE_NOTES

自然语言示例：

Show me all notes for candidate cand-abc123

该工具可获取招聘专员与面试团队为候选人添加的全部内部备注、观察记录与评价。它特别适合在回顾面试反馈与内部评估时使用——不必逐个打开候选人档案，一条命令即可汇总全部备注。

核心工作流六：招聘管道报表

将多个列表工具组合起来，即可构建招聘管道报表。

工具组合：ASHBY_LIST_CANDIDATES+ASHBY_LIST_APPLICATIONS+ASHBY_LIST_JOBS

自然语言示例：

List all applications to see the current state of our hiring pipeline

实操要点：

• 增量同步：使用syncToken进行增量数据拉取，对周期性报表尤为高效，可大幅减少 API 调用量；
• 全量视角：将候选人、申请、职位三类数据组合，获得完整的管道可见性；
• 完整数据集：使用cursor翻页遍历全部结果，避免遗漏。

已知陷阱与最佳实践

原文档将自动化 Ashby 时的常见坑总结得相当精炼，这里逐条展开并结合执行模式给出规避建议：

• 职位默认是草稿：ASHBY_CREATE_JOB新建的职位处于 "Draft" 状态，未设置defaultInterviewPlanId并开放前无法接收申请。发布职位后请立即校验状态。
• 职位创建有四个必填字段：title、teamId、locationId、brandId缺一不可；合法 ID 需通过部门、地点、品牌的列表接口发现，切勿臆造。
• 先候选人后申请：申请必须挂接已存在的候选人，正确顺序是先创建/查找候选人，再创建申请。
• 游标分页无法跳页：所有列表接口均采用基于cursor的游标分页，perPage上限 100；不能跳转到任意页，必须顺序迭代。
• 善用syncToken：将上一次响应的syncToken带回，只拉取变更记录，可显著降低重复工作流的 API 调用成本。
• 处处皆 UUID：候选人、职位、申请、阶段等 ID 均为 UUID，格式错误会直接得到 400 错误。建议在提示词中显式携带完整 UUID 字符串。
• 搜索能力有限：ASHBY_SEARCH_CANDIDATES只支持精确邮箱或部分姓名匹配，不能组合条件；需要更广范围时改用ASHBY_LIST_CANDIDATES分页遍历。

此外，结合同仓库 composio-skills/composio-automation/SKILL.md 的通用实践，还应做到：执行前先搜索工具 schema 而非硬编码；执行前确认连接为 ACTIVE；严格按 schema 的字段名与类型传参；RUBE_MULTI_EXECUTE_TOOL调用始终携带memory参数（可为空{}）；同一工作流内复用session_id，新工作流生成新 ID；留意响应中的分页令牌并持续拉取至完整。

工具快速参考

下表汇总全部 12 个 Ashby 工具 slug 及其用途，可直接作为与 Claude 对话时的能力索引：

小结

Ashby Automation 技能把一套完整的 ATS 操作面压缩成了 12 个可被自然语言触发的工具。在实际使用中，推荐的工作节奏是：先确认 Rube MCP 已连接、Ashby 连接状态为 ACTIVE，再用自然语言提出招聘任务，遇到参数不明确时主动让 Claude 通过列表类工具反查合法 ID，最后用syncToken+cursor保障数据的新鲜度与完整性。这套方法论同样适用于本仓库 composio-skills 目录下其他 SaaS 自动化技能，例如 composio-automation 中描述的"搜索工具 → 检查连接 → 执行工具"三段式模式，可作为所有 Rube MCP 技能的统一执行底座。

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