mcpField
D
dingtalk-chat

dingtalk-chat

github.com/dingtalk-real-aiProductivity3.8k172 installsUpdated today
Repository

About dingtalk-chat

dingtalk-chat is a skill for handling DingTalk conversations and messages through DWS commands. Its prescribed routes cover reading, filtering, sending, and managing messages, with emphasis on using returned IDs and verifying write results and completeness.

Key features

  1. 01Read and filter chat messages
  2. 02Read and summarize messages across conversations
  3. 03Send, reply to, forward, and recall messages
  4. 04Manage conversations, groups, and message markers
  5. 05Download message resources

Use cases

  1. 01Find messages by sender or keyword
  2. 02Read a selected conversation or unread messages
  3. 03Send content to a uniquely resolved person or group
  4. 04Verify message actions and resource downloads

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dingtalk-real-ai/dingtalk-workspace-cli --skill dingtalk-chat

After installing, type/dingtalk-chatin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
01-messaging.md
chat-emoji-list.md
chat.md
contracts.md
intent-guide.md
references/card/
a2ui.md
callback.md
create.md
schema.md
update.md
references/chat/
chat-bot.md
chat-conversation.md
group-admin.md
group-discovery.md
message-actions.md
message-media.md
message-query.md
thread.md

Details

From the project README

群聊/消息

最小 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，禁连续猜替代命令。

对象与路由边界

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

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。

Golden Route

用户终点唯一推荐入口关键边界
读取指定群聊/单聊dws chat +chat-messages --no-reactions全部时加 --page-all
按关键词/发送者/@/类型/reaction 过滤dws chat +search-msg（reaction 加 --has-reactions）默认 7 天；范围用 --start/--end
跨会话读取/总结/统计dws chat message list-all --start <开始> --end <结束> --page-all --no-reactions不先列会话逐群循环
时间后活跃会话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；保留会话上下文
按姓名发文本/Markdowndws chat +dm --to <姓名> --content <内容>唯一解析；多候选停止
按群名/ID 发文本/Markdowndws chat +send-to-group --group <群名或ID> --content <内容>多候选停止
图文/文件/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 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 chat +category-list-conversations --category-id <ID>分类≠群；先取 ID
引用回复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 chat +conversation-list-top；上传 conversation-file upload；IM 事件走 dingtalk-event。

关键结果语义

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

写生命周期

  • 钉钉回复任务：接入方默认先发 A2UI 占位、执行中更新；主动发送默认完整投递。按占位与流式执行。
  • 多步骤写先校验目标、限制、内容、确认，再沿稳定 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. 参数/确认及未知 flag/command：按上方最小 DWS 执行契约处理，禁全 Catalog。
  3. 仅 retryable=true 按原命令重试一次；API/internal/MCP、写后不一致或无重试性即停，不换 Shortcut/atomic。保留 Trace ID、已完成/待清理项并最终答复；confirmation_required 等用户确认，不补 --yes。

Comments

Markdown supported