核心用法
本 Skill 提供钉钉开放平台 30+ 个 API 的封装调用，分为四大功能模块：
组织架构管理：支持用户搜索（姓名/手机号/unionid）、用户详情查询、部门树遍历（父部门/子部门/部门用户列表）、员工人数统计、未登录用户查询、离职记录查询。根部门 deptId 固定为 1，支持自动分页获取全量数据。
消息推送能力：通过机器人实现单聊消息发送（需 userId + robotCode）和群聊消息发送（需 openConversationId），支持查询群内机器人列表获取可用 robotCode。
OA 审批全生命周期：覆盖审批实例查询（ID列表/详情）、用户视角审批管理（发起/抄送/待办/已办/数量统计）、审批操作（发起/终止/同意/拒绝/转交/评论）。支持表单数据 JSON 构造和时间戳范围查询。
技术实现：基于 TypeScript 命令行脚本，统一错误处理格式（success + error 对象），支持 --debug 参数输出详细日志。
显著优点
- 功能全面：覆盖钉钉最核心的通讯录、消息、审批三大 API 体系，单 Skill 解决企业自动化多数场景
- 企业级设计：支持离职人员、未登录用户等管理场景，符合 HR/IT 部门实际需求
- 统一封装：标准化的 JSON 输入输出，降低钉钉 API 的学习成本
- 审批自动化完整：少有的支持审批"发起-流转-终止-评论"全流程的开源封装
潜在缺点与局限性
- 认证门槛：必须预先创建钉钉应用并获取 App Key/Secret，个人开发者难以体验
- 权限依赖：部分接口（如手机号查用户、离职记录）仅限企业内部应用，第三方应用无法调用
- 无实时能力：纯轮询式 API 调用，不支持钉钉回调推送（如审批状态变更 webhook）
- 机器人限制：消息发送依赖预先配置的机器人，不支持主动创建群或邀请成员
- 时间限制：未登录用户查询只能查 1 个月内数据，且需次日 9 点后才能获取前一天数据
适合人群
- 企业 IT 管理员：自动化员工信息同步、离职审计
- HR 系统开发者：集成钉钉审批流，实现请假/报销等流程自动化
- 运维/行政人员：批量发送通知消息、统计组织架构数据
- 低代码平台集成者：通过命令行封装快速对接钉钉能力
常规风险
数据隐私合规：直接处理员工手机号、邮箱、部门架构等敏感信息，需确保符合《个人信息保护法》和企业内部数据规范。
权限越界风险：审批操作（同意/拒绝/终止）具有业务法律效力，自动化脚本需配合严格的审批策略和日志审计。
Token 安全管理：App Secret 泄露将导致全量 API 权限被盗用，环境变量方式在生产环境需配合密钥管理系统（KMS）。
频率限制风险：钉钉 API 存在调用频次限制（如获取 access_token 每日 2000 次），大规模分页查询需实现指数退避重试。