Menu
钉钉邮箱。Use when 用户说 发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索。Distinct from dingtalk-chat(钉钉消息)、dingtalk-ding(紧急通知)。命令前缀：dws mail。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | dingtalk-mail |
| description | 钉钉邮箱。Use when 用户说 发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索。Distinct from dingtalk-chat(钉钉消息)、dingtalk-ding(紧急通知)。命令前缀：dws mail。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果
dws <cmd> --help不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：mail.md。复杂搜索、附件、批量处理、草稿等多步邮件场景参考：09-mail.md。
以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service mail --format json 读取参数、约束、风险和示例，并以 dws mail <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws mail +contact-list | read | 列出指定邮箱的所有邮件联系人 |
dws mail +find-mail-user | read | 按关键词搜索邮箱联系人并投影列表（姓名/昵称/邮箱/工号等） |
dws mail +folder-list | read | 列出顶层文件夹或指定父文件夹下的子文件夹 |
dws mail +recent-mail | read | 列出收件箱近期邮件会话并投影列表（主题/发件人/时间/threadId） |
dws mail +search-mail | read | 按 KQL 关键词搜索邮件并投影列表（主题/发件人/时间/messageId） |
dws mail +tag-list | read | 列出指定邮箱下的所有邮件标签 |
dws mail +template-list | read | 列出指定邮箱的所有邮件模板 |
dws mail +thread-list | read | 列出指定邮箱文件夹下的邮件会话（thread） |
dws mail +unread-mail | read | 列出未读邮件并投影列表（主题/发件人/时间/messageId） |
dws mail +user-search | read | 按关键词或工号搜索邮箱用户（仅企业邮箱） |
| 用户说 | 命令 |
|---|---|
| "发邮件给 a@b.com" | dws mail message send --from <自己邮箱> --to a@b.com --subject "<标题>" --content "<正文>"（正文规范 flag 是 --content，--body 为隐藏别名） |
| "今天未读邮件" | python scripts/mail_unread_summary.py |
| "带抄送发送" | python scripts/mail_send_with_cc.py --to a@b.com --cc c@d.com --subject "<标题>" --body "<正文>" |
message search 命中后必须继续调用 dws mail message get --email <邮箱> --id <messageId> --format json；不要只列候选后停下。message get；只有同等候选无法判断时才询问用户。dws mail 命令加 --format json，并复用同一封邮件的 messageId，不要重新搜索导致目标漂移。dingtalk-contact 取 orgAuthEmaildingtalk-chat管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库时使用。
钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、指定发送人、已读、撤回和表情回应，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。
钉钉多组织 / profile 管理与跨组织取数。Use when 用户说 切换组织/换组织/跨组织/另一个钉钉/别的公司/多组织/看登录了哪些组织/profile，或在当前组织找不到群/人/数据需要去其他组织找。命令前缀：dws profile / dws auth / 全局 --profile。
dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。
钉钉通讯录查询与组织管理（用户、部门、角色、花名册、离职员工、创建企业、企业账号、邀请员工）。Use when 用户说 查部门/我的信息/按 userId 查/离职员工/创建企业/企业账号/邀请员工。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。
钉钉开放平台企业内部应用管理：应用查询/创建/修改/删除/停启、凭证、权限点、成员、安全配置、网页应用、机器人、版本发布。Use when 用户说 开发者后台应用/开放平台应用/企业内部应用/agentId/clientId/appKey/appSecret/customKey/应用权限/权限点/scopeValue/创建机器人/智能体机器人/机器人配置/机器人回调/IP白名单/登录重定向/端内免登/应用版本/版本发布/发布审核/选审批人/把机器人接到本地调试/connect。