dingtalk-openapi-skills

釘釘開放平台 API Skills — 讓 AI Coding Agent 直接呼叫釘釘和宜搭的服務端 API。

涵蓋範圍

dingtalk-skills — 釘釘服務端 API

子技能	用途
dingtalk-contact	通訊錄 — 用戶、部門、角色、外部聯繫人
dingtalk-message	消息推送 — 工作通知、機器人、群消息、互動卡片
dingtalk-approval	OA 審批 — 模板、實例、任務執行
dingtalk-attendance	考勤 — 打卡記錄、排班、班次、假勤
dingtalk-calendar	日程 — 日曆、會議室、忙閒查詢
dingtalk-document	文檔 — 知識庫、釘盤、群文件
dingtalk-todo	待辦任務 — 個人/企業待辦
dingtalk-crm	客戶管理 — 客戶、聯繫人、跟進記錄
dingtalk-hr	智能人事 — 花名冊、職位、入轉調離
dingtalk-project	Teambition 專案管理 — 項目、任務、工時

yida-skills — 宜搭服務端 API

子技能	用途
yida-form-api	表單 CRUD、批量操作、高級查詢（含子表）
yida-process-api	流程發起/終止、審批任務、轉交

安裝

使用 npx skills

npx skills add https://github.com/anthropics/dingtalk-openapi-skills

手動安裝

# Claude Code
cp -r dingtalk-skills ~/.claude/skills/dingtalk-skills
cp -r yida-skills ~/.claude/skills/yida-skills

# 其他 AI Coding Agent
cp -r dingtalk-skills ~/.agents/skills/dingtalk-skills
cp -r yida-skills ~/.agents/skills/yida-skills

前置條件

1. 在釘釘開發者後台建立企業內部應用
2. 取得 Client ID（AppKey）和 Client Secret（AppSecret）
3. 申請所需的 API 權限
4. 設定環境變數：

export DINGTALK_CLIENT_ID="your-app-key"
export DINGTALK_CLIENT_SECRET="your-app-secret"

宜搭 API 額外需要：

export YIDA_APP_TYPE="APP_XXXX"
export YIDA_SYSTEM_TOKEN="your-system-token"

認證方式

所有 API 使用釘釘 OAuth2 access_token 認證：

POST https://api.dingtalk.com/v1.0/oauth2/accessToken
Body: { "appKey": "...", "appSecret": "..." }
→ { "accessToken": "...", "expireIn": 7200 }

新版 API（api.dingtalk.com）：Header x-acs-dingtalk-access-token: {token} 舊版 API（oapi.dingtalk.com）：Query ?access_token={token}

相容工具

• Claude Code
• OpenCode
• Codex
• 任何支援 ~/.agents/skills/ 的 AI Coding Agent

License

MIT