釘釘辦公自動化助手:在 Agent 裏對接釘釘開放 API

前言

團隊裏一旦接釘釘,常見需求會堆在一起:告警要推到工作通知,審批要能在流程裏自動發起,考勤和羣機器人也要能按規則發消息。這些能力都在釘釘開放平臺文檔裏,但字段多、接口分散,對話裏臨時查文檔容易漏權限或配錯應用。下面介紹 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 官方簡介,對應開放平臺側常見集成面:

  1. 工作通知推送:面向組織內用戶的消息下發場景。
  2. 審批流程觸發:與釘釘審批能力相關的自動化接入。
  3. 考勤相關自動化:在對話中處理考勤類開放能力需求。
  4. 羣機器人 / 羣消息:羣聊機器人與羣消息類場景。

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 的工具,且團隊溝通與流程在釘釘上。
  • 需要反覆做「通知 / 審批 / 考勤 / 羣機器人」類集成,希望對話裏有一份穩定的操作清單。

使用注意

  1. 密鑰與合規:標籤 requires_api_key=true 表示必須配置釘釘應用憑證;密鑰僅放在環境變量或受控配置中,勿提交到版本庫。
  2. 社區來源:source: community,上線前請在測試企業或沙箱應用驗證,再切生產租戶。
  3. 版本與統計:SkillHub 抓取信息爲版本 1.0.1,評分 100000,下載 5708(頁面統計會變動,以 SkillHub 爲準)。
  4. 安裝源:技能座標爲 @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 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜