| name | dingtalk-aisearch |
| description | AI搜问：人员语义搜索与跨源定位。Use when 按姓名/工号/部门/职责/上下级或手机号线索找人，跨文档/消息/邮件/听记检索，或回溯“我发过/收到过”。完整手机号反查走 dingtalk-contact；找到 userId 后由 contact 补详情。命令前缀：dws aisearch。 |
| metadata | {"cli_version":">=0.2.14","category":"product","requires":{"bins":["dws"]}} |
钉钉 AI 搜问 Skill
前置条件 — 执行操作前必读
**CRITICAL — 执行任何 dws 操作前，MUST 先用 Read 工具完整读取 dws-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。
命令参考：aisearch.md。
意图表
| 用户说 | 命令 |
|---|
| "找张三 / 张三是谁" | dws aisearch person --keyword "张三" --dimension name |
| "谁负责 XX / XX 负责人是谁" | dws aisearch person --keyword "<XX>" --dimension duty |
| "张三的上级 / 下级" | dws aisearch person --keyword "张三" --dimension supervisor（或 subordinate） |
| "X 部门有哪些人" | dws aisearch person --keyword "<部门>" --dimension department |
| "工号 12345 是谁" | dws aisearch person --keyword "<工号>" --dimension jobNumber |
| "按手机号线索语义搜人" | dws aisearch person --keyword "<手机号线索>" --dimension phone |
| "完整手机号精确反查" | dws contact user search-mobile --mobile "<完整手机号>" |
| "最近 OKR 相关邮件 / 项目相关文档" | dws aisearch enterprise --queries "<主题>" --types mail/document --time-range "<时间>" |
| "我发过/创建过/分享过/收到过什么" | dws aisearch behavior --queries "<主题>" --behavior-type <动作> --direction <方向> |
标准 SOP（必遵流程）
命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 flag/ID。每条命令必须带 --format json，执行后必须按"解析"步取真实字段，不得凭返回结构猜测。
SOP-1 搜人 → 拿 userId（search-person）
触发：姓名模糊找人/谁负责/查上下级/部门成员/工号反查/手机号线索语义搜人。
- 定维度（必须）：姓名→
name、"谁负责 XX"→duty、部门成员→department、上级/下级→supervisor/subordinate、工号→jobNumber、手机号语义线索→phone；完整手机号精确反查切到 dingtalk-contact 的 user search-mobile；不确定→all。--keyword 必须按用户原文完整保真，切勿截断、改昵称、扩同音字。
- 执行（必须）：
dws aisearch person --keyword "<完整值>" --dimension <维度> --format json。
- 解析（必须）：从 JSON 取
userId / openDingTalkId；多候选必须输出让用户选，禁止默认取第一个、禁止编造未返回的人员字段。
- 衔接（必须）：要邮箱/部门/职位/主管等详情 → 切
dingtalk-contact 执行 dws contact user get --ids <userId> --format json；发消息 → dingtalk-chat；发 DING → dingtalk-misc（references/ding.md）。
- 失败（必须）：未命中最多换 1 个维度重试一次（如
name→department/jobNumber/phone），仍保留完整目标值；仍无果必须如实告知。
禁止：用半截姓名扩大搜索、跳过 --format json、取首个候选、凭空补全人员信息。
SOP-2 跨源搜内容（search-content）
触发：跨文档/邮件/消息按主题找内容。
- 执行（必须）：
dws aisearch enterprise --queries "<主题>" --types <document,mail,...> --time-range "<时间>" --format json；多主题逗号分隔。
- 衔接（必须）：按命中来源切到对应产品 skill 读写。aisearch 只负责"找到"，不做读写。
禁止：把 aisearch 当作读写入口、跳过下游 skill 直接改数据。
SOP-3 行为回溯（search-behavior）
触发："我发过/收到过/创建过/分享过什么"。
- 执行（必须）：
dws aisearch behavior --queries "<主题>" --behavior-type <动作> --direction <方向> --format json。
- 衔接（必须）：按记录类型切对应 skill 操作；aisearch 不做读写。
禁止：编造行为结果、跳过 --format json。
高频硬约束
- 搜索目标必须完整保真：姓名、工号、手机号、部门名按用户原文完整传入
--keyword，严禁自行截断、拆字、改昵称或扩展同音字。
- 首次未命中时最多换维度重试一次（如 name → department/jobNumber/phone），仍必须保留完整目标值；不要用半截姓名扩大搜索。
- 找到候选后，如用户要邮箱、部门、职位、主管等详情，必须切到
dingtalk-contact 执行 contact user get --ids <userId> --format json 补全。
- 多候选且无法唯一判断时输出候选并询问；不要默认取第一个，也不要编造未返回的人员信息。
- 所有
dws aisearch 命令加 --format json。
跨产品协作
- 拿到 userId 后查详情 / 部门 → 切到
dingtalk-contact
- 拿到 userId 发消息 → 切到
dingtalk-chat
- 拿到 userId 发 DING → 切到
dingtalk-misc（references/ding.md）
局部意图与短流程
