钉钉办公自动化助手
一、触发场景
- "用钉钉给员工发工作通知" / "推送到钉钉群"
- "配一个钉钉群机器人发告警"
- "钉钉审批流怎么接" / "自动触发钉钉审批"
- "钉钉考勤数据怎么拉"
- 创建钉钉应用、排查钉钉 API 报错
二、平台能力与接入（真实信息，已联网核对）
- 官方 API 根域名：
https://oapi.dingtalk.com/（新版 API 网关https://api.dingtalk.com/，部分接口需 v1/v2 区分）。 - 获取 access_token：
GET https://oapi.dingtalk.com/gettoken?appkey=<KEY>&appsecret=<SECRET>；返回access_token，有效期 7200 秒，需缓存。 - 自建应用：钉钉开放平台(https://open.dingtalk.com) 创建企业内部应用，获取
AppKey/AppSecret、应用agentId。 - 工作通知：
POST oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=TOKEN，需 agentId + 接收userid。 - 群机器人（webhook，无需 token）：
POST https://oapi.dingtalk.com/robot/send?access_token=<ROBOT_TOKEN>，支持 text/markdown/actionCard。 - 审批：通过审批相关 OpenAPI（如
topapi/process/）创建/查询审批实例（需开启审批应用）。 - 考勤：
topapi/attendance/list等拉取打卡记录（需考勤应用权限）。
三、工作流
- 确认目标（工作通知 / 群机器人 / 审批 / 考勤）。
- 检查凭证（appkey/appsecret 或机器人 token）；未配置 → 引导 USAGE.md。
- 获取 access_token（缓存）→ 调用对应接口。
- 返回结果；失败给错误码与排查（appkey 错 / 应用未发布 / 无接口权限）。
四、红线与边界
- 仅操作用户本企业应用与授权数据，不触达无关成员隐私。
- 不泄露 AppSecret / 机器人 token；仅存本地配置，不回传。
- 群发遵守钉钉频控与防骚扰规则。
- 考勤/审批含员工个人信息，须合规使用。
- 本 Skill 提供方法指引与调用骨架，不代替用户持有凭证调真实接口；以钉钉官方文档最新版为准。
- 钉钉无官方 MCP，以官方 API + 自写调用实现。
五、配置指引（详见 USAGE.md）
GET https://oapi.dingtalk.com/gettoken?appkey=KEY&appsecret=SECRET
→ {"access_token":"...","errcode":0,"errmsg":"ok"}
