github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
codex/aitable-run3
dingtalk-workspace-cli/internal/cli/schema_hints/selection/mail.json
T
修雨 2c10be2a1a feat(schema): publish 210 built-in shortcuts (#802) 
Publishes all 210 public built-in shortcuts as reviewed Agent-visible
leaf tools across 16 product groups, with stable canonical identities,
executable +shortcut CLI paths, parameter and cross-parameter
constraints, selection guidance, interface metadata, and runtime-aligned
safety/confirmation semantics. Catalog grows from 603 to 813 tools.
2026-07-28 00:11:29 +08:00

860 lines
41 KiB
JSON
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-agent-selection/mail",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"mail.batch_delete_message": {
"agent_summary": "批量删除邮件（可移入已删除或按类型删除）",
"use_when": [
"已知多个 messageId，用户明确要求删除这些邮件"
],
"avoid_when": [
"只需换文件夹时用 mail message batch-move",
"messageId 未确认时先 search/get"
],
"examples": [
"dws mail message batch-delete --email user@company.com --ids <id1>,<id2>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.batch_delete_message",
"cobra-help:dws mail message batch-delete",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md",
"live-dws-schema:mail.batch_delete_message",
"note:public-catalog-has-no-hard-yes-for-mail-thread-trash/sent-recall"
]
},
"mail.batch_delete_user_mail_contacts": {
"agent_summary": "批量删除个人邮件联系人",
"use_when": [
"需要从自己的联系人列表移除多个已知 contactId 时"
],
"avoid_when": [
"删除邮件或查询企业通讯录用户时不要使用"
],
"examples": [
"dws mail contact batch-delete --email user@company.com --contact-ids <id1>,<id2>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.batch_delete_user_mail_contacts",
"cobra-help:dws mail contact batch-delete",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.batch_move_message": {
"agent_summary": "把多封邮件批量移动到指定文件夹",
"use_when": [
"已知邮件 ID 列表和目标 folderId 时"
],
"avoid_when": [
"永久删除邮件时使用 mail message batch-delete"
],
"examples": [
"dws mail message batch-move --email user@company.com --ids <id1>,<id2> --folder 6"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.batch_move_message",
"cobra-help:dws mail message batch-move",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_download_session": {
"agent_summary": "把指定邮件附件下载到本地文件",
"use_when": [
"已知邮件 ID、附件 ID 和文件名，需要保存单个附件时"
],
"avoid_when": [
"只需列出附件元数据时使用 mail attachment list"
],
"examples": [
"dws mail attachment download --email user@company.com --message-id <messageId> --attachment-id <attachmentId> --name report.pdf --output ."
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_download_session",
"cobra-help:dws mail attachment download",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_draft": {
"agent_summary": "创建邮件草稿但不发送",
"use_when": [
"需要先保存收件人、主题、正文或附件供后续编辑时"
],
"avoid_when": [
"用户要求立即发信时使用 mail message send"
],
"examples": [
"dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_draft",
"cobra-help:dws mail draft create",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_forward_draft": {
"agent_summary": "基于已有邮件创建转发草稿",
"use_when": [
"已知原邮件 ID，需要编辑收件人或附言后再发送时"
],
"avoid_when": [
"直接发送全新邮件使用 mail message send"
],
"examples": [
"dws mail message forward --from user@company.com --to colleague@company.com --id <messageId> --subject \"Fwd: 周报\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_forward_draft",
"cobra-help:dws mail message forward",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_mail_folder": {
"agent_summary": "创建自定义邮件文件夹",
"use_when": [
"需要在指定邮箱中新建归档文件夹时"
],
"avoid_when": [
"移动邮件到已有文件夹时使用 mail message batch-move"
],
"examples": [
"dws mail folder create --email user@company.com --name \"项目资料\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_mail_folder",
"cobra-help:dws mail folder create",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_reply_draft": {
"agent_summary": "创建仅回复原发件人的邮件草稿",
"use_when": [
"已知原邮件 ID 并要回复发件人时"
],
"avoid_when": [
"需要回复全部参与者时使用 mail message reply-all"
],
"examples": [
"dws mail message reply --from user@company.com --id <messageId> --subject \"Re: 周报\" --content \"已收到\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_reply_draft",
"cobra-help:dws mail message reply",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_replyall_draft": {
"agent_summary": "创建回复原邮件全部参与者的草稿",
"use_when": [
"已知原邮件 ID 且回复需要覆盖所有相关收件人时"
],
"avoid_when": [
"只回复原发件人时使用 mail message reply"
],
"examples": [
"dws mail message reply-all --from user@company.com --id <messageId> --subject \"Re: 周报\" --content \"感谢大家\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_replyall_draft",
"cobra-help:dws mail message reply-all",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_user_mail_contact": {
"agent_summary": "创建个人邮件联系人",
"use_when": [
"需要把一个邮件地址保存到自己的联系人列表时"
],
"avoid_when": [
"按姓名搜索企业邮箱用户时使用 mail user search"
],
"examples": [
"dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_user_mail_contact",
"cobra-help:dws mail contact create",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.create_user_message_template": {
"agent_summary": "创建可复用的邮件模板",
"use_when": [
"需要保存固定主题、正文或收件人供重复使用时"
],
"avoid_when": [
"只创建一次性草稿时使用 mail draft create"
],
"examples": [
"dws mail template create --email user@company.com --from user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.create_user_message_template",
"cobra-help:dws mail template create",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.delete_mail_folder": {
"agent_summary": "删除指定邮箱下的邮件文件夹",
"use_when": [
"已通过 folder list 拿到文件夹 ID，用户明确要删除该文件夹"
],
"avoid_when": [
"不要把文件夹名称当作 ID",
"只重命名时用 mail folder update"
],
"examples": [
"dws mail folder delete --email user@company.com --id <folderId>"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.delete_mail_folder",
"cobra-help:dws mail folder delete",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md",
"live-dws-schema:mail.delete_mail_folder"
]
},
"mail.delete_user_message_template": {
"agent_summary": "删除指定邮件模板",
"use_when": [
"已知 templateId 且明确不再需要该模板时"
],
"avoid_when": [
"只修改模板内容时使用 mail template update"
],
"examples": [
"dws mail template delete --email user@company.com --id <templateId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.delete_user_message_template",
"cobra-help:dws mail template delete",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.get_email_by_message_id": {
"agent_summary": "获取指定邮件的完整正文和元数据",
"use_when": [
"搜索或列表已返回 messageId，需要打开邮件内容时"
],
"avoid_when": [
"只需筛选邮件列表时使用 message list 或 search"
],
"examples": [
"dws mail message get --email user@company.com --id <messageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.get_email_by_message_id",
"cobra-help:dws mail message get",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.get_thread": {
"agent_summary": "获取指定邮件会话的详情",
"use_when": [
"已知 conversationId 并需要查看同一会话中的邮件上下文时"
],
"avoid_when": [
"只有单封 messageId 时使用 mail message get"
],
"examples": [
"dws mail thread get --email user@company.com --id <conversationId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.get_thread",
"cobra-help:dws mail thread get",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.get_user_message_template": {
"agent_summary": "获取指定邮件模板的完整内容",
"use_when": [
"已知 templateId 并需要查看主题、正文或收件人时"
],
"avoid_when": [
"需要浏览所有模板时使用 mail template list"
],
"examples": [
"dws mail template get --email user@company.com --id <templateId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.get_user_message_template",
"cobra-help:dws mail template get",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_emails": {
"agent_summary": "列出收件箱或指定文件夹中的邮件（无需手写 KQL）",
"use_when": [
"浏览某文件夹邮件列表，且没有复杂搜索条件"
],
"avoid_when": [
"需要主题/发件人/日期等组合条件时用 mail message search"
],
"examples": [
"dws mail message list --email user@company.com",
"dws mail message list --email user@company.com --folder-id 1 --limit 50"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_emails",
"cobra-help:dws mail message list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md",
"live-dws-schema:mail.list_emails#FAILED"
]
},
"mail.list_folders": {
"agent_summary": "列出指定邮箱的系统和自定义文件夹",
"use_when": [
"需要取得 folderId 或浏览邮箱目录时"
],
"avoid_when": [
"按文件夹列出邮件时使用 mail message list"
],
"examples": [
"dws mail folder list --email user@company.com"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_folders",
"cobra-help:dws mail folder list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_mail_attachments": {
"agent_summary": "列出指定邮件的全部附件元数据",
"use_when": [
"已知邮件 ID 并需要取得附件 ID、名称或大小时"
],
"avoid_when": [
"实际保存附件时使用 mail attachment download"
],
"examples": [
"dws mail attachment list --email user@company.com --id <messageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_mail_attachments",
"cobra-help:dws mail attachment list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_tags": {
"agent_summary": "列出指定邮箱可用的邮件标签",
"use_when": [
"需要取得标签 ID 或查看现有标签时"
],
"avoid_when": [
"邮件文件夹目录使用 mail folder list"
],
"examples": [
"dws mail tag list --email user@company.com"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_tags",
"cobra-help:dws mail tag list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_user_mail_contacts": {
"agent_summary": "分页列出个人保存的邮件联系人",
"use_when": [
"需要浏览自己的联系人或取得 contactId 时"
],
"avoid_when": [
"搜索企业通讯录用户时使用 mail user search"
],
"examples": [
"dws mail contact list --email user@company.com --limit 20"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_user_mail_contacts",
"cobra-help:dws mail contact list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_user_mailboxes": {
"agent_summary": "列出当前登录用户自己的可用邮箱",
"use_when": [
"需要选择当前用户企业邮箱或个人邮箱时"
],
"avoid_when": [
"查找他人的邮箱地址不能使用此命令"
],
"examples": [
"dws mail mailbox list"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_user_mailboxes",
"cobra-help:dws mail mailbox list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.list_user_message_templates": {
"agent_summary": "分页列出当前邮箱的邮件模板",
"use_when": [
"需要浏览模板或取得 templateId 时"
],
"avoid_when": [
"查看单个模板详情时使用 mail template get"
],
"examples": [
"dws mail template list --email user@company.com --limit 20"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.list_user_message_templates",
"cobra-help:dws mail template list",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.search_emails": {
"agent_summary": "用 KQL 搜索邮件，返回 ID 与元信息而非完整正文",
"use_when": [
"按主题/发件人/时间等条件搜索邮件并提取 messageId"
],
"avoid_when": [
"已知 messageId 直接看正文时用 mail message get",
"只列某文件夹邮件且无需复杂条件时优先 mail message list"
],
"examples": [
"dws mail message search --email user@company.com --query \"subject:周报\""
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.search_emails",
"cobra-help:dws mail message search",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md",
"live-dws-schema:mail.search_emails"
]
},
"mail.search_mail_users": {
"agent_summary": "按姓名、工号或关键词搜索企业邮箱用户",
"use_when": [
"需要查找他人的企业邮箱地址时"
],
"avoid_when": [
"列出当前用户自己的邮箱使用 mail mailbox list，搜索邮件内容使用 message search"
],
"examples": [
"dws mail user search --email user@company.com --keyword \"张三\" --limit 20"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.search_mail_users",
"cobra-help:dws mail user search",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.send_draft": {
"agent_summary": "发送草稿箱中已有的邮件草稿",
"use_when": [
"已知草稿 messageId 且用户要求发送该草稿时"
],
"avoid_when": [
"创建或编辑草稿分别使用 draft create 和 draft update"
],
"examples": [
"dws mail draft send --from user@company.com --id <messageId>"
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.send_draft",
"cobra-help:dws mail draft send",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.send_email": {
"agent_summary": "以指定邮箱地址发送一封邮件",
"use_when": [
"用户明确要发邮件，且已确认发件人邮箱、收件人、主题与正文"
],
"avoid_when": [
"只需创建草稿不发送时用 mail draft create",
"回复/转发已有邮件时用 mail message reply / forward"
],
"examples": [
"dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成...\""
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.send_email",
"cobra-help:dws mail message send",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md",
"live-dws-schema:mail.send_email"
]
},
"mail.update_draft": {
"agent_summary": "更新已有邮件草稿的内容",
"use_when": [
"已知草稿 messageId 并需要修改主题、正文或收件人时"
],
"avoid_when": [
"已发送邮件不能用草稿更新"
],
"examples": [
"dws mail draft update --from user@company.com --id <messageId> --subject \"新标题\" --content \"新正文\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.update_draft",
"cobra-help:dws mail draft update",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.update_mail_folder": {
"agent_summary": "重命名指定邮件文件夹",
"use_when": [
"已知 folderId 并需要修改文件夹名称时"
],
"avoid_when": [
"创建或删除文件夹使用对应命令"
],
"examples": [
"dws mail folder update --email user@company.com --id <folderId> --name \"新文件夹名\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.update_mail_folder",
"cobra-help:dws mail folder update",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.update_user_mail_contact": {
"agent_summary": "更新个人邮件联系人的资料",
"use_when": [
"已知 contactId 并需要改显示名或邮箱信息时"
],
"avoid_when": [
"企业通讯录资料不能通过此命令修改"
],
"examples": [
"dws mail contact update --email user@company.com --contact-id <contactId> --display-name \"李四\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.update_user_mail_contact",
"cobra-help:dws mail contact update",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.update_user_message_template": {
"agent_summary": "更新已有邮件模板的内容",
"use_when": [
"已知 templateId 并需要修改名称、主题、正文或收件人时"
],
"avoid_when": [
"创建新模板时使用 mail template create"
],
"examples": [
"dws mail template update --email user@company.com --id <templateId> --subject \"新标题\" --content \"新正文\""
],
"reviewed": true,
"review_reason": "AI 生成并复核的 Agent 选择语义，依据精确 CommandRegistry identity、真实 Cobra help 与产品参考，不改写执行、安全或接口事实。",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.update_user_message_template",
"cobra-help:dws mail template update",
"skills/mono/SKILL.md",
"skills/mono/references/products/mail.md"
]
},
"mail.shortcut_thread_list": {
"agent_summary": "列出指定邮箱文件夹下的邮件会话（thread）",
"use_when": [
"当你想按会话（同一往来主题的邮件串）而非单封邮件来浏览某个文件夹时使用；传入邮箱和文件夹 ID，可按时间范围和升降序筛选，返回会话列表及其 conversationId，供 +thread 查看详情。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +thread-list --email user@company.com --folder 104 --limit 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_thread_list",
"cobra-help:dws mail +thread-list",
"ShortcutRegistry:mail +thread-list"
]
},
"mail.shortcut_folder_list": {
"agent_summary": "列出顶层文件夹或指定父文件夹下的子文件夹",
"use_when": [
"当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用；传入邮箱（可选父文件夹 ID 查子级），返回文件夹列表及其 ID。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +folder-list --email user@company.com"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_folder_list",
"cobra-help:dws mail +folder-list",
"ShortcutRegistry:mail +folder-list"
]
},
"mail.shortcut_tag_list": {
"agent_summary": "列出指定邮箱下的所有邮件标签",
"use_when": [
"当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用；传入邮箱地址，返回全部邮件标签及其 ID。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +tag-list --email user@company.com"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_tag_list",
"cobra-help:dws mail +tag-list",
"ShortcutRegistry:mail +tag-list"
]
},
"mail.shortcut_user_search": {
"agent_summary": "按关键词或工号搜索邮箱用户（仅企业邮箱）",
"use_when": [
"当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用；提供关键词或工号（至少其一），返回匹配的企业邮箱用户列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +user-search --keyword \"张三\"",
"dws mail +user-search --email user@company.com --employee-no \"E123456\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_user_search",
"cobra-help:dws mail +user-search",
"ShortcutRegistry:mail +user-search"
]
},
"mail.shortcut_template_list": {
"agent_summary": "列出指定邮箱的所有邮件模板",
"use_when": [
"当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用；传入邮箱和每页数量，返回模板列表，支持分页。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +template-list --email user@company.com --limit 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_template_list",
"cobra-help:dws mail +template-list",
"ShortcutRegistry:mail +template-list"
]
},
"mail.shortcut_contact_list": {
"agent_summary": "列出指定邮箱的所有邮件联系人",
"use_when": [
"当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用；传入邮箱和每页数量，返回联系人列表，支持分页。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +contact-list --email user@company.com --limit 20"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_contact_list",
"cobra-help:dws mail +contact-list",
"ShortcutRegistry:mail +contact-list"
]
},
"mail.shortcut_find_mail_user": {
"agent_summary": "按关键词搜索邮箱联系人并投影列表（姓名/昵称/邮箱/工号等）",
"use_when": [
"当你只知道某人的姓名、花名或邮箱片段，想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单（姓名、昵称、邮箱地址、工号、职位、工作地）而不想拿到一大坨原始字段时使用；内部按 --query 关键词调用邮箱用户搜索，再在本地把每个匹配用户投影成整洁记录打印出来，可配合 --format/--jq/--fields。这是纯只读操作，只做搜索与本地投影，不会修改任何数据；注意仅企业邮箱可用（个人邮箱如 xxx@dingtalk.com 会因无权限报错）；若没有命中则提示「没搜到邮箱联系人」。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +find-mail-user --query \"张三\"",
"dws mail +find-mail-user --query alice --limit 10"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_find_mail_user",
"cobra-help:dws mail +find-mail-user",
"ShortcutRegistry:mail +find-mail-user"
]
},
"mail.shortcut_recent_mail": {
"agent_summary": "列出收件箱近期邮件会话并投影列表（主题/发件人/时间/threadId）",
"use_when": [
"当你想快速看一眼自己邮箱里近期的邮件会话（收件箱线程/conversation），只需要一份精简清单（主题、发件人、最后修改时间、会话 threadId）、而不想翻完整正文或原始字段时使用；内部先确定要看的邮箱地址——你可以用 --email 指定，不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID，不指定时自动定位收件箱——然后列出该文件夹下的近期会话，最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来，可配合 --format/--jq/--fields。这是纯只读操作，只做列举与本地投影，不会修改、发送或删除任何邮件；若最近没有邮件则提示「最近没有邮件」。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +recent-mail",
"dws mail +recent-mail --limit 30"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_recent_mail",
"cobra-help:dws mail +recent-mail",
"ShortcutRegistry:mail +recent-mail"
]
},
"mail.shortcut_search_mail": {
"agent_summary": "按 KQL 关键词搜索邮件并投影列表（主题/发件人/时间/messageId）",
"use_when": [
"当你想按关键词（KQL 表达式，如 subject:周报、from:alice、hasAttachments:true、folderId:2 等）快速搜自己的邮件、并只看一份精简清单（主题、发件人、时间、邮件 messageId）而不想翻完整正文时使用；内部先确定要搜的邮箱地址——你可以用 --email 指定，不指定时自动取你绑定的第一个邮箱——再执行邮件搜索，最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来，可配合 --format/--jq/--fields。这是纯只读操作，只做搜索与本地投影，不会修改、发送或删除任何邮件；若没有命中则返回空列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +search-mail --query \"subject:周报\"",
"dws mail +search-mail --query \"from:alice AND date>2025-06-01T00:00:00Z\""
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_search_mail",
"cobra-help:dws mail +search-mail",
"ShortcutRegistry:mail +search-mail"
]
},
"mail.shortcut_unread_mail": {
"agent_summary": "列出未读邮件并投影列表（主题/发件人/时间/messageId）",
"use_when": [
"当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单（主题、发件人、时间、邮件 messageId）而不想翻完整正文时使用；内部先确定要查的邮箱地址——你可以用 --email 指定，不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件，最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来，可配合 --format/--jq/--fields。这是纯只读操作，只做搜索与本地投影，不会把邮件标记为已读，也不会修改、发送或删除任何邮件；若没有未读邮件则返回空列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"examples": [
"dws mail +unread-mail",
"dws mail +unread-mail --email user@company.com"
],
"reviewed": true,
"review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
"source_refs": [
"internal/cli/schema_command_registry.json#mail.shortcut_unread_mail",
"cobra-help:dws mail +unread-mail",
"ShortcutRegistry:mail +unread-mail"
]
}
},
"products": {
"mail": {
"agent_summary": "管理邮箱、邮件、草稿、附件、文件夹、联系人与邮件模板",
"use_when": [
"查收、搜索、阅读、回复、发送或整理邮件"
],
"avoid_when": [
"即时消息用 chat；开放平台应用配置用 dev",
"公开 catalog 不含 thread trash / sent-message recall 等硬 --yes 命令时不要臆造路径"
],
"reviewed": true,
"review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
"source_refs": [
"internal/cli/schema_command_registry.json",
"skills/mono/references/products/mail.md",
"CommandRegistry:product=mail",
"Skill:skills/mono/references/products/mail.md",
"live-dws-schema:product-batch-2026-07-14"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink