dingtalk-real-ai/dingtalk-workspace-cli

dingtalk-chat

钉钉群聊与消息。Use when 收发/搜索消息、建群、群治理、Bot/Webhook、文件,或仅限 IM 的消息谓词筛选。跨源主题/行为轨迹走 dingtalk-aisearch;DING/班级群走 dingtalk-misc;邮件走 dingtalk-mail。

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/dingtalk-real-ai/dingtalk-workspace-cli --skill dingtalk-chat

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

群聊/消息

<!-- DWSRUNTIMECONTRACT_START -->

最小 DWS 执行契约

  • 只用 dws;结构化读取加 --format json,按真实返回判断。
  • 已知命令直调;参数/约束/安全不明查 leaf 窄 Schema。Schema 不可用才读已知 leaf Help 一次;unknown flag 用同 leaf Help 修正一次。unknown command 不查 Help:优先错误中的明确 suggestion,其次已加载 Skill/reference 中的明确兼容入口;均无则报漂移并停,禁全 Catalog。低频 reference 不默认 Help,禁 root/parent/product Help。发现后必须执行或说明阻塞。
  • 不猜命令/flag/字段/ID/账号/业务事实;ID 来自真实返回。目标零命中/多候选/类型不明先消歧;仅可选时间/展示范围用契约默认,缺必需信息即停。
  • 解析/读/写同一 profile,ID 不跨组织。多账号只用唯一 isOrgCurrent=true;否则用户指定,禁止选择第一项、最近登录或最近使用账号。
  • 不输出/记录 token、refresh token、appSecret、webhook token;已注入认证时不索要。
  • 写须符合明确意图;确认以最终 Runtime gate/Schema 为准,确认后才加 --yes。
  • 写后验证结果,不凭退出码宣称成功。退出须最终答复,区分完成、部分、阻塞、待确认、失败;保留已有数据及 complete/hasMore/stopReason/failures。
  • 时间戳按会话时区展示,必要时保留原值。
  • 认证/权限/profile/confirmation/未知错误只读 dingtalk-shared 对应 reference,禁连续猜替代命令。

<!-- DWSRUNTIMECONTRACT_END -->

对象与路由边界

  • openConversationId 是会话,messageId/openMessageId 是消息,openTaskId 是发送任务,不可混用。
  • 会话分组/分类走 category,群聊/聊天群走 chat group;会话列表无正文,总结/统计读消息。Pin/Top/Favorite 不是分类。

<!-- VISIBLESHORTCUTSSTART -->

Shortcut 发现(Shortcut-first)

按 Golden Route/reference 选 Shortcut;仅缺底层字段用 atomic,低频走 reference/Catalog。

参数查 dws schema --cli-path "chat <leaf>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json;仅需且已发布 result 时查 outcomes/pagination,字段级再查 data_schema;缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help;unknown flag 用同 leaf Help 修正一次。unknown command 禁 Help:错误 suggestion → 已加载 Skill/reference 明确入口;均无则报漂移。禁全 Catalog/root/parent/product Help;低频 reference 不默认 Help。 <!-- VISIBLESHORTCUTSEND -->

Golden Route

用户终点唯一推荐入口关键边界
<!-- dws-intent: chat.read.conversation -->读取指定群聊/单聊dws chat +chat-messages --no-reactions全部时加 --page-all
<!-- dws-intent: chat.search.filtered --><!-- dws-intent: chat.read.reactions -->按关键词/发送者/@/类型/reaction 过滤dws chat +search-msg(reaction 加 --has-reactions)默认 7 天;范围用 --start/--end
跨会话读取/总结/统计dws chat message list-all --start <开始> --end <结束> --page-all --no-reactions不先列会话逐群循环
<!-- dws-intent: chat.conversation.active-since -->时间后活跃会话dws chat +recent-conversations --start <时间>摘要;查 complete;+active-conversations 仅兼容
查看 @我的消息dws chat +at-me [--group <群名或ID>] --page-all --no-reactions未指定群则跨会话;默认 7 天
查看未读消息dws chat +unread-chats需正文时沿 CID 读消息
已知消息 ID 批量取详情dws chat +messages-mget看 leaf Schema;保留会话上下文
<!-- dws-intent: chat.send.dm -->按姓名发文本/Markdowndws chat +dm --to <姓名> --content <内容>唯一解析;多候选停止
<!-- dws-intent: chat.send.group -->按群名/ID 发文本/Markdowndws chat +send-to-group --group <群名或ID> --content <内容>多候选停止
<!-- dws-intent: chat.send.advanced -->图文/文件/Bot/Webhook/复杂 @dws chat +messages-send本地图文先读资源;Bot 多群检查逐项 ledger
全部会话dws chat +conversation-list --page-all含群聊/单聊,非正文
查加入/管理的群+my-groups --page-all / +chat-list-mine后者无 --page-all;flag 不跨 leaf
搜群或查看全部成员+chat-search --query <词> / +chat-members-list --group <群名或ID>多候选停止;检查 buckets/完整性
查群资料/Bot/邀请链接+conversation-info / +chat-bots / +chat-invite-url只读
<!-- dws-intent: chat.create.group -->创建/清理临时群dws chat +chat-create --name <名称> --member-query <姓名列表> → 保存 CID → +chat-dismiss --group <cid>已知 ID 用 --users;清理须确认、验证
改群资料/设置/禁言/管理员+chat-update / +chat-update-settings / +chat-mute / +chat-mute-member / +chat-set-admin用真实群/用户 ID;写后读回
管理群身份读 group-admin 角色 family角色 CRUD、成员绑定/解绑/查询;不切 atomic,写后回读
<!-- dws-intent: chat.category.list-conversations -->列分类内会话dws chat +category-list-conversations --category-id <ID>分类≠群;先取 ID
<!-- dws-intent: chat.reply.quote -->引用回复dws chat +messages-reply用真实消息/CID;未知投递状态非成功
撤回/转发+messages-recall;+messages-forward / +messages-combine-forward / +messages-forward-topic不复制正文冒充原生转发
Pin/消息 Top/Favorite+messages-set-pin / +messages-unset-pin;+messages-set-top / +messages-unset-top;+flag-create / +flag-cancel对象互不替代;用对应查询验证
添加/移除 reaction+messages-add-emoji / +messages-remove-emoji扩展动作读 message-actions
会话置顶/免打扰/隐藏chat-conversation用真实 CID;会话 Top 非消息 Top
已读/未读/清红点/清空+conversation-mark-read / +conversation-mark-unread / +conversation-clear-red-point / +conversation-clear-all-red-point / +conversation-clear-messages已读需消息 ID;清空按 Runtime 确认
下载消息资源查询加 --download-resources --output-dir <目录>;已有引用用 +messages-resource-download不猜 ID;保留 ledger;临时 URL 不交付

次级:Thread +thread-replies;<!-- dws-intent: chat.conversation.list-top -->置顶 dws chat +conversation-list-top;上传 conversation-file upload;IM 事件走 `dingtalk-event`。

关键结果语义

  • 查询保留范围、数量、完整性、停止原因、失败/下载 ledger;不完整不得称成功。消息仅 --page-all 翻页,达预算返回有界 partial。
  • 子消息用自身 messageId;缺 CID 才继承父 conversationId。写操作沿真实结果传 ID。

写生命周期

  • 多步骤写先校验目标、限制、内容、确认,再沿稳定 ID 串行执行并验证;不截断或换目标。临时资源保留 ID/阶段,失败仅做已授权清理。

上下文预算

  • Skill/Reference/leaf Schema/Help 各读一次;Schema 已给参数禁 Help。总结/统计/检索默认 --no-reactions,资源下载仅显式 opt-in。
  • 用 --fields/--jq/limit/compact 预览,禁 head 截 JSON;大正文落文件,保留 ID、正文证据、下步字段、完整性和失败项。

按需加载

任务≤1个

场景Reference
消息查询 / 动作 / 资源
群读取 / 治理
会话/Bot会话 / Bot
组合/话题/表情/卡片组合 / 话题 / 表情 / 卡片/A2UI
结果/其他原子能力contracts / chat

错误最短路径

  1. 零命中/多候选:停止写并消歧,禁默认第一项。
  2. 参数/确认不明查 leaf Schema;Schema 不可用才查已知 leaf Help。unknown flag 用同 leaf Help 修正一次;unknown command 不查 Help:先用错误的明确 suggestion,再用已加载 Skill/reference 的明确兼容入口;无则报漂移并停,禁全 Catalog。
  3. 仅 retryable=true 按原命令重试一次;API/internal/MCP、写后不一致或无重试性即停,不换 Shortcut/atomic。保留 Trace ID、已完成/待清理项并最终答复;confirmation_required 等用户确认,不补 --yes。

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
dingtalk-real-ai
커뮤니티

dingtalk-aitable

钉钉 AI 表格(多维表)业务操作。Use when 用户需要操作 AI 表格/多维表/Base/Table、应用模式/App 页面/Widget、建表、查写记录、字段、记录评论、评论回复、访问密钥(API Key)、SQL/PostgreSQL/SELECT/JOIN、筛选、排序、公式、模板、批量导入 CSV 或 JSON、导出、仪表盘、图表、上传附件、数据源配置与同步、按任务 ID 查询同步状态或审批数据同步。普通请求以完成明确的业务操作为主;当用户明确要求 CLI 契约评审、核对 aitable 合成 JSON 回执、dry-run、命令参数、Help/Schema 契约或恢复方案时,必须加载本 Skill。只评审 aitable 合成 JSON 回执也必须加载本 Skill;“不要执行线上业务”不等于免除本机离线契约核对,不能按通用 JSON 经验直接作答。这是本机 Help/Schema 契约核对,不是仓库源码审查,不从源码搜索开始;先加载正文确定入口与规则,不能仅凭摘要执行;以用户原文指定的核对入口为准,Skill 参数不得扩大范围。不做电子表格单元格读写或单元格批注(走

1시간 설치 수
1
GitHub Stars
4천
업데이트
11월 13일
dingtalk-real-ai
커뮤니티

dingtalk-doc

钉钉在线文档(adoc):查找、读写、块、评论、附件、导入导出、版本、模板、权限、分享、Markdown/JSONML;文档内白板卡片容器的插入、定位、删除。白板图形内容创建或修改走 dingtalk-misc。

1시간 설치 수
1
GitHub Stars
4천
업데이트
11월 13일
dingtalk-real-ai
커뮤니티

dingtalk-mail

钉钉邮箱读写、搜索、回复与转发。Use when 用户说发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索/邮箱附件。一句话发邮件时先用 dingtalk-contact 解析并确认收件人,再由本 skill 发送;不做钉钉消息(走 dingtalk-chat)、紧急通知(走 dingtalk-misc)。命令前缀:dws mail。

1시간 설치 수
1
GitHub Stars
4천
업데이트
11월 13일
dingtalk-real-ai
커뮤니티

dingtalk-calendar

钉钉日历与会议室。Use when 用户说 约会议/查日程/订会议室/查闲忙/加参会人/改期/取消会议/今天的日程/本周日程/共同空闲。不做视频会议发起/邀请入会/会中控制(走 dingtalk-misc)、AI 听记(走 dingtalk-minutes)、待办任务(走 dingtalk-todo)。命令前缀:dws calendar。

1시간 설치 수
1
GitHub Stars
3.7천
업데이트
10월 16일