dingtalk-contact

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 或 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