lark-hire

name	lark-hire
version	1.0.0
description	飞书招聘（Feishu/Lark Hire）：管理职位、人才、投递、Offer、面试、入职等招聘全流程。查询职位与职位详情、管理人才库与人才信息、跟踪投递进度与招聘阶段、查看面试安排与评价、管理 Offer、处理入职、下载简历附件、对接猎头/内推/官网/背调/笔试。当用户需要查职位/候选人、看投递管线、查面试或 Offer、下载简历、统计招聘数据，或对接招聘生态时使用。
metadata	{"requires":{"bins":["lark-hire"]},"cliHelp":"lark-hire --help"}

飞书招聘 (Hire)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-hire-shared/SKILL.md，其中包含认证、身份、权限、安全确认等通用规则。

lark-hire 覆盖飞书招聘 v1/v2 全部接口（77 个资源分组、180 个接口），分三层使用：

• 资源层：lark-hire <resource> <command> [flags] —— 全量接口，参数名与官方文档一致（snake_case）
• 快捷层：lark-hire jobs / talents / job-get <id> ... —— 常用操作的友好命令
• 原始层：lark-hire api <METHOD> <path> —— 任意接口直调

核心概念

• Job 职位 (job, id 如 7647...): 招聘的岗位。job list 列表、job get --job_id 详情、job get-detail 富信息。
• Talent 人才 (talent, talent_id): 候选人。人才库的核心实体。v2 有增强版 talent get-v2。
• Application 投递 (application, application_id): 某人才对某职位的一次投递，串联整个流程。可按 job_id / talent_id / stage_id 过滤。
• Stage 阶段 / Process 流程 (job_process): 投递所处的招聘阶段（初筛/面试/Offer…）。
• Interview 面试 (interview, interview_record): 面试安排与评价。
• Offer (offer, offer_id): 录用意向，有状态流转。
• Onboarding 入职 (employee): 候选人入职后的员工信息。
• Attachment 附件 (attachment): 简历等文件，可取 PDF 下载链接。
• Note 备注 (note): 候选人/投递上的备注。
• 生态对接: 猎头 (agency)、内推 (referral/referral_account)、官网 (website)、背调 (eco_background_check)、笔试 (eco_exam)。

资源关系

Job 职位 (job_id)
└── Application 投递 (application_id)   ← 由 talent + job 组成
    ├── Talent 人才 (talent_id)
    │   ├── Attachment 简历附件
    │   └── Note 备注
    ├── Stage 阶段 (job_process)
    ├── Interview 面试 (interview_record) + 评价
    ├── Offer (offer_id) → 状态流转
    └── Onboarding 入职 (employee)

常用只读工作流

# 1) 浏览职位（自动翻页 + 表格）
lark-hire jobs --format table -q '.data.items[] | {id, title, city: .city.zh_name, dept: .department.zh_name}'

# 2) 查某职位详情
lark-hire job get --job_id <job_id>

# 3) 某职位下的全部投递
lark-hire application list --job_id <job_id> --page-all -q '.data.items[] | {id, talent_id, stage: .stage.name}'

# 4) 查人才信息（v1 / v2）
lark-hire talent-get <talent_id>
lark-hire talent get-v2 --talent_id <talent_id>

# 5) 某人才的投递与 Offer
lark-hire application list --talent_id <talent_id> -q '.data.items[].id'
lark-hire offer list --talent_id <talent_id>     # offer list 必须带 talent_id

# 6) 面试信息与评价
lark-hire interview list --application_id <application_id>

# 7) 下载简历附件 PDF
lark-hire attachment get --attachment_id <id>                       # 取信息/下载链接
lark-hire api GET /open-apis/hire/v1/attachments/:attachment_id/preview --query attachment_id=<id>

参数与分页要点

• 路径参数 :xxx → 同名标志 --xxx（必填）。如 job get --job_id ...。
• 查询参数直接作为标志，名称同官方文档。用 --help 或 schema 查看。
• 不同接口 page_size 上限不同（如职位上限 20，投递上限 100）。--page-all 自动按返回的 page_token 翻页。
• 列表响应取 .data.items[]；详情响应通常是 .data.<resource>（如 .data.job、.data.talent、.data.application）。

写操作（创建/更新/删除）

写操作默认需确认；Agent/脚本中必须显式 --yes。务必先 --dry-run 预览，并向用户确认意图。

# 预览（不实际调用）
lark-hire talent combined-create --data @talent.json --dry-run

# body 用 --data，支持 @文件 与 - (stdin)
lark-hire talent combined-create --data @talent.json --yes

# 删除是高风险，先确认
lark-hire schema job-requirement.delete   # 查看 risk=high-risk-write
lark-hire job-requirement delete --job_requirement_id <id> --yes

实时事件订阅

通过 WebSocket 长连接接收招聘事件（无需公网回调）。需开发者后台开启「长连接」事件订阅模式并订阅相应事件。

lark-hire event list                 # 12 类可订阅事件（投递阶段/Offer 状态/人才进展/内推/背调/笔试…）
lark-hire event subscribe            # 接收全部事件，每行一条 JSON：{type, received_at, event}
lark-hire event subscribe --type hire.offer.status_changed_v1

这是长驻命令（Ctrl-C 退出）。Agent 若要消费事件，建议后台运行并逐行读取 JSON。

自省

lark-hire list                       # 全部分组
lark-hire talent --help              # talent 资源全部命令
lark-hire schema application         # application 全部接口元数据(JSON)
lark-hire schema offer.list          # 单接口：参数/风险/文档链接

参考文档（references/）

按资源/场景的详细命令与工作流：

• jobs.md — 职位管理
• talents.md — 人才库
• applications-interviews.md — 投递与面试
• offers-onboarding.md — Offer 与入职
• ecosystem.md — 附件/猎头/内推/官网/背调/笔试
• events.md — 实时事件订阅
• recruitment-pipeline.md — 招聘管线（端到端只读）