核心功能概述
ding-skills 是一套面向企业级钉钉环境的综合自动化技能集，提供39项独立脚本能力，涵盖六大业务域：
| 模块 | 能力数量 | 核心功能 |
|:---|:---|:---|
| 用户管理 | 8项 | 多维度用户搜索（姓名/手机/unionid）、员工统计、离职查询、活跃度监控 |
| 组织架构 | 8项 | 部门搜索与层级管理、部门用户批量查询、父部门链追溯 |
| 消息通讯 | 3项 | 机器人单聊/群聊消息推送、群内机器人管理 |
| OA审批 | 12项 | 审批实例全生命周期管理（发起/查询/同意/拒绝/转交/撤销/评论） |
| 视频会议 | 4项 | 即时会议创建关闭、预约会议管理（关联钉钉日历） |
| 日程管理 | 4项 | 日程CRUD、参与者动态增减 |
显著优势
1. API完备性：覆盖钉钉官方OpenAPI中高频使用的审批、通讯录、日历、会议四大核心模块，满足企业自动化办公的完整需求链路
2. 统一接口设计：所有脚本遵循一致的JSON输入输出规范，错误码体系标准化（MISSING_CREDENTIALS/INVALID_ARGS/UNKNOWN_ERROR），便于集成到自动化工作流
3. 标识符智能处理：自动区分userId（企业内部ID）与unionId（全局唯一ID），并在会议/日程场景提供清晰的unionid使用指引
4. 批量操作友好：部门用户查询、审批列表获取等均支持分页/游标机制，适配中大型企业万级用户场景
局限性与风险
- 授权门槛高：需企业钉钉管理员创建应用并授予通讯录、审批、日历等多类敏感权限，普通员工无法独立使用
- 环境依赖重：强依赖
DINGTALK_APP_KEY/DINGTALK_APP_SECRET环境变量，且未说明Token自动刷新机制 - 安全合规风险：批量查询离职人员、未登录用户等功能涉及敏感人事数据，需确保调用方具备合法数据访问权限
- 功能边界模糊：未明确标注哪些操作会触发钉钉消息通知（如添加日程参与者），可能导致非预期信息推送
适用场景
- 企业IT部门搭建内部自动化运维机器人
- HR系统集成钉钉组织架构同步与审批数据拉取
- 行政助手实现会议自动预定与通知推送
- 安全审计场景下的员工活跃度与离职追踪
建议安全等级
A级 - 企业级授权机制完善，但涉及敏感人事与审批数据，需严格权限管控与审计日志。