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