Files
EP-Hub-Skill/.agents/skills/dingtalk-misc/references/recruit.md
T
2026-09-02 11:44:52 +08:00

3.6 KiB
Raw Blame History

钉钉招聘

dws recruit 查询和创建钉钉招聘职位。当前公开命令只覆盖职位列表、职位详情和 职位创建;候选人、面试、Offer、职位修改、开放或关闭尚未作为稳定命令发布。

所有命令都应加 --format json。组织、业务标识和当前操作人由登录身份及 MCP Connector 注入,不要要求用户提供或猜测 corpIdbizCodeopUserId

查询职位列表

dws recruit job list --format json
dws recruit job list --keyword "Java" --status open --size 20 --format json
dws recruit job list --job-ids JOB_ID_1,JOB_ID_2 --format json

可选筛选包括 --job-ids--required-edu--status--job-nature--campus--start-modified-time--end-modified-time--creator-user-ids--keyword--category。状态接受:

  • draft:草稿
  • open:招聘中
  • invalid:已失效
  • closed:已关闭/完成

--size 默认 20,范围 1–100。首页不传 --cursor;响应 hasMore=true 时, 把 nextCursor 回填到下一次查询。

查询职位详情

先从列表结果取得真实 jobId,不得编造:

dws recruit job get --job-id JOB_ID --format json

创建职位

创建是非幂等远端写入。先准备只包含职位对象的 UTF-8 JSON 文件,并用 --dry-run 检查完整调用;向用户展示职位名称、性质、薪资、创建人和负责人(如有),取得 明确确认后,交由 CLI 的确认流程执行实际创建。不要在存储示例中加入确认绕过参数。

creatorUserId 是必填字段,必须使用同一 profile 下当前操作者的真实 userId,不得 猜测或复用其他组织的 userId。ownerUserIds 是可选的负责人 userId JSON 字符串数组; 提供负责人时同样必须使用真实通讯录结果。用户说“负责人是我”时先运行 dws contact user get-self --format json 取得当前 userId;用户指定其他负责人时按 通讯录 Skill 解析唯一 userId。未指定负责人时允许省略 ownerUserIds,不要默认选人。

dws recruit job create --from ./job.json --dry-run --format json
dws recruit job create --from ./job.json --format json

最小 job.json

{
  "name": "Java 开发工程师",
  "description": "负责服务端系统开发",
  "jobNature": "FULL-TIME",
  "requiredEdu": 6,
  "minSalary": 20000,
  "maxSalary": 35000,
  "extData": {
    "headCount": 1,
    "fullTimeExtData": {
      "salaryMonth": 12
    }
  },
  "creatorUserId": "CURRENT_USER_ID",
  "ownerUserIds": ["OWNER_USER_ID"]
}

必填字段为 namedescriptionjobNaturerequiredEduextDatacreatorUserIdownerUserIds 可选。 jobNature 当前固定为 FULL-TIMErequiredEdu 为 1–9 的整数(1小学、2初中、 3高中、4中专、5大专、6本科、7硕士、8博士、9其他)。minSalarymaxSalary 可选;两者同时提供时最低薪资不得高于最高薪资。

extData.headCount 范围 1999extData.fullTimeExtData.salaryMonth 范围 12–24;最高工作年限不得小于最低工作年限。提供 address 时必须同时包含 namedetaillongitudelatitude,经纬度只能来自地图选点或可信地址解析, 不得猜测。source 可省略,由 Connector 默认补充为 manual;不传 category 时 Connector 会设置 checkJobCategory=false

可选字段以当前 dws recruit job create --help 和 leaf Schema 为准。不要把 MCP 信封字段 atsAddJobParamcorpIdbizCodeopUserId 写进文件;CLI 与 Connector 会负责包装和身份注入。