SuperAPI AI 工具集

ashby

编程与开发

查看项目

更新于 10-15 20:32

技能介绍

用途:当任务涉及 Ashby 的候选人、申请、阶段或备注时使用该技能,通过官方 API 驱动的 ashby CLI 操作,而非浏览器自动化。

命名与调用:npm 包名为 ashby-cli,CLI 命令名为 ashby。若 ashby 已在 $PATH 中则直接使用;否则用 npx -y ashby-cli <args> 显式运行。不要猜测 @danielgwilson/ashby-cli 或 npx ashby 等名称。缺少命令时可用 npm install -g ashby-cli 安装。

主要能力:候选人搜索(按姓名或邮箱)、获取候选人、列出备注、更新联系方式与社交字段、按邮箱 upsert 候选人;创建候选人、添加备注(含幂等 note ensure)、创建申请、变更申请阶段;列出职位、阶段、申请、申请历史与反馈、面试安排、来源等。默认优先 --json 便于机器读取,先只读检查再变更,日志与聊天中谨慎处理候选人数据。

认证:Ashby 该 API 不提供 OAuth,推荐浏览器辅助的 API Key 设置。缺少认证时可运行 ashby auth setup;临时方式为 ASHBY_API_KEY=... ashby doctor --json;本地保存可用 printf '%s' "$ASHBY_API_KEY" | ashby auth set --stdin。使用 npx 时不会自动加载 .env.local,需先导出 ASHBY_API_KEY 或显式 source 环境文件。ashby auth setup 会打开 https://app.ashbyhq.com/admin/api/keys 并提示所需权限,随后保存并校验粘贴的密钥。避免把完整密钥粘贴到日志或聊天中。

常用流程:ashby doctor --json、ashby whoami --json、ashby candidate search ... --json、ashby job list --status Open,Draft --json、ashby stage list --job-id ... --json、ashby application list --job-id ... --json。变更前需确认候选人是否已存在、正确的 job id、以及该职位对应的面试计划与阶段 id。

限制:该 CLI 覆盖候选人/申请状态较好,但不能替代完整 Ashby UI;不假定支持通用对外候选人邮件、自助排期链接或 Ashby 自动化触发器;不要假定公开 FE 职位与秘密 fast-track 职位共享同一面试计划或阶段 id。稳定 JSON 行为见 docs/CONTRACT_V1.md。