前言¶
团队里一旦接钉钉,常见需求会堆在一起:告警要推到工作通知,审批要能在流程里自动发起,考勤和群机器人也要能按规则发消息。这些能力都在钉钉开放平台文档里,但字段多、接口分散,对话里临时查文档容易漏权限或配错应用。下面介绍 SkillHub 上的社区 Skill「钉钉办公自动化助手」,它把触发场景和实现路径收敛成一套 Agent 可执行的说明,帮你在对话里按官方 API 落地自动化,而不是从零翻开放平台。
这是什么¶
「钉钉办公自动化助手」是 SkillHub 坐标 @user_af163eaa/z-dingtalk-automation 下的 Agent Skill(当前版本 1.0.1,来源 community,分类 office-efficiency)。发布者为 user_af163eaa;SkillHub 页面展示作者为 大智JiYoo。
一句话定位:当对话涉及钉钉(DingTalk)办公集成时,引导你通过钉钉官方开放 API完成工作通知、审批、考勤与群机器人等自动化配置与调用。Skill 元数据带有 requires_api_key=true,意味着实际联调需要你在钉钉开放平台创建应用并妥善保管密钥,不能把凭证写进公开仓库。
核心功能¶
以下能力均来自 SkillHub 官方简介,对应开放平台侧常见集成面:
- 工作通知推送:面向组织内用户的消息下发场景。
- 审批流程触发:与钉钉审批能力相关的自动化接入。
- 考勤相关自动化:在对话中处理考勤类开放能力需求。
- 群机器人 / 群消息:群聊机器人与群消息类场景。
Skill 会在用户提到钉钉、DingTalk、钉钉工作通知、钉钉机器人、钉钉审批、钉钉考勤、钉钉群消息、配置钉钉应用或钉钉开放平台等表述时参与协作,避免 Agent 用非官方方式「模拟」钉钉能力。
安装与启用¶
方式一:让 Agent 按 SkillHub 指引安装¶
SkillHub 技能页给出的安装提示如下(将整段发给支持 Skill 的 AI 即可):
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_af163eaa/z-dingtalk-automation`。
该指引会引导 Agent 阅读 SkillHub 通用安装文档,并把你的环境 skills 目录配对正确。
方式二:使用 skillhub CLI¶
先确认本机是否已有 CLI(文档要求安装时用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别):
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 文档执行完整安装(含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时,将 <skills 目录> 换成你当前客户端使用的路径,例如:
skillhub install user_af163eaa/z-dingtalk-automation --dir <skills 目录>
各客户端常用 skills 目录(摘自 SkillHub 安装文档,按你实际环境择一):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
装好后按你所用 Agent 的惯例刷新或重启,使新 Skill 被加载。
典型用法¶
公开资料未附带独立代码仓库示例;用法以 Skill 自带的场景描述为准。经过上面的步骤启用后,你可以在对话里直接描述目标,并带上钉钉侧上下文,例如:
- 「要在钉钉里给指定用户发工作通知,应用已创建,帮我核对开放 API 调用与权限。」
- 「需要通过开放平台触发审批流程,说明要配置哪些应用能力与回调。」
- 「群机器人要自动回群消息,按官方机器人文档走。」
Agent 在命中 Skill 触发词后,应沿钉钉开放平台文档组织步骤(应用、权限、密钥、接口参数),而不是绕过官方 API。具体接口名、请求体以你企业租户下开放平台当前文档为准;本 Skill 的作用是约束路径与减少漏配。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的工具,且团队沟通与流程在钉钉上。
- 需要反复做「通知 / 审批 / 考勤 / 群机器人」类集成,希望对话里有一份稳定的操作清单。
使用注意
- 密钥与合规:标签
requires_api_key=true表示必须配置钉钉应用凭证;密钥仅放在环境变量或受控配置中,勿提交到版本库。 - 社区来源:
source: community,上线前请在测试企业或沙箱应用验证,再切生产租户。 - 版本与统计:SkillHub 抓取信息为版本 1.0.1,评分 100000,下载 5708(页面统计会变动,以 SkillHub 为准)。
- 安装源:技能坐标为
@user_af163eaa/z-dingtalk-automation;SkillHub 页:https://www.skillhub.cn/skills/user_af163eaa/z-dingtalk-automation ,API 入口:https://api.skillhub.cn/user_af163eaa/z-dingtalk-automation 。
结尾¶
如果你希望在 Agent 对话里系统化地处理钉钉工作通知、审批、考勤和群机器人,而不是每次零散查文档,可以先按 SkillHub 指引安装 @user_af163eaa/z-dingtalk-automation,再在具备开放平台应用的前提下描述具体自动化目标。官方技能页:https://www.skillhub.cn/skills/user_af163eaa/z-dingtalk-automation 。