核心用法
ding-skills 是一套面向钉钉生态的企业级自动化技能集，覆盖组织架构查询、消息通讯、OA审批、视频会议、日程管理五大核心场景。开发者通过配置 DINGTALK_APP_KEY 和 DINGTALK_APP_SECRET 即可调用39个独立脚本，实现从"搜人名开会议"到"批量查离职"的全链路自动化。
典型工作流：用户输入自然语言（如"帮我和张三、李四开个会"）→ 系统先执行 search_user.py 解析人名获取 userId → 通过 get_user.py 转换 unionId → 最后调用 create_schedule_conference.py 完成会议创建。这种"人名→ID→操作"的三层转换是技能集的核心设计模式。
显著优点
- 场景覆盖完整：39个脚本覆盖钉钉90%以上的常用API，从基础的用户搜索到复杂的审批流操作均有实现
- 多ID体系兼容：妥善处理钉钉的 userId/unionId 双标识体系，内部自动转换降低使用门槛
- 错误处理统一：所有脚本返回标准化JSON格式，含
success布尔字段和结构化error对象，便于程序化处理 - 工作流文档详尽：README中明确标注4种高频场景的标准操作序列，大幅降低集成成本
潜在缺点与局限性
- 权限依赖严格：需预先在钉钉开放平台申请对应API权限（如通讯录管理、审批管理、日历等），权限不足时调用失败
- 环境变量敏感：
APP_SECRET以明文环境变量形式存储，存在泄露风险；无动态令牌刷新机制 - 无沙箱隔离：脚本直接操作真实企业数据，测试误操作可能影响生产环境
- 速率限制未披露：文档未提及钉钉API的QPS限制，高并发场景可能触发限流
- 人名匹配歧义：
search_user.py返回多结果时无交互选择机制，可能误匹配同名用户
适合人群
- 企业IT管理员：批量处理员工信息、导出部门架构、监控离职动态
- 行政/HR自动化：自动发送入职通知、批量预约面试会议、查询待审批积压
- 开发者集成：作为钉钉能力的中间层封装，供上层应用（如ChatBot、RPA）调用
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | 手机号、部门架构等敏感信息通过脚本输出，日志需脱敏处理 |
| 越权操作 | 拥有审批执行权限的token可同意/拒绝任意单据，需最小权限原则 |
| 会议骚扰 | 批量创建会议可能触发钉钉反垃圾机制，导致账号受限 |
| 凭证失效 | 钉钉应用停用或secret重置会导致全量服务中断 |