dingtalk-workspace-cli/skills/multi/dingtalk-mail/SKILL.md

name, description, cli_version, metadata

name	description	cli_version	metadata
dingtalk-mail	钉钉邮箱。Use when 用户说 发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索。Distinct from dingtalk-chat(钉钉消息)、dingtalk-ding(紧急通知)。命令前缀：dws mail。	>=0.2.14	category stability requires product experimental bins dws

钉钉邮箱 Skill

🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。

PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.

⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。

命令参考：mail.md。复杂搜索、附件、批量处理、草稿等多步邮件场景参考：09-mail.md。

Shortcuts（无专用脚本/recipe 时优先）

以下 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 取 orgAuthEmail
• 钉钉内消息 → 切到 dingtalk-chat