dingtalk-workspace-cli/internal/cli/schema_agent_metadata/mail.json

{
  "product_id": "mail",
  "tools": {
    "mail attachment download": {
      "agent_summary": "下载邮件附件",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "下载到指定目录",
        "再下载指定附件到当前目录（每次只能下载一个附件）",
        "步骤 5.3：对每个附件逐个下载（没有批量下载命令，必须循环调用）"
      ],
      "avoid_when": [
        "要“列举邮件附件”请改用 dws mail attachment list"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name report.pdf",
        "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name img.png --output /tmp"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail attachment list": {
      "agent_summary": "列举邮件附件",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "先列出附件获取 id 和 name",
        "（对搜索结果中的每封邮件都要执行一次）"
      ],
      "avoid_when": [
        "要“下载邮件附件”请改用 dws mail attachment download"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail attachment list --email user@company.com --id \u003cmessageId\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail contact batch-delete": {
      "agent_summary": "批量删除用户邮箱联系人",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "批量删除用户邮箱联系人"
      ],
      "avoid_when": [
        "要“修改用户邮箱联系人信息”请改用 dws mail contact update",
        "要“列出用户邮箱联系人”请改用 dws mail contact list",
        "要“创建用户邮箱联系人”请改用 dws mail contact create"
      ],
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail contact batch-delete --email user@company.com --contact-ids \u003cid1\u003e,\u003cid2\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/destructive-safety.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail contact create": {
      "agent_summary": "创建用户邮箱联系人",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建用户邮箱联系人"
      ],
      "avoid_when": [
        "要“修改用户邮箱联系人信息”请改用 dws mail contact update",
        "要“列出用户邮箱联系人”请改用 dws mail contact list",
        "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\"",
        "dws mail contact create --email user@company.com --contact-email colleague@company.com --first-name \"三\" --last-name \"张\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail contact list": {
      "agent_summary": "列出用户邮箱联系人",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "列出用户邮箱联系人"
      ],
      "avoid_when": [
        "要“修改用户邮箱联系人信息”请改用 dws mail contact update",
        "要“创建用户邮箱联系人”请改用 dws mail contact create",
        "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail contact list --email user@company.com --limit 20",
        "dws mail contact list --email user@company.com --limit 20 --cursor \u003cnextCursor\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail contact update": {
      "agent_summary": "修改用户邮箱联系人信息",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "修改用户邮箱联系人信息"
      ],
      "avoid_when": [
        "要“列出用户邮箱联系人”请改用 dws mail contact list",
        "要“创建用户邮箱联系人”请改用 dws mail contact create",
        "要“批量删除用户邮箱联系人”请改用 dws mail contact batch-delete"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --display-name \"李四\"",
        "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --contact-email new@company.com --first-name \"四\" --last-name \"李\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail draft create": {
      "agent_summary": "创建邮件草稿",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建邮件草稿"
      ],
      "avoid_when": [
        "要“发送草稿箱中的邮件”请改用 dws mail draft send",
        "要“更新邮件草稿”请改用 dws mail draft update"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\"",
        "dws mail draft create --from user@company.com --subject \"草稿标题\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail draft send": {
      "agent_summary": "发送草稿箱中的邮件",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "发送草稿箱中的邮件"
      ],
      "avoid_when": [
        "要“创建邮件草稿”请改用 dws mail draft create",
        "要“更新邮件草稿”请改用 dws mail draft update"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail draft send --from user@company.com --id \u003cmessageId\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail draft update": {
      "agent_summary": "更新邮件草稿",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "更新邮件草稿"
      ],
      "avoid_when": [
        "要“创建邮件草稿”请改用 dws mail draft create",
        "要“发送草稿箱中的邮件”请改用 dws mail draft send"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --subject \"新标题\" --content \"新正文\"",
        "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --content \"见附件\" --attachment ./report.pdf"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail folder create": {
      "agent_summary": "创建邮件文件夹",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1b. 创建顶层邮件文件夹",
        "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder",
        "创建邮件文件夹/新建邮箱文件夹/新建邮件目录"
      ],
      "avoid_when": [
        "要“列举邮件文件夹”请改用 dws mail folder list",
        "要“删除邮件文件夹”请改用 dws mail folder delete",
        "要“更新邮件文件夹”请改用 dws mail folder update"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail folder create --email user@company.com --name \"项目资料\"",
        "dws mail folder create --email user@company.com --name \"子文件夹\" --folder \u003cfolderId\u003e"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.create_mail_folder",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "create_mail_folder"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail folder delete": {
      "agent_summary": "删除邮件文件夹",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id"
      ],
      "avoid_when": [
        "要“列举邮件文件夹”请改用 dws mail folder list",
        "要“创建邮件文件夹”请改用 dws mail folder create",
        "要“更新邮件文件夹”请改用 dws mail folder update"
      ],
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e",
        "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.delete_mail_folder",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/destructive-safety.json",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "delete_mail_folder"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail folder list": {
      "agent_summary": "列举邮件文件夹",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1c. 创建子文件夹 — 先通过 folder list 获取父文件夹 id，再传给 --folder",
        "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id",
        "1h. 列出文件夹中的邮件会话 — 先通过 folder list 获取文件夹 id，再传给 --folder",
        "列出邮件会话/查看会话列表/查看某个文件夹里的邮件会话",
        "删除邮件文件夹/删除邮箱文件夹/删除邮件目录",
        "在某个邮件文件夹下创建子文件夹",
        "重命名邮件文件夹/修改邮箱文件夹名称/更新邮件目录名称"
      ],
      "avoid_when": [
        "要“创建邮件文件夹”请改用 dws mail folder create",
        "要“删除邮件文件夹”请改用 dws mail folder delete",
        "要“更新邮件文件夹”请改用 dws mail folder update"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail folder list --email user@company.com",
        "dws mail folder list --email user@company.com --folder \u003cfolderId\u003e"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_folders",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "list_folders"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail folder update": {
      "agent_summary": "更新邮件文件夹",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1d. 更新或删除邮件文件夹 — 先通过 folder list 获取目标文件夹 id，再传给 --id"
      ],
      "avoid_when": [
        "要“列举邮件文件夹”请改用 dws mail folder list",
        "要“创建邮件文件夹”请改用 dws mail folder create",
        "要“删除邮件文件夹”请改用 dws mail folder delete"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\"",
        "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\" --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.update_mail_folder",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "update_mail_folder"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail mailbox list": {
      "agent_summary": "查询可用邮箱地址",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1. 查看可用邮箱 — 提取邮箱地址",
        "发带附件的邮件/发邮件附件",
        "发邮件/写邮件",
        "我的邮箱/邮箱地址",
        "获取/查找/得到 某人的邮箱地址"
      ],
      "avoid_when": [
        "需要创建、修改或删除数据时不要使用；本命令只用于“查询可用邮箱地址”"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail mailbox list",
        "dws mail mailbox list --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_user_mailboxes",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "list_user_mailboxes"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message batch-delete": {
      "agent_summary": "批量删除邮件",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "批量删除邮件"
      ],
      "avoid_when": [
        "要“创建回复草稿”请改用 dws mail message reply",
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message batch-delete --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/destructive-safety.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message batch-move": {
      "agent_summary": "批量移动邮件到指定文件夹",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "批量移动邮件到指定文件夹"
      ],
      "avoid_when": [
        "要“创建回复草稿”请改用 dws mail message reply",
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message batch-move --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e --folder 6"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message forward": {
      "agent_summary": "创建转发草稿",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建转发草稿"
      ],
      "avoid_when": [
        "要“创建回复草稿”请改用 dws mail message reply",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message forward --from user@company.com --id \u003cmessageId\u003e",
        "dws mail message forward --from user@company.com --to colleague@company.com --id \u003cmessageId\u003e --subject \"Fwd: 周报\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message get": {
      "agent_summary": "查看邮件完整内容",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "3. 查看邮件详情"
      ],
      "avoid_when": [
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail message get --email user@company.com --id \u003cmessageId\u003e",
        "dws mail message get --email user@company.com --id \u003cmessageId\u003e --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_email_by_message_id",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "get_email_by_message_id"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message reply": {
      "agent_summary": "创建回复草稿",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建回复草稿"
      ],
      "avoid_when": [
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message reply --from user@company.com --id \u003cmessageId\u003e",
        "dws mail message reply --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"已收到，谢谢！\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message reply-all": {
      "agent_summary": "创建回复全部草稿",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建回复全部草稿"
      ],
      "avoid_when": [
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e",
        "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"感谢大家的参与！\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message search": {
      "agent_summary": "搜索邮件 (KQL 语法)",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "2. 搜索邮件 — 提取 messageId",
        "下载附件/保存附件/把附件存到本地/把所有附件下载到...",
        "发送草稿/把草稿发出去/发这封草稿",
        "取返回中的 nextCursor，传入下一次请求（nextCursor=\"$\" 时停止）",
        "找邮件/搜邮件/查邮件",
        "把XX邮件的所有附件都下载",
        "查看会话/获取会话/看这封邮件的会话",
        "查看附件/邮件附件/有什么附件",
        "步骤 5.1：先通过 message search 或 message get 获取邮件中的 conversationId",
        "看邮件/打开邮件/邮件内容",
        "示例：下载4月所有发票邮件的附件",
        "第一页"
      ],
      "avoid_when": [
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail message search --email \u003cemail\u003e --query \u003cquery\u003e"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.search_emails",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "search_emails"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail message send": {
      "agent_summary": "发送邮件",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "4. 发送邮件（纯文本）",
        "4b. 发送带附件的邮件（自动编排：创建草稿→上传附件→发送草稿）",
        "4c. 发送带内联图片的邮件（正文自动转 HTML，\u003cimg\u003e 标签自动注入）"
      ],
      "avoid_when": [
        "要“创建转发草稿”请改用 dws mail message forward",
        "要“批量删除邮件”请改用 dws mail message batch-delete",
        "要“批量移动邮件到指定文件夹”请改用 dws mail message batch-move"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成任务A和任务B\"",
        "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"见附件\" --attachment ./report.pdf"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.send_email",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "send_email"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail tag list": {
      "agent_summary": "列举邮件标签",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "1f. 创建子标签 — 先通过 tag list 获取父标签 id，再传给 --parent-id",
        "1g. 更新或删除邮件标签 — 先通过 tag list 获取目标标签 id，再传给 --id",
        "删除邮件标签/删除邮箱标签/删除 label",
        "在某个邮件标签下创建子标签",
        "查看邮件标签/列出邮箱标签/查看邮箱 label",
        "重命名邮件标签/修改邮箱标签名称/更新 label 名称"
      ],
      "avoid_when": [
        "需要创建、修改或删除数据时不要使用；本命令只用于“列举邮件标签”"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail tag list --email user@company.com",
        "dws mail tag list --email user@company.com --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_tags",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "list_tags"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail template create": {
      "agent_summary": "创建个人邮件模板",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "创建个人邮件模板"
      ],
      "avoid_when": [
        "要“列出用户邮件模板”请改用 dws mail template list",
        "要“删除用户邮件模板”请改用 dws mail template delete",
        "要“获取用户邮件模板详情”请改用 dws mail template get"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail template create --email user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结...\"",
        "dws mail template create --email user@company.com --from user@company.com --name \"通知模板\" --subject \"通知\" --content \"...\" --to a@x.com,b@x.com --cc c@x.com"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail template delete": {
      "agent_summary": "删除用户邮件模板",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "删除用户邮件模板"
      ],
      "avoid_when": [
        "要“列出用户邮件模板”请改用 dws mail template list",
        "要“创建个人邮件模板”请改用 dws mail template create",
        "要“获取用户邮件模板详情”请改用 dws mail template get"
      ],
      "effect": "destructive",
      "effect_source": "agent-hint",
      "risk": "high",
      "confirmation": "user_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail template delete --email user@company.com --id \u003ctemplateId\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/destructive-safety.json",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail template get": {
      "agent_summary": "获取用户邮件模板详情",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "获取用户邮件模板详情"
      ],
      "avoid_when": [
        "要“列出用户邮件模板”请改用 dws mail template list",
        "要“创建个人邮件模板”请改用 dws mail template create",
        "要“删除用户邮件模板”请改用 dws mail template delete"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail template get --email user@company.com --id \u003ctemplateId\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail template list": {
      "agent_summary": "列出用户邮件模板",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "列出用户邮件模板"
      ],
      "avoid_when": [
        "要“创建个人邮件模板”请改用 dws mail template create",
        "要“删除用户邮件模板”请改用 dws mail template delete",
        "要“获取用户邮件模板详情”请改用 dws mail template get"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail template list --email user@company.com --limit 20",
        "dws mail template list --email user@company.com --limit 20 --cursor \u003cnextCursor\u003e"
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail template update": {
      "agent_summary": "更新用户邮件模板",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "更新用户邮件模板"
      ],
      "avoid_when": [
        "要“创建个人邮件模板”请改用 dws mail template create",
        "要“删除用户邮件模板”请改用 dws mail template delete",
        "要“获取用户邮件模板详情”请改用 dws mail template get"
      ],
      "effect": "write",
      "effect_source": "command-verb",
      "risk": "medium",
      "confirmation": "not_required",
      "idempotency": "unknown",
      "examples": [
        "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --subject \"新标题\" --content \"新正文\"",
        "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --name \"新模板名\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json",
        "skills/mono/schema-hints/sibling-disambiguation.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail thread get": {
      "agent_summary": "获取会话详情",
      "agent_summary_source": "dws-wukong-envelope@4574f7022c32",
      "use_when": [
        "步骤 5.2：用 conversationId 获取会话详情",
        "步骤 5.3（可选）：同时返回会话内所有邮件列表"
      ],
      "avoid_when": [
        "需要创建、修改或删除数据时不要使用；本命令只用于“获取会话详情”"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail thread get --email user@company.com --id \u003cconversationId\u003e",
        "dws mail thread get --email user@company.com --id \u003cconversationId\u003e --format json"
      ],
      "source_refs": [
        "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_thread",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/imported/wukong.json",
        "skills/mono/schema-hints/selection-review.json"
      ],
      "interface_ref": {
        "product_id": "mail",
        "rpc_name": "get_thread"
      },
      "interface_mode": "mcp",
      "availability": "available"
    },
    "mail user search": {
      "agent_summary": "搜索账号",
      "agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
      "use_when": [
        "搜索/查找/联系 邮箱用户/联系人/某人的邮箱地址",
        "翻页继续搜索联系人/通讯录",
        "路径 2：mail user search（仅企业邮箱可用，个人邮箱会报权限错误可忽略）"
      ],
      "avoid_when": [
        "需要创建、修改或删除数据时不要使用；本命令只用于“搜索账号”"
      ],
      "effect": "read",
      "effect_source": "command-verb",
      "risk": "low",
      "confirmation": "not_required",
      "idempotency": "idempotent",
      "examples": [
        "dws mail user search --email \u003c当前邮箱\u003e --keyword \"姓名\" --format json",
        "dws mail user search --keyword \"张三\""
      ],
      "reviewed": false,
      "source_refs": [
        "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users",
        "skills/mono/references/products/mail.md",
        "skills/mono/schema-hints/selection-review.json"
      ],
      "interface_mode": "mcp",
      "availability": "available"
    }
  }
}