dingtalk-contact - SKILL.md Agent Skill

name: dingtalk-contact description: 钉钉通讯录精确查询（按 userId 查详情、部门搜索、部门成员列表、查自己信息、离职员工查询、花名册档案）。Use when 用户说查部门/部门成员/我的信息/按工号查/按 userId 查/orgAuthEmail/离职员工/离职名单/花名册。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。 cli_version: ">=0.2.14" metadata: category: product stability: experimental requires: bins: - dws

钉钉通讯录 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。20 个 dingtalk-* skill 全部通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。

PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.

⚠️ 命令可用性可能因企业服务发现配置而异。本文档列出的命令基于 dws envelope schema 与本仓库 v1.0.30 实测，但部分命令的 cobra 子命令暴露与否还取决于你的企业 MCP gateway 是否注册了对应 tool。如果跑某条命令报 unknown command 或 fall back 到父级 help，说明当前账号企业未开通该能力。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。

命令参考：contact.md；剧本：08-directory.md。

意图表

用户说	命令
"查我自己的信息"	`dws contact user get-self`
"按 userId 查详情"	`dws contact user get --ids <userId1>,<userId2>,...`（多个并行）
"按部门名拉成员"	`python scripts/contact_dept_members.py --query "<部门名>"`
"搜部门"	`dws contact dept search --query "<关键词>"`
"部门成员列表"	`dws contact dept list-members --ids <deptId>`
"离职员工/离职名单/已离职"	`dws contact user dismission search`（可加 `--name` / `--start` + `--end` / `--depts`）
"花名册/员工档案/学历/银行卡/合同"	`dws contact user profile get --staff-id <STAFF_ID>`（先 `profile fields` 查字段）

评测高频硬约束

通讯录问题必须调用 dws contact 或 dws aisearch 获取实时结果；严禁只读 USER.md、环境身份或静态上下文后直接回答。
查自己用 dws contact user get-self --format json，不要把 me/self/current 当作 userId 传给 user get。
精确找人、按工号、按手机号：先用 dws aisearch person --keyword "<完整输入>" --dimension name/jobNumber/phone --format json 或对应 contact user search/search-mobile；拿到 userId 后必须 dws contact user get --ids <userId> --format json 补部门/职位/邮箱。
查询直属主管/上下级时，如果 contact user get 没返回明确主管字段，必须继续 dws aisearch person --keyword "<完整姓名或工号>" --dimension supervisor --format json，不要停在"可能需要进一步查询"。
多个同名候选时，批量 contact user get --ids id1,id2,... --format json 获取部门/职位后再消歧；不要默认取第一个。

跨产品协作

模糊找人（姓名 / 上下级 / 谁负责 / 工号 / 手机号）→ 切到 dingtalk-aisearch
拿到 email 发邮件 → 切到 dingtalk-mail
拿到 userId 发消息 → 切到 dingtalk-chat