钉钉通讯录 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。22 个 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 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用 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 --depts <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