dingtalk-contact
Installation
SKILL.md
钉钉通讯录技能
负责钉钉通讯录的所有查询操作。本文件为策略指南,仅包含决策逻辑和工作流程。完整 API 请求格式见文末「references/api.md 查阅索引」。
dt_helper.sh位于本SKILL.md同级目录的scripts/dt_helper.sh。
工作流程(每次执行前)
- 先识别本次任务类型 → 例如:搜索用户、查用户详情、搜索部门、列部门成员、查部门路径、统计员工数
- 按本次任务校验所需配置 → 通过
bash scripts/dt_helper.sh --get KEY读取;仅校验本任务必须项 - 仅收集缺失配置 → 若缺少某项,一次性询问用户所有缺失值,用
bash scripts/dt_helper.sh --set KEY=VALUE写入 - 获取 Token → 直接调用
bash scripts/dt_helper.sh - 执行操作 → 复杂的创建临时文件再执行,简单的直接执行;禁止 heredoc
按任务校验配置(必须先做)
- 所有任务通用必需:
DINGTALK_APP_KEY、DINGTALK_APP_SECRET - 需要“以当前操作者为起点”或“直接读取本人身份信息”的任务:必须有
DINGTALK_MY_USER_ID
规则:未通过“本次任务配置校验”前,不得进入 API 调用步骤。
凭证禁止在输出中完整打印,确认时仅显示前 4 位 +
****