↑

钉钉 CLI 套件v1.0.0

dingtalk-unified110 KB

通过官方 dws 命令行工具调用钉钉 14 个产品能力,覆盖消息、日历、待办、审批、考勤、日志、文档、AI 表格、钉盘、邮箱等场景。用户提及钉钉相关操作时自动触发,提供意图路由、权限探针、设备流授权及错误恢复策略。

0 0 0 0 更新于 2026-10-28 14:13

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 面向需要通过命令行统一操控钉钉办公场景的用户与开发者。它封装了官方 dws(DingTalk Workspace CLI)的完整产品域,支持消息群聊、日程日历、待办任务、OA 审批、考勤打卡、工作汇报、钉钉文档、AI 多维表格、钉盘文件、AI 听记、邮箱等 14 项能力的调用与编排。核心交付物包括:自动化的意图路由(区分普通表格与 AI 多维表、群聊与机器人等易混淆场景)、三层权限模型的自闭环授权(浏览器登录、设备流授权码、host-owned PAT 按需申请)、写操作前的 --dry-run 预览与危险操作确认、以及基于 dws schema 的动态命令发现与错误恢复。执行时以 CLI 实时 help/schema 为准,不依赖静态命令表,确保与官方版本同步演进。

技能包含

  • SKILL.md(本文件):技能主说明,含触发条件、执行策略、授权流程与危险操作清单
  • references/:18 份参考文档,覆盖全局规范、错误码、字段规则、意图指南、恢复策略、授权说明,以及 14 个产品域的专用参考(aitable、attendance、calendar、chat、contact、devdoc、ding、doc、drive、mail、minutes、oa、report、todo、workbench)
  • scripts/:15 个可执行辅助脚本,包括考勤记录查询、团队排班、日历闲忙探测与会议预约、今日日程、部门成员拉取、待办批量创建与逾期检查、日报收件箱、附件上传等场景化封装
  • _icon.svg 与 _skillhub_meta.json:技能图标与元数据配置

核心能力

  • 意图智能路由:自动识别用户口语中的产品域(如区分「表格」指向普通 sheet 还是 AI 多维表 aitable),减少误操作
  • 自闭环授权体系:支持浏览器自动登录、设备流授权码、二维码兜底、host-owned PAT 按需申请,无需外部 Runtime 改造即可独立完成钉钉 OAuth 与业务权限授权
  • 动态命令发现:执行前实时查询 dws --help 与 dws schema,以 CLI 实际能力为准,不依赖过时静态文档
  • 安全写操作:所有写入类操作优先 --dry-run 预览,展示操作摘要并经用户明确确认后加 --yes 执行,批量操作自动拆批(单次不超过 30 条)
  • 结构化输出解析:默认 --format json,同时处理 stdout 与 stderr,提取 URL、授权码、requiredScopes 等关键字段
  • 权限探针诊断:按需执行只读探针,快速定位已授权域与缺失 PAT,避免盲目重试业务命令

应用场景

用户怎么说本技能做什么
"帮我看看今天有哪些日程和待办"执行 calendar_today_agenda.py 与 todo_daily_summary.py,汇总今日日程与待办优先级,标记逾期项
"我要在钉钉文档里新建一个项目周报"路由到 doc 域,先查 dws doc --help 与 schema,确认 doc:read 权限后执行创建,写操作前展示摘要并等待确认
"为什么登录了还是读不了文档"启动权限探针,检查 dws auth status 与 doc:read PAT 状态,向用户解释三层权限模型,按需引导二次授权
"把市场部这周的考勤打卡记录导出来"路由到 attendance 域,执行 attendance_team_shift.py 或调用 dws attendance 相关命令,输出结构化考勤数据
"批量给项目组创建下周的待办任务"执行 todo_batch_create.py,按模板批量创建待办并设置截止时间,超过 30 条自动拆批并逐批确认