# Dingtalk Contact

钉钉通讯录精确查询。Use when 已有 userId 后查详情、部门、职位或邮箱，按完整手机号反查用户，或查询自己、部门成员及角色。姓名模糊搜索、工号、职责、上下级走...

- Repository: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli (3872 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-29
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-contact -g -a claude-code -y`
Codex: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-contact -g -a codex -y`
Cursor: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-contact -g -a cursor -y`
Gemini CLI: `npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dingtalk-contact -g -a gemini-cli -y`

## Description

钉钉通讯录精确查询。Use when 已有 userId 后查详情、部门、职位或邮箱，按完整手机号反查用户，或查询自己、部门成员及角色。姓名模糊搜索、工号、职责、上下级走 dingtalk-aisearch，拿到 userId 后用本 skill 补详情。命令前缀：dws contact。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 钉钉通讯录 Skill

## 前置条件, 执行操作前必读

> **CRITICAL, 执行任何 `dws` 操作前，MUST 先用 Read 工具完整读取 [`dingtalk-shared`](../dingtalk-shared/SKILL.md)。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。

> 命令参考：[contact.md](references/contact.md)；剧本：[08-directory.md](references/08-directory.md)。

<!-- VISIBLE_SHORTCUTS_START -->
## Shortcuts（无专用脚本/recipe 时优先）

以下 shortcut 同时进入公开 catalog 与 Runtime Schema。按本 skill/recipe 路由，命中时 Shortcut 优先于原子命令。参数只查 `dws schema --cli-path "contact +<shortcut>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json`；仅需且已发布 `result` 时查 `--jq '{cli_path,outcomes:.result.outcomes,pagination}'`，字段级再查 `data_schema`；缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help；`unknown flag` 用同 leaf Help 修正一次。`unknown command` 禁 Help：错误 suggestion → 已加载 Skill/reference 明确入口；均无则报漂移。禁全 Catalog/root/parent/product Help；仅映射、接口或 provenance 审计省略 `--compact`。现有路由和 reference 均无法定位低频能力时，才用 `dws shortcut list --service contact --format json` 发现。

The rest: https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/blob/HEAD/skills/multi/dingtalk-contact/SKILL.md