{
  "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"
      ]
    }
  }
}