{ "product": "mail", "tools": { "mail.batch_delete_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message batch-delete", "internal/cli/schema_command_registry.json#mail.batch_delete_message", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message", "live-dws-schema:mail.batch_delete_message", "note:public-catalog-has-no-hard-yes-for-mail-thread-trash/sent-recall", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "批量删除邮件(可移入已删除或按类型删除)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只需换文件夹时用 mail message batch-move", "messageId 未确认时先 search/get" ], "canonical_path": "mail.batch_delete_message", "cli_name": "batch-delete", "cli_path": "mail message batch-delete", "confirmation": "not_required", "description": "批量删除指定邮件(移入已删除文件夹或永久删除)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws mail message batch-delete --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "批量删除邮件(可移入已删除或按类型删除)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "批量删除邮件(可移入已删除或按类型删除)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需换文件夹时用 mail message batch-move", "messageId 未确认时先 search/get" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需换文件夹时用 mail message batch-move", "messageId 未确认时先 search/get" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message batch-delete", "value": "mail.batch_delete_message" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message batch-delete", "value": "mail.batch_delete_message" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "批量删除指定邮件(移入已删除文件夹或永久删除)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "批量删除邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "批量删除指定邮件(移入已删除文件夹或永久删除)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message batch-delete --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message batch-delete --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_delete_message" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_message.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_delete_message" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "批量删除邮件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "批量删除邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "批量删除邮件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知多个 messageId,用户明确要求删除这些邮件" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知多个 messageId,用户明确要求删除这些邮件" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_delete_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_message", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮箱地址", "property": "email", "required": true, "type": "string" }, "ids": { "description": "要删除的邮件 ID 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要删除的邮件 ID 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件id列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要删除的邮件 ID 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "ids" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "ids" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件id列表", "interface_type": "array", "property": "ids", "required": true, "type": "string" } }, "path": "mail.batch_delete_message", "primary_cli_path": "mail message batch-delete", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "批量删除邮件", "use_when": [ "已知多个 messageId,用户明确要求删除这些邮件" ] }, "mail.batch_delete_user_mail_contacts": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail contact batch-delete", "internal/cli/schema_command_registry.json#mail.batch_delete_user_mail_contacts", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "批量删除个人邮件联系人", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "删除邮件或查询企业通讯录用户时不要使用" ], "canonical_path": "mail.batch_delete_user_mail_contacts", "cli_name": "batch-delete", "cli_path": "mail contact batch-delete", "confirmation": "not_required", "description": "批量删除指定的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws mail contact batch-delete --email user@company.com --contact-ids \u003cid1\u003e,\u003cid2\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "批量删除个人邮件联系人" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "批量删除个人邮件联系人" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "删除邮件或查询企业通讯录用户时不要使用" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "删除邮件或查询企业通讯录用户时不要使用" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail contact batch-delete", "value": "mail.batch_delete_user_mail_contacts" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail contact batch-delete", "value": "mail.batch_delete_user_mail_contacts" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "批量删除指定的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "批量删除用户邮箱联系人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "批量删除指定的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact batch-delete --email user@company.com --contact-ids \u003cid1\u003e,\u003cid2\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact batch-delete --email user@company.com --contact-ids \u003cid1\u003e,\u003cid2\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_delete_user_mail_contacts" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_delete_user_mail_contacts.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_delete_user_mail_contacts" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "批量删除邮件联系人" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "batch_delete_user_mail_contacts" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "批量删除邮件联系人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要从自己的联系人列表移除多个已知 contactId 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要从自己的联系人列表移除多个已知 contactId 时" ] } }, "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_delete_user_mail_contacts" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_delete_user_mail_contacts", "parameter_count": 2, "parameters": { "contact-ids": { "description": "要删除的联系人 ID 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要删除的联系人 ID 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要删除的联系人 id 列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要删除的联系人 ID 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "contactIds" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "contactIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要删除的联系人 id 列表", "interface_type": "array", "property": "contactIds", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" } }, "path": "mail.batch_delete_user_mail_contacts", "primary_cli_path": "mail contact batch-delete", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "批量删除邮件联系人", "use_when": [ "需要从自己的联系人列表移除多个已知 contactId 时" ] }, "mail.batch_move_message": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message batch-move", "internal/cli/schema_command_registry.json#mail.batch_move_message", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "把多封邮件批量移动到指定文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "永久删除邮件时使用 mail message batch-delete" ], "canonical_path": "mail.batch_move_message", "cli_name": "batch-move", "cli_path": "mail message batch-move", "confirmation": "not_required", "description": "将多封邮件批量移动到目标文件夹。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message batch-move --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e --folder 6" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "把多封邮件批量移动到指定文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "把多封邮件批量移动到指定文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "永久删除邮件时使用 mail message batch-delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "永久删除邮件时使用 mail message batch-delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message batch-move", "value": "mail.batch_move_message" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message batch-move", "value": "mail.batch_move_message" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将多封邮件批量移动到目标文件夹。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "批量移动邮件到指定文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将多封邮件批量移动到目标文件夹。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message batch-move --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e --folder 6" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message batch-move --email user@company.com --ids \u003cid1\u003e,\u003cid2\u003e --folder 6" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_move_message" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.batch_move_message.interface_ref", "value": { "product_id": "mail", "rpc_name": "batch_move_message" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "批量移动邮件到指定文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "批量移动邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "批量移动邮件到指定文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID 列表和目标 folderId 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID 列表和目标 folderId 时" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "batch_move_message" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "batch_move_message", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "目标文件夹 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "destinationFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "destinationFolderId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹", "property": "destinationFolderId", "required": true, "type": "string" }, "ids": { "description": "要移动的邮件 ID 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要移动的邮件 ID 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件id列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要移动的邮件 ID 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "ids" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "ids" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件id列表", "interface_type": "array", "property": "ids", "required": true, "type": "string" } }, "path": "mail.batch_move_message", "primary_cli_path": "mail message batch-move", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "批量移动邮件到指定文件夹", "use_when": [ "已知邮件 ID 列表和目标 folderId 时" ] }, "mail.create_download_session": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail attachment download", "internal/cli/schema_command_registry.json#mail.create_download_session", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "把指定邮件附件下载到本地文件", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只需列出附件元数据时使用 mail attachment list" ], "canonical_path": "mail.create_download_session", "cli_name": "download", "cli_path": "mail attachment download", "confirmation": "not_required", "description": "下载指定邮件的某个附件到本地文件。\n\n流程说明:\n 1. 调用 create_download_session 获取下载链接(stream id)\n 2. 通过 HTTP GET 下载附件内容并保存到本地\n\n参数说明:\n --email 用户邮箱地址(必填)\n --message-id 邮件唯一标识(必填)\n --attachment-id 附件唯一标识,取自 attachment list 的 id 字段(必填)\n --name 保存到本地的文件名(必填,取自 attachment list 的 name 字段)\n --output 保存目录,默认为当前目录\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name report.pdf --output ." ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "把指定邮件附件下载到本地文件" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "把指定邮件附件下载到本地文件" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需列出附件元数据时使用 mail attachment list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需列出附件元数据时使用 mail attachment list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail attachment download", "value": "mail.create_download_session" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail attachment download", "value": "mail.create_download_session" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载指定邮件的某个附件到本地文件。\n\n流程说明:\n 1. 调用 create_download_session 获取下载链接(stream id)\n 2. 通过 HTTP GET 下载附件内容并保存到本地\n\n参数说明:\n --email 用户邮箱地址(必填)\n --message-id 邮件唯一标识(必填)\n --attachment-id 附件唯一标识,取自 attachment list 的 id 字段(必填)\n --name 保存到本地的文件名(必填,取自 attachment list 的 name 字段)\n --output 保存目录,默认为当前目录\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "下载邮件附件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载指定邮件的某个附件到本地文件。\n\n流程说明:\n 1. 调用 create_download_session 获取下载链接(stream id)\n 2. 通过 HTTP GET 下载附件内容并保存到本地\n\n参数说明:\n --email 用户邮箱地址(必填)\n --message-id 邮件唯一标识(必填)\n --attachment-id 附件唯一标识,取自 attachment list 的 id 字段(必填)\n --name 保存到本地的文件名(必填,取自 attachment list 的 name 字段)\n --output 保存目录,默认为当前目录\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name report.pdf --output ." ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail attachment download --email user@company.com --message-id \u003cmessageId\u003e --attachment-id \u003cattachmentId\u003e --name report.pdf --output ." ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_download_session" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_download_session.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_download_session" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载邮件附件到本地" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建附件下载会话" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载邮件附件到本地" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID、附件 ID 和文件名,需要保存单个附件时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID、附件 ID 和文件名,需要保存单个附件时" ] } }, "group": "attachment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_download_session" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_download_session", "parameter_count": 5, "parameters": { "attachment-id": { "description": "附件唯一标识,取自 attachment list 的 id 字段 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件唯一标识,取自 attachment list 的 id 字段 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "附件唯一标识" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件唯一标识,取自 attachment list 的 id 字段 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "attachmentId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "attachmentId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "附件唯一标识", "property": "attachmentId", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "message-id": { "description": "邮件唯一标识 messageId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件唯一标识 messageId (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件的唯一标识id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件唯一标识 messageId (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "messageId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件的唯一标识id", "property": "messageId", "required": true, "type": "string" }, "name": { "description": "保存到本地的文件名,取自 attachment list 的 name 字段 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "保存到本地的文件名,取自 attachment list 的 name 字段 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "保存到本地的文件名,取自 attachment list 的 name 字段 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local download filename", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "name" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local download filename", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "output": { "default": ".", "description": "保存目录,默认为当前目录", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "保存目录,默认为当前目录" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "保存目录,默认为当前目录" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local output path", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "output" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local output path", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "mail.create_download_session", "primary_cli_path": "mail attachment download", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "下载邮件附件到本地", "use_when": [ "已知邮件 ID、附件 ID 和文件名,需要保存单个附件时" ] }, "mail.create_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail draft create", "internal/cli/schema_command_registry.json#mail.create_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建邮件草稿但不发送", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "用户要求立即发信时使用 mail message send" ], "canonical_path": "mail.create_draft", "cli_name": "create", "cli_path": "mail draft create", "confirmation": "not_required", "description": "创建一封邮件草稿,保存到草稿箱(folderId:5)。支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿创建与附件上传,草稿保留在草稿箱(不发送)。\n\n返回字段:\n messageId 新建草稿的邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建邮件草稿但不发送" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建邮件草稿但不发送" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "用户要求立即发信时使用 mail message send" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "用户要求立即发信时使用 mail message send" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail draft create", "value": "mail.create_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail draft create", "value": "mail.create_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建一封邮件草稿,保存到草稿箱(folderId:5)。支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿创建与附件上传,草稿保留在草稿箱(不发送)。\n\n返回字段:\n messageId 新建草稿的邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建邮件草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建一封邮件草稿,保存到草稿箱(folderId:5)。支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿创建与附件上传,草稿保留在草稿箱(不发送)。\n\n返回字段:\n messageId 新建草稿的邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft create --from user@company.com --to colleague@company.com --subject \"草稿标题\" --content \"草稿正文\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建草稿" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建邮件草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建草稿" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要先保存收件人、主题、正文或附件供后续编辑时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要先保存收件人、主题、正文或附件供后续编辑时" ] } }, "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "抄送人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "抄送人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "抄送人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "ccRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cc" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "ccRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件正文" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件正文" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "邮件标题 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件标题 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件标题 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "收件人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "收件人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "收件人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_draft", "primary_cli_path": "mail draft create", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建草稿", "use_when": [ "需要先保存收件人、主题、正文或附件供后续编辑时" ] }, "mail.create_forward_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message forward", "internal/cli/schema_command_registry.json#mail.create_forward_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "基于已有邮件创建转发草稿", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "直接发送全新邮件使用 mail message send" ], "canonical_path": "mail.create_forward_draft", "cli_name": "forward", "cli_path": "mail message forward", "confirmation": "not_required", "description": "将指定邮件转发给其他收件人。\n\n返回字段:\n messageId 新生成的转发邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message forward --from user@company.com --to colleague@company.com --id \u003cmessageId\u003e --subject \"Fwd: 周报\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "基于已有邮件创建转发草稿" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "基于已有邮件创建转发草稿" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "直接发送全新邮件使用 mail message send" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "直接发送全新邮件使用 mail message send" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message forward", "value": "mail.create_forward_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message forward", "value": "mail.create_forward_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将指定邮件转发给其他收件人。\n\n返回字段:\n messageId 新生成的转发邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建转发草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将指定邮件转发给其他收件人。\n\n返回字段:\n messageId 新生成的转发邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message forward --from user@company.com --to colleague@company.com --id \u003cmessageId\u003e --subject \"Fwd: 周报\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message forward --from user@company.com --to colleague@company.com --id \u003cmessageId\u003e --subject \"Fwd: 周报\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_forward_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_forward_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_forward_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "转发邮件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建转发草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "转发邮件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID,需要编辑收件人或附言后再发送时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID,需要编辑收件人或附言后再发送时" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_forward_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_forward_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "content": { "description": "转发附言", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "转发附言" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "转发附言" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要转发的邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要转发的邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "转发的原始邮件id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要转发的邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "转发的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "转发邮件标题", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "转发邮件标题" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "转发邮件标题" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "转发收件人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "转发收件人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "转发收件人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_forward_draft", "primary_cli_path": "mail message forward", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "转发邮件", "use_when": [ "已知原邮件 ID,需要编辑收件人或附言后再发送时" ] }, "mail.create_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail folder create", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.create_mail_folder", "internal/cli/schema_command_registry.json#mail.create_mail_folder", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_mail_folder", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建自定义邮件文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "移动邮件到已有文件夹时使用 mail message batch-move" ], "canonical_path": "mail.create_mail_folder", "cli_name": "create", "cli_path": "mail folder create", "confirmation": "not_required", "description": "在指定邮箱下创建邮件文件夹。\n\n不传 --folder 时创建顶层文件夹;传入 --folder 时在指定父文件夹下创建子文件夹。\n注意:--folder 需要填写父文件夹 ID,不是文件夹名称。父文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result.folder 创建成功后的文件夹信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail folder create --email user@company.com --name \"项目资料\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建自定义邮件文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建自定义邮件文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_mail_folder.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "移动邮件到已有文件夹时使用 mail message batch-move" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "移动邮件到已有文件夹时使用 mail message batch-move" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail folder create", "value": "mail.create_mail_folder" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail folder create", "value": "mail.create_mail_folder" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "在指定邮箱下创建邮件文件夹。\n\n不传 --folder 时创建顶层文件夹;传入 --folder 时在指定父文件夹下创建子文件夹。\n注意:--folder 需要填写父文件夹 ID,不是文件夹名称。父文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result.folder 创建成功后的文件夹信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "该工具支持在指定邮箱下创建邮件文件夹。可以创建顶层文件夹,也可以在指定父文件夹下创建子文件夹。创建成功后返回新文件夹的 ID 和元信息。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "在指定邮箱下创建邮件文件夹。\n\n不传 --folder 时创建顶层文件夹;传入 --folder 时在指定父文件夹下创建子文件夹。\n注意:--folder 需要填写父文件夹 ID,不是文件夹名称。父文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result.folder 创建成功后的文件夹信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder create --email user@company.com --name \"项目资料\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder create --email user@company.com --name \"项目资料\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_mail_folder.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "create_mail_folder" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_mail_folder.interface_ref", "value": "mail.create_mail_folder" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "create_mail_folder" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建邮件文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建邮件文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建邮件文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要在指定邮箱中新建归档文件夹时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要在指定邮箱中新建归档文件夹时" ] } }, "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_mail_folder", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "父文件夹 ID,不传则创建顶层文件夹 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父文件夹 ID,不传则创建顶层文件夹 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "父文件夹唯一标识,不传则创建顶层文件夹" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父文件夹 ID,不传则创建顶层文件夹 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "父文件夹唯一标识,不传则创建顶层文件夹", "property": "folder", "required": false, "type": "string" }, "name": { "description": "新建邮件文件夹名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新建邮件文件夹名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "新建邮件文件夹名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新建邮件文件夹名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "新建邮件文件夹名称", "property": "name", "required": true, "type": "string" } }, "path": "mail.create_mail_folder", "primary_cli_path": "mail folder create", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建邮件文件夹", "use_when": [ "需要在指定邮箱中新建归档文件夹时" ] }, "mail.create_reply_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message reply", "internal/cli/schema_command_registry.json#mail.create_reply_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建仅回复原发件人的邮件草稿", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要回复全部参与者时使用 mail message reply-all" ], "canonical_path": "mail.create_reply_draft", "cli_name": "reply", "cli_path": "mail message reply", "confirmation": "not_required", "description": "回复指定邮件(仅回复发件人)。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message reply --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"已收到\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建仅回复原发件人的邮件草稿" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建仅回复原发件人的邮件草稿" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要回复全部参与者时使用 mail message reply-all" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要回复全部参与者时使用 mail message reply-all" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message reply", "value": "mail.create_reply_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message reply", "value": "mail.create_reply_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复指定邮件(仅回复发件人)。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建回复草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复指定邮件(仅回复发件人)。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message reply --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"已收到\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message reply --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"已收到\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_reply_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_reply_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_reply_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复邮件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建回复草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复邮件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID 并要回复发件人时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID 并要回复发件人时" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_reply_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_reply_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "content": { "description": "回复正文", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回复正文" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回复正文" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要回复的邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要回复的邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "回复的原始邮件id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要回复的邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "回复的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "回复邮件标题", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回复邮件标题" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回复邮件标题" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "收件人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "收件人列表" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "to" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "to" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "property": "to", "required": false, "type": "string" } }, "path": "mail.create_reply_draft", "primary_cli_path": "mail message reply", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "回复邮件", "use_when": [ "已知原邮件 ID 并要回复发件人时" ] }, "mail.create_replyall_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message reply-all", "internal/cli/schema_command_registry.json#mail.create_replyall_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建回复原邮件全部参与者的草稿", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只回复原发件人时使用 mail message reply" ], "canonical_path": "mail.create_replyall_draft", "cli_name": "reply-all", "cli_path": "mail message reply-all", "confirmation": "not_required", "description": "回复邮件给发件人及所有原始收件人。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"感谢大家\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建回复原邮件全部参与者的草稿" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建回复原邮件全部参与者的草稿" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只回复原发件人时使用 mail message reply" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只回复原发件人时使用 mail message reply" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message reply-all", "value": "mail.create_replyall_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message reply-all", "value": "mail.create_replyall_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复邮件给发件人及所有原始收件人。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建回复全部草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复邮件给发件人及所有原始收件人。\n\n返回字段:\n messageId 新生成的回复邮件 ID\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"感谢大家\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message reply-all --from user@company.com --id \u003cmessageId\u003e --subject \"Re: 周报\" --content \"感谢大家\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_replyall_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_replyall_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_replyall_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复所有人" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "create_replyall_draft" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复所有人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID 且回复需要覆盖所有相关收件人时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知原邮件 ID 且回复需要覆盖所有相关收件人时" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_replyall_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_replyall_draft", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "content": { "description": "回复正文", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回复正文" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回复正文" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "要回复的邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要回复的邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "回复的原始邮件id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要回复的邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "回复的原始邮件id", "property": "messageId", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "回复邮件标题", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回复邮件标题" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回复邮件标题" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "收件人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "收件人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_replyall_draft", "primary_cli_path": "mail message reply-all", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "回复所有人", "use_when": [ "已知原邮件 ID 且回复需要覆盖所有相关收件人时" ] }, "mail.create_user_mail_contact": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail contact create", "internal/cli/schema_command_registry.json#mail.create_user_mail_contact", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建个人邮件联系人", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "按姓名搜索企业邮箱用户时使用 mail user search" ], "canonical_path": "mail.create_user_mail_contact", "cli_name": "create", "cli_path": "mail contact create", "confirmation": "not_required", "description": "创建一个新的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建个人邮件联系人" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建个人邮件联系人" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按姓名搜索企业邮箱用户时使用 mail user search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按姓名搜索企业邮箱用户时使用 mail user search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail contact create", "value": "mail.create_user_mail_contact" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail contact create", "value": "mail.create_user_mail_contact" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建一个新的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建用户邮箱联系人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建一个新的邮件联系人。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact create --email user@company.com --contact-email colleague@company.com --display-name \"张三\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_user_mail_contact" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_mail_contact.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_user_mail_contact" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建邮件联系人" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "create_user_mail_contact" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建邮件联系人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要把一个邮件地址保存到自己的联系人列表时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要把一个邮件地址保存到自己的联系人列表时" ] } }, "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_user_mail_contact" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_user_mail_contact", "parameter_count": 6, "parameters": { "contact-email": { "description": "联系人邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "contactEmail" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "contactEmail" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "contactEmail" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "contactEmail", "property": "contactEmail", "required": true, "type": "string" }, "display-name": { "description": "联系人显示名称 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人显示名称 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "displayName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人显示名称 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "displayName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "displayName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "displayName", "property": "displayName", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "first-name": { "description": "联系人名 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人名 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "firstName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人名 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "firstName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "firstName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "firstName", "property": "firstName", "required": false, "type": "string" }, "last-name": { "description": "联系人姓 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人姓 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "lastName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人姓 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "lastName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "lastName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "lastName", "property": "lastName", "required": false, "type": "string" }, "middle-name": { "description": "联系人中间名 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人中间名 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "middleName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人中间名 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "middleName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "middleName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "middleName", "property": "middleName", "required": false, "type": "string" } }, "path": "mail.create_user_mail_contact", "primary_cli_path": "mail contact create", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建邮件联系人", "use_when": [ "需要把一个邮件地址保存到自己的联系人列表时" ] }, "mail.create_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail template create", "internal/cli/schema_command_registry.json#mail.create_user_message_template", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "创建可复用的邮件模板", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只创建一次性草稿时使用 mail draft create" ], "canonical_path": "mail.create_user_message_template", "cli_name": "create", "cli_path": "mail template create", "confirmation": "not_required", "description": "创建一个新的邮件模板。\n\n返回字段:\n 模板创建结果\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail template create --email user@company.com --from user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建可复用的邮件模板" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "创建可复用的邮件模板" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只创建一次性草稿时使用 mail draft create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只创建一次性草稿时使用 mail draft create" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail template create", "value": "mail.create_user_message_template" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail template create", "value": "mail.create_user_message_template" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建一个新的邮件模板。\n\n返回字段:\n 模板创建结果\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建个人邮件模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建一个新的邮件模板。\n\n返回字段:\n 模板创建结果\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template create --email user@company.com --from user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template create --email user@company.com --from user@company.com --name \"周报模板\" --subject \"周报\" --content \"本周工作总结\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_user_message_template" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.create_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "create_user_message_template" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建邮件模板" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "create_user_message_template" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建邮件模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要保存固定主题、正文或收件人供重复使用时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要保存固定主题、正文或收件人供重复使用时" ] } }, "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "create_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_user_message_template", "parameter_count": 8, "parameters": { "cc": { "description": "模板抄送人列表,逗号分隔 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板抄送人列表,逗号分隔 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "抄送人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板抄送人列表,逗号分隔 (可选)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "ccRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cc" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "ccRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "模板邮件正文 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板邮件正文 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板邮件正文 (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": true, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "from": { "description": "模板发件人邮箱 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板发件人邮箱 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板发件人邮箱 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": false, "type": "string" }, "is-draft": { "description": "是否为草稿模板 (可选,默认 false;仅草稿模板后续可 template update)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否为草稿模板 (可选,默认 false;仅草稿模板后续可 template update)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "true:创建模板草稿, false: 创建正式模板, 默认为true" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否为草稿模板 (可选,默认 false;仅草稿模板后续可 template update)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "isDraft" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "isDraft" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "interface_description": "true:创建模板草稿, false: 创建正式模板, 默认为true", "property": "isDraft", "required": false, "type": "boolean" }, "name": { "description": "模板名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "名称", "property": "name", "required": true, "type": "string" }, "subject": { "description": "模板邮件标题 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板邮件标题 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板邮件标题 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "模板收件人列表,逗号分隔 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板收件人列表,逗号分隔 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板收件人列表,逗号分隔 (可选)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.create_user_message_template", "primary_cli_path": "mail template create", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建邮件模板", "use_when": [ "需要保存固定主题、正文或收件人供重复使用时" ] }, "mail.delete_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail folder delete", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.delete_mail_folder", "internal/cli/schema_command_registry.json#mail.delete_mail_folder", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.delete_mail_folder", "live-dws-schema:mail.delete_mail_folder", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "删除指定邮箱下的邮件文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "不要把文件夹名称当作 ID", "只重命名时用 mail folder update" ], "canonical_path": "mail.delete_mail_folder", "cli_name": "delete", "cli_path": "mail folder delete", "confirmation": "not_required", "description": "删除指定邮箱下的邮件文件夹。\n\n注意:--id 需要填写要删除的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 删除结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "删除指定邮箱下的邮件文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "删除指定邮箱下的邮件文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_mail_folder.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "不要把文件夹名称当作 ID", "只重命名时用 mail folder update" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "不要把文件夹名称当作 ID", "只重命名时用 mail folder update" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail folder delete", "value": "mail.delete_mail_folder" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail folder delete", "value": "mail.delete_mail_folder" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除指定邮箱下的邮件文件夹。\n\n注意:--id 需要填写要删除的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 删除结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "该工具支持删除指定邮箱下的邮件文件夹。需要传入要删除的文件夹 ID,文件夹 ID 可通过列出邮件文件夹获得。不要把文件夹名称当作 ID。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除指定邮箱下的邮件文件夹。\n\n注意:--id 需要填写要删除的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 删除结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder delete --email user@company.com --id \u003cfolderId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_mail_folder.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "delete_mail_folder" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_mail_folder.interface_ref", "value": "mail.delete_mail_folder" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "delete_mail_folder" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除邮件文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "删除邮件文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除邮件文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已通过 folder list 拿到文件夹 ID,用户明确要删除该文件夹" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已通过 folder list 拿到文件夹 ID,用户明确要删除该文件夹" ] } }, "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "delete_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_mail_folder", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "要删除的邮件文件夹 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要删除的邮件文件夹 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要删除的邮件文件夹 ID,不是文件夹名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要删除的邮件文件夹 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要删除的邮件文件夹 ID,不是文件夹名称", "property": "id", "required": true, "type": "string" } }, "path": "mail.delete_mail_folder", "primary_cli_path": "mail folder delete", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "删除邮件文件夹", "use_when": [ "已通过 folder list 拿到文件夹 ID,用户明确要删除该文件夹" ] }, "mail.delete_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail template delete", "internal/cli/schema_command_registry.json#mail.delete_user_message_template", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "删除指定邮件模板", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只修改模板内容时使用 mail template update" ], "canonical_path": "mail.delete_user_message_template", "cli_name": "delete", "cli_path": "mail template delete", "confirmation": "not_required", "description": "根据模板 ID 删除指定邮件模板。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws mail template delete --email user@company.com --id \u003ctemplateId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "删除指定邮件模板" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "删除指定邮件模板" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只修改模板内容时使用 mail template update" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只修改模板内容时使用 mail template update" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail template delete", "value": "mail.delete_user_message_template" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail template delete", "value": "mail.delete_user_message_template" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据模板 ID 删除指定邮件模板。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "删除用户邮件模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据模板 ID 删除指定邮件模板。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template delete --email user@company.com --id \u003ctemplateId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template delete --email user@company.com --id \u003ctemplateId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "delete_user_message_template" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.delete_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "delete_user_message_template" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除邮件模板" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "delete_user_message_template" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除邮件模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 且明确不再需要该模板时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 且明确不再需要该模板时" ] } }, "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "delete_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_user_message_template", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "模板id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "模板id", "property": "id", "required": true, "type": "string" } }, "path": "mail.delete_user_message_template", "primary_cli_path": "mail template delete", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "删除邮件模板", "use_when": [ "已知 templateId 且明确不再需要该模板时" ] }, "mail.get_email_by_message_id": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message get", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_email_by_message_id", "internal/cli/schema_command_registry.json#mail.get_email_by_message_id", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.get_email_by_message_id", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "获取指定邮件的完整正文和元数据", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只需筛选邮件列表时使用 message list 或 search" ], "canonical_path": "mail.get_email_by_message_id", "cli_name": "get", "cli_path": "mail message get", "confirmation": "not_required", "description": "根据邮件 ID 获取邮件完整内容,包含正文。\n\n返回字段:\n message 邮件完整信息,包含主题、发件人、收件人、正文、附件等\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail message get --email user@company.com --id \u003cmessageId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件的完整正文和元数据" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件的完整正文和元数据" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_email_by_message_id.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需筛选邮件列表时使用 message list 或 search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需筛选邮件列表时使用 message list 或 search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message get", "value": "mail.get_email_by_message_id" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message get", "value": "mail.get_email_by_message_id" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据邮件 ID 获取邮件完整内容,包含正文。\n\n返回字段:\n message 邮件完整信息,包含主题、发件人、收件人、正文、附件等\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "根据 messageId 获取邮件详情" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据邮件 ID 获取邮件完整内容,包含正文。\n\n返回字段:\n message 邮件完整信息,包含主题、发件人、收件人、正文、附件等\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message get --email user@company.com --id \u003cmessageId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message get --email user@company.com --id \u003cmessageId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_email_by_message_id.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "get_email_by_message_id" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_email_by_message_id.interface_ref", "value": "mail.get_email_by_message_id" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "get_email_by_message_id" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查看邮件完整内容" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "根据 messageId 获取邮件详情" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查看邮件完整内容" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "搜索或列表已返回 messageId,需要打开邮件内容时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "搜索或列表已返回 messageId,需要打开邮件内容时" ] } }, "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_email_by_message_id" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_email_by_message_id", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件ID", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.get_email_by_message_id", "primary_cli_path": "mail message get", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查看邮件完整内容", "use_when": [ "搜索或列表已返回 messageId,需要打开邮件内容时" ] }, "mail.get_thread": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail thread get", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.get_thread", "internal/cli/schema_command_registry.json#mail.get_thread", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.get_thread", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "获取指定邮件会话的详情", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只有单封 messageId 时使用 mail message get" ], "canonical_path": "mail.get_thread", "cli_name": "get", "cli_path": "mail thread get", "confirmation": "not_required", "description": "根据会话 ID 获取会话(thread)详情。\n\n返回字段:\n id 会话唯一标识\n subject 会话主题\n summary 会话摘要信息\n lastModifiedDateTime 会话最后修改时间\n messageCount 会话邮件数量\n tags 会话 tag 信息\n senders 会话发件人列表(email / name)\n isRead 会话是否已读(全部已读/未读)\n priority 会话重要性,取会话内邮件最高优先级(PRY_HIGH / PRY_NORMAL)\n flag 会话标识,取会话内最近邮件的标识(FLAG_NONE / FLAG_REPLY / FLAG_FORWARD)\n hasAttachments 会话是否包含附件(不含 inline 资源)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail thread get --email user@company.com --id \u003cconversationId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件会话的详情" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件会话的详情" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_thread.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只有单封 messageId 时使用 mail message get" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只有单封 messageId 时使用 mail message get" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail thread get", "value": "mail.get_thread" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail thread get", "value": "mail.get_thread" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据会话 ID 获取会话(thread)详情。\n\n返回字段:\n id 会话唯一标识\n subject 会话主题\n summary 会话摘要信息\n lastModifiedDateTime 会话最后修改时间\n messageCount 会话邮件数量\n tags 会话 tag 信息\n senders 会话发件人列表(email / name)\n isRead 会话是否已读(全部已读/未读)\n priority 会话重要性,取会话内邮件最高优先级(PRY_HIGH / PRY_NORMAL)\n flag 会话标识,取会话内最近邮件的标识(FLAG_NONE / FLAG_REPLY / FLAG_FORWARD)\n hasAttachments 会话是否包含附件(不含 inline 资源)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "通过会话 ID 获取指定邮箱中的会话信息,默认仅返回会话基本信息,可通过 $select 参数指定需要额外返回的字段(如 $select=messages 返回会话内的邮件列表)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据会话 ID 获取会话(thread)详情。\n\n返回字段:\n id 会话唯一标识\n subject 会话主题\n summary 会话摘要信息\n lastModifiedDateTime 会话最后修改时间\n messageCount 会话邮件数量\n tags 会话 tag 信息\n senders 会话发件人列表(email / name)\n isRead 会话是否已读(全部已读/未读)\n priority 会话重要性,取会话内邮件最高优先级(PRY_HIGH / PRY_NORMAL)\n flag 会话标识,取会话内最近邮件的标识(FLAG_NONE / FLAG_REPLY / FLAG_FORWARD)\n hasAttachments 会话是否包含附件(不含 inline 资源)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail thread get --email user@company.com --id \u003cconversationId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail thread get --email user@company.com --id \u003cconversationId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_thread.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "get_thread" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_thread.interface_ref", "value": "mail.get_thread" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "get_thread" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取会话详情" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取会话信息" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取会话详情" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 conversationId 并需要查看同一会话中的邮件上下文时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 conversationId 并需要查看同一会话中的邮件上下文时" ] } }, "group": "thread", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_thread" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_thread", "parameter_count": 2, "parameters": { "email": { "description": "会话所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "会话所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "会话所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "会话所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "会话所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "会话唯一标识 conversationId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "会话唯一标识 conversationId (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "会话唯一标识" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "会话唯一标识 conversationId (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "conversationId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "conversationId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "会话唯一标识", "property": "conversationId", "required": true, "type": "string" } }, "path": "mail.get_thread", "primary_cli_path": "mail thread get", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取会话详情", "use_when": [ "已知 conversationId 并需要查看同一会话中的邮件上下文时" ] }, "mail.get_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail template get", "internal/cli/schema_command_registry.json#mail.get_user_message_template", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "获取指定邮件模板的完整内容", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要浏览所有模板时使用 mail template list" ], "canonical_path": "mail.get_user_message_template", "cli_name": "get", "cli_path": "mail template get", "confirmation": "not_required", "description": "根据模板 ID 获取邮件模板的完整信息。\n\n返回字段:\n 模板完整信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail template get --email user@company.com --id \u003ctemplateId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件模板的完整内容" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "获取指定邮件模板的完整内容" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览所有模板时使用 mail template list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览所有模板时使用 mail template list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail template get", "value": "mail.get_user_message_template" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail template get", "value": "mail.get_user_message_template" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据模板 ID 获取邮件模板的完整信息。\n\n返回字段:\n 模板完整信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取用户邮件模板详情" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据模板 ID 获取邮件模板的完整信息。\n\n返回字段:\n 模板完整信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template get --email user@company.com --id \u003ctemplateId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template get --email user@company.com --id \u003ctemplateId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "get_user_message_template" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.get_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "get_user_message_template" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取邮件模板详情" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "get_user_message_template" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取邮件模板详情" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 并需要查看主题、正文或收件人时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 并需要查看主题、正文或收件人时" ] } }, "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "get_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_user_message_template", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "模板id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "模板id", "property": "id", "required": true, "type": "string" } }, "path": "mail.get_user_message_template", "primary_cli_path": "mail template get", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取邮件模板详情", "use_when": [ "已知 templateId 并需要查看主题、正文或收件人时" ] }, "mail.list_emails": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message list", "internal/cli/schema_command_registry.json#mail.list_emails", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "live-dws-schema:mail.list_emails#FAILED", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "列出收件箱或指定文件夹中的邮件(无需手写 KQL)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要主题/发件人/日期等组合条件时用 mail message search" ], "canonical_path": "mail.list_emails", "cli_name": "list", "cli_path": "mail message list", "confirmation": "not_required", "description": "列出指定文件夹中的邮件列表(默认为收件箱)。\n\n底层通过 KQL 查询 folderId 实现,返回邮件 ID 及元信息(不含正文)。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail message list --email user@company.com", "dws mail message list --email user@company.com --folder-id 1 --limit 50" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出收件箱或指定文件夹中的邮件(无需手写 KQL)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出收件箱或指定文件夹中的邮件(无需手写 KQL)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要主题/发件人/日期等组合条件时用 mail message search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要主题/发件人/日期等组合条件时用 mail message search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message list", "value": "mail.list_emails" }, { "precedence": "reviewed_manual", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "mail message list", "value": "mail.list_emails" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message list", "value": "mail.list_emails" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定文件夹中的邮件列表(默认为收件箱)。\n\n底层通过 KQL 查询 folderId 实现,返回邮件 ID 及元信息(不含正文)。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定文件夹中的邮件列表(默认为收件箱)。\n\n底层通过 KQL 查询 folderId 实现,返回邮件 ID 及元信息(不含正文)。\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message list --email user@company.com", "dws mail message list --email user@company.com --folder-id 1 --limit 50" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message list --email user@company.com", "dws mail message list --email user@company.com --folder-id 1 --limit 50" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "CLI wrapper converts the reviewed folder selection into a KQL query and maps pagination before calling the pinned search_emails RPC; the local transform plus RPC call is not a one-to-one interface contract" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "CLI wrapper converts the reviewed folder selection into a KQL query and maps pagination before calling the pinned search_emails RPC; the local transform plus RPC call is not a one-to-one interface contract" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出文件夹中的邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出文件夹中的邮件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "浏览某文件夹邮件列表,且没有复杂搜索条件" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "浏览某文件夹邮件列表,且没有复杂搜索条件" ] } }, "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "CLI wrapper converts the reviewed folder selection into a KQL query and maps pagination before calling the pinned search_emails RPC; the local transform plus RPC call is not a one-to-one interface contract", "is_alias": false, "name": "list_emails", "parameter_count": 4, "parameters": { "cursor": { "description": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" }, "folder-id": { "default": "2", "description": "文件夹 ID(1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除),默认为收件箱", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件夹 ID(1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除),默认为收件箱" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件夹 ID(1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除),默认为收件箱" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folderId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folderId" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folderId", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量(最大限制 100, 默认 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量(最大限制 100, 默认 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量(最大限制 100, 默认 20)" }, "property": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "selected": true, "source": "reviewed_manual_hint", "value": "size" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed composite wrapper contract: the CLI maps --limit to the search_emails size property after constructing a folder KQL query.", "source": "reviewed_manual_hint", "value": "size" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "size", "required": false, "type": "string" } }, "path": "mail.list_emails", "primary_cli_path": "mail message list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出文件夹中的邮件", "use_when": [ "浏览某文件夹邮件列表,且没有复杂搜索条件" ] }, "mail.list_folders": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail folder list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_folders", "internal/cli/schema_command_registry.json#mail.list_folders", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_folders", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "列出指定邮箱的系统和自定义文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "按文件夹列出邮件时使用 mail message list" ], "canonical_path": "mail.list_folders", "cli_name": "list", "cli_path": "mail folder list", "confirmation": "not_required", "description": "列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\n不传 --folder 则返回顶层文件夹,传入则返回该文件夹的子文件夹列表。\n\n返回字段(folders 数组):\n id 文件夹唯一标识\n displayName 文件夹显示名称\n parentFolderId 父文件夹 ID\n childFolderCount 子文件夹数量\n totalItemCount 邮件总数\n unreadItemCount 未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail folder list --email user@company.com" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的系统和自定义文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的系统和自定义文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_folders.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按文件夹列出邮件时使用 mail message list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按文件夹列出邮件时使用 mail message list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail folder list", "value": "mail.list_folders" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail folder list", "value": "mail.list_folders" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\n不传 --folder 则返回顶层文件夹,传入则返回该文件夹的子文件夹列表。\n\n返回字段(folders 数组):\n id 文件夹唯一标识\n displayName 文件夹显示名称\n parentFolderId 父文件夹 ID\n childFolderCount 子文件夹数量\n totalItemCount 邮件总数\n unreadItemCount 未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "该工具支持列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\r\n注意:该工具只会返回文件夹的 ID 和元信息(folderId为空则返回顶层文件夹,非空则返回指定父文件夹的子文件夹)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱的顶层文件夹或指定父文件夹下的所有子文件夹。\n不传 --folder 则返回顶层文件夹,传入则返回该文件夹的子文件夹列表。\n\n返回字段(folders 数组):\n id 文件夹唯一标识\n displayName 文件夹显示名称\n parentFolderId 父文件夹 ID\n childFolderCount 子文件夹数量\n totalItemCount 邮件总数\n unreadItemCount 未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder list --email user@company.com" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder list --email user@company.com" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_folders.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_folders" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_folders.interface_ref", "value": "mail.list_folders" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_folders" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列举邮件文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出邮件文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列举邮件文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要取得 folderId 或浏览邮箱目录时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要取得 folderId 或浏览邮箱目录时" ] } }, "group": "folder", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_folders" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_folders", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "folder": { "description": "父文件夹唯一标识,不传则返回顶层文件夹 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父文件夹唯一标识,不传则返回顶层文件夹 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件夹唯一标识" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父文件夹唯一标识,不传则返回顶层文件夹 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "folderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "folderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件夹唯一标识", "property": "folderId", "required": false, "type": "string" } }, "path": "mail.list_folders", "primary_cli_path": "mail folder list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列举邮件文件夹", "use_when": [ "需要取得 folderId 或浏览邮箱目录时" ] }, "mail.list_mail_attachments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail attachment list", "internal/cli/schema_command_registry.json#mail.list_mail_attachments", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "列出指定邮件的全部附件元数据", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "实际保存附件时使用 mail attachment download" ], "canonical_path": "mail.list_mail_attachments", "cli_name": "list", "cli_path": "mail attachment list", "confirmation": "not_required", "description": "列出指定邮件的所有附件信息。\n\n返回字段(attachments 数组):\n id 附件唯一标识\n name 附件文件名\n contentType 附件 MIME 类型\n size 附件大小(字节)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail attachment list --email user@company.com --id \u003cmessageId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮件的全部附件元数据" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮件的全部附件元数据" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "实际保存附件时使用 mail attachment download" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "实际保存附件时使用 mail attachment download" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail attachment list", "value": "mail.list_mail_attachments" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail attachment list", "value": "mail.list_mail_attachments" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮件的所有附件信息。\n\n返回字段(attachments 数组):\n id 附件唯一标识\n name 附件文件名\n contentType 附件 MIME 类型\n size 附件大小(字节)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列举邮件附件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮件的所有附件信息。\n\n返回字段(attachments 数组):\n id 附件唯一标识\n name 附件文件名\n contentType 附件 MIME 类型\n size 附件大小(字节)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail attachment list --email user@company.com --id \u003cmessageId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail attachment list --email user@company.com --id \u003cmessageId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_mail_attachments" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_mail_attachments.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_mail_attachments" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列举邮件附件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列举邮件附件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列举邮件附件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID 并需要取得附件 ID、名称或大小时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知邮件 ID 并需要取得附件 ID、名称或大小时" ] } }, "group": "attachment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_mail_attachments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_mail_attachments", "parameter_count": 2, "parameters": { "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户邮件地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户邮件地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "邮件唯一标识 messageId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件唯一标识 messageId (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件唯一标识" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件唯一标识 messageId (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件唯一标识", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.list_mail_attachments", "primary_cli_path": "mail attachment list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列举邮件附件", "use_when": [ "已知邮件 ID 并需要取得附件 ID、名称或大小时" ] }, "mail.list_tags": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail tag list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_tags", "internal/cli/schema_command_registry.json#mail.list_tags", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_tags", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "列出指定邮箱可用的邮件标签", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "邮件文件夹目录使用 mail folder list" ], "canonical_path": "mail.list_tags", "cli_name": "list", "cli_path": "mail tag list", "confirmation": "not_required", "description": "列出指定邮箱下的所有邮件标签,返回标签的 ID 和元信息。\n\n返回字段(tags 数组):\n id 标签唯一标识\n name 标签显示名称\n parentId 父标签 ID\n totalItemCount 标签下邮件总数\n unreadItemCount 标签下未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail tag list --email user@company.com" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱可用的邮件标签" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱可用的邮件标签" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_tags.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "邮件文件夹目录使用 mail folder list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "邮件文件夹目录使用 mail folder list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail tag list", "value": "mail.list_tags" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail tag list", "value": "mail.list_tags" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱下的所有邮件标签,返回标签的 ID 和元信息。\n\n返回字段(tags 数组):\n id 标签唯一标识\n name 标签显示名称\n parentId 父标签 ID\n totalItemCount 标签下邮件总数\n unreadItemCount 标签下未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "该工具支持列出指定邮箱下的所有邮件标签。只会返回标签 的 ID 和元信息(名称、父标签、邮件数量、未读数量等。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱下的所有邮件标签,返回标签的 ID 和元信息。\n\n返回字段(tags 数组):\n id 标签唯一标识\n name 标签显示名称\n parentId 父标签 ID\n totalItemCount 标签下邮件总数\n unreadItemCount 标签下未读邮件数量\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail tag list --email user@company.com" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail tag list --email user@company.com" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_tags.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_tags" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_tags.interface_ref", "value": "mail.list_tags" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_tags" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列举邮件标签" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出邮件标签" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列举邮件标签" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要取得标签 ID 或查看现有标签时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要取得标签 ID 或查看现有标签时" ] } }, "group": "tag", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_tags" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_tags", "parameter_count": 1, "parameters": { "email": { "description": "用户的邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户的邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户的邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" } }, "path": "mail.list_tags", "primary_cli_path": "mail tag list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列举邮件标签", "use_when": [ "需要取得标签 ID 或查看现有标签时" ] }, "mail.list_user_mail_contacts": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail contact list", "internal/cli/schema_command_registry.json#mail.list_user_mail_contacts", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "分页列出个人保存的邮件联系人", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "搜索企业通讯录用户时使用 mail user search" ], "canonical_path": "mail.list_user_mail_contacts", "cli_name": "list", "cli_path": "mail contact list", "confirmation": "not_required", "description": "列出指定邮箱的所有邮件联系人。\n\n返回字段:\n 联系人列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail contact list --email user@company.com --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "分页列出个人保存的邮件联系人" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "分页列出个人保存的邮件联系人" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "搜索企业通讯录用户时使用 mail user search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "搜索企业通讯录用户时使用 mail user search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail contact list", "value": "mail.list_user_mail_contacts" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail contact list", "value": "mail.list_user_mail_contacts" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱的所有邮件联系人。\n\n返回字段:\n 联系人列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出用户邮箱联系人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱的所有邮件联系人。\n\n返回字段:\n 联系人列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact list --email user@company.com --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact list --email user@company.com --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_user_mail_contacts" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mail_contacts.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_user_mail_contacts" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列举邮件联系人" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "list_user_mail_contacts" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列举邮件联系人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览自己的联系人或取得 contactId 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览自己的联系人或取得 contactId 时" ] } }, "group": "contact", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_mail_contacts" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_mail_contacts", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor 字段 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "cursor" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "email" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "email", "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "size" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "size" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "size" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "size", "interface_type": "number", "property": "size", "required": true, "type": "string" } }, "path": "mail.list_user_mail_contacts", "primary_cli_path": "mail contact list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列举邮件联系人", "use_when": [ "需要浏览自己的联系人或取得 contactId 时" ] }, "mail.list_user_mailboxes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail mailbox list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.list_user_mailboxes", "internal/cli/schema_command_registry.json#mail.list_user_mailboxes", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mailboxes", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "列出当前登录用户自己的可用邮箱", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "查找他人的邮箱地址不能使用此命令" ], "canonical_path": "mail.list_user_mailboxes", "cli_name": "list", "cli_path": "mail mailbox list", "confirmation": "not_required", "description": "查询当前用户绑定的所有邮箱地址。\n\n返回字段:\n emailAccounts 邮箱列表,每条包含邮箱地址(email)、账号类型(type)、所属企业(orgName)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail mailbox list" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出当前登录用户自己的可用邮箱" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出当前登录用户自己的可用邮箱" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mailboxes.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "查找他人的邮箱地址不能使用此命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "查找他人的邮箱地址不能使用此命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail mailbox list", "value": "mail.list_user_mailboxes" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail mailbox list", "value": "mail.list_user_mailboxes" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询当前用户绑定的所有邮箱地址。\n\n返回字段:\n emailAccounts 邮箱列表,每条包含邮箱地址(email)、账号类型(type)、所属企业(orgName)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询当前钉钉用户可以使用的 Email 地址列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询当前用户绑定的所有邮箱地址。\n\n返回字段:\n emailAccounts 邮箱列表,每条包含邮箱地址(email)、账号类型(type)、所属企业(orgName)\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail mailbox list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail mailbox list" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mailboxes.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_user_mailboxes" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_mailboxes.interface_ref", "value": "mail.list_user_mailboxes" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "list_user_mailboxes" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询可用邮箱地址" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出可用邮箱地址" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询可用邮箱地址" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要选择当前用户企业邮箱或个人邮箱时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要选择当前用户企业邮箱或个人邮箱时" ] } }, "group": "mailbox", "has_parameters": false, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_mailboxes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_mailboxes", "parameter_count": 0, "parameters": {}, "path": "mail.list_user_mailboxes", "primary_cli_path": "mail mailbox list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询可用邮箱地址", "use_when": [ "需要选择当前用户企业邮箱或个人邮箱时" ] }, "mail.list_user_message_templates": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail template list", "internal/cli/schema_command_registry.json#mail.list_user_message_templates", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "分页列出当前邮箱的邮件模板", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "查看单个模板详情时使用 mail template get" ], "canonical_path": "mail.list_user_message_templates", "cli_name": "list", "cli_path": "mail template list", "confirmation": "not_required", "description": "列出指定邮箱的所有邮件模板。\n\n返回字段:\n 模板列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail template list --email user@company.com --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "分页列出当前邮箱的邮件模板" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "分页列出当前邮箱的邮件模板" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "查看单个模板详情时使用 mail template get" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "查看单个模板详情时使用 mail template get" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail template list", "value": "mail.list_user_message_templates" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail template list", "value": "mail.list_user_message_templates" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱的所有邮件模板。\n\n返回字段:\n 模板列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出用户邮件模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱的所有邮件模板。\n\n返回字段:\n 模板列表及分页信息\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template list --email user@company.com --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template list --email user@company.com --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_user_message_templates" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.list_user_message_templates.interface_ref", "value": { "product_id": "mail", "rpc_name": "list_user_message_templates" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列举邮件模板" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "list_user_message_templates" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列举邮件模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览模板或取得 templateId 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要浏览模板或取得 templateId 时" ] } }, "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "list_user_message_templates" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_user_message_templates", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor 字段 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "光标, 其值取自响应中的nextCursor字段,首次列出设为\"\"" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "光标, 其值取自响应中的nextCursor字段,首次列出设为\"\"", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "模板数" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "size" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "size" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "模板数", "interface_type": "number", "property": "size", "required": true, "type": "string" } }, "path": "mail.list_user_message_templates", "primary_cli_path": "mail template list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列举邮件模板", "use_when": [ "需要浏览模板或取得 templateId 时" ] }, "mail.search_emails": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message search", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.search_emails", "internal/cli/schema_command_registry.json#mail.search_emails", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.search_emails", "live-dws-schema:mail.search_emails", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "用 KQL 搜索邮件,返回 ID 与元信息而非完整正文", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "已知 messageId 直接看正文时用 mail message get", "只列某文件夹邮件且无需复杂条件时优先 mail message list" ], "canonical_path": "mail.search_emails", "cli_name": "search", "cli_path": "mail message search", "confirmation": "not_required", "description": "使用类 KQL 查询表达式搜索邮件,仅返回邮件 ID 及元信息(不含正文)。\n\n支持的查询字段:\n date, size, tag, folderId, isRead, hasAttachments,\n subject, attachname, body, from, to\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n字段说明:\n date ISO8601 日期时间,支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: date\u003e2025-06-01T00:00:00Z\n size 邮件大小(字节),支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: size\u003e1024\n folderId 文件夹 ID(整数),必须用数字,不能用文件夹名称\n 示例: folderId:2\n isRead 是否已读,布尔值 true/false\n 示例: isRead:false\n hasAttachments 是否有附件,布尔值 true/false\n 示例: hasAttachments:true\n subject 邮件主题,含空格须加双引号\n 示例: subject:周报 subject:\"项目 进展\"\n body 邮件正文,含空格须加双引号\n 示例: body:会议纪要 body:\"Q1 总结\"\n attachname 附件文件名,含空格须加双引号\n 示例: attachname:report.pdf\n from 发件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: from:alice@company.com from:\"张 三\" from:\"alice\u003ca@b.com\u003e\"\n to 收件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: to:bob@company.com to:\"李 四\" to:\"alice\u003ca@b.com\u003e\"\n\n示例查询:\n date\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n (from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n subject:\"周报\" AND hasAttachments:true\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail message search --email user@company.com --query \"subject:周报\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "用 KQL 搜索邮件,返回 ID 与元信息而非完整正文" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "用 KQL 搜索邮件,返回 ID 与元信息而非完整正文" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_emails.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 messageId 直接看正文时用 mail message get", "只列某文件夹邮件且无需复杂条件时优先 mail message list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 messageId 直接看正文时用 mail message get", "只列某文件夹邮件且无需复杂条件时优先 mail message list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message search", "value": "mail.search_emails" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message search", "value": "mail.search_emails" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "使用类 KQL 查询表达式搜索邮件,仅返回邮件 ID 及元信息(不含正文)。\n\n支持的查询字段:\n date, size, tag, folderId, isRead, hasAttachments,\n subject, attachname, body, from, to\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n字段说明:\n date ISO8601 日期时间,支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: date\u003e2025-06-01T00:00:00Z\n size 邮件大小(字节),支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: size\u003e1024\n folderId 文件夹 ID(整数),必须用数字,不能用文件夹名称\n 示例: folderId:2\n isRead 是否已读,布尔值 true/false\n 示例: isRead:false\n hasAttachments 是否有附件,布尔值 true/false\n 示例: hasAttachments:true\n subject 邮件主题,含空格须加双引号\n 示例: subject:周报 subject:\"项目 进展\"\n body 邮件正文,含空格须加双引号\n 示例: body:会议纪要 body:\"Q1 总结\"\n attachname 附件文件名,含空格须加双引号\n 示例: attachname:report.pdf\n from 发件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: from:alice@company.com from:\"张 三\" from:\"alice\u003ca@b.com\u003e\"\n to 收件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: to:bob@company.com to:\"李 四\" to:\"alice\u003ca@b.com\u003e\"\n\n示例查询:\n date\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n (from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n subject:\"周报\" AND hasAttachments:true\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "使用类似 KQL 的查询表达式搜索邮件。\r\n该工具支持通过灵活的查询表达式、分页、排序和字段选择来搜索邮件。\r\n\r\n注意:该工具只会返回邮件的ID和元信息,不会返回完整的邮件正文内容" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "使用类 KQL 查询表达式搜索邮件,仅返回邮件 ID 及元信息(不含正文)。\n\n支持的查询字段:\n date, size, tag, folderId, isRead, hasAttachments,\n subject, attachname, body, from, to\n\n常用文件夹 ID:1=已发送, 2=收件箱, 3=垃圾邮件, 5=草稿, 6=已删除\n\n字段说明:\n date ISO8601 日期时间,支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: date\u003e2025-06-01T00:00:00Z\n size 邮件大小(字节),支持 \u003e \u003c \u003e= \u003c= 比较运算符\n 示例: size\u003e1024\n folderId 文件夹 ID(整数),必须用数字,不能用文件夹名称\n 示例: folderId:2\n isRead 是否已读,布尔值 true/false\n 示例: isRead:false\n hasAttachments 是否有附件,布尔值 true/false\n 示例: hasAttachments:true\n subject 邮件主题,含空格须加双引号\n 示例: subject:周报 subject:\"项目 进展\"\n body 邮件正文,含空格须加双引号\n 示例: body:会议纪要 body:\"Q1 总结\"\n attachname 附件文件名,含空格须加双引号\n 示例: attachname:report.pdf\n from 发件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: from:alice@company.com from:\"张 三\" from:\"alice\u003ca@b.com\u003e\"\n to 收件人,支持纯邮件地址、纯名称、\"名称\u003c邮件地址\u003e\" 格式,含空格须加双引号\n 示例: to:bob@company.com to:\"李 四\" to:\"alice\u003ca@b.com\u003e\"\n\n示例查询:\n date\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n (from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n subject:\"周报\" AND hasAttachments:true\n\n返回字段:\n messages 邮件列表,每条包含邮件 ID 及元信息(不含正文)\n total 符合条件的总邮件数\n nextCursor 下一页游标,传入 --cursor 翻页;值为 \"$\" 表示已到达列表尾部\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message search --email user@company.com --query \"subject:周报\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message search --email user@company.com --query \"subject:周报\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_emails.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "search_emails" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_emails.interface_ref", "value": "mail.search_emails" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "search_emails" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索邮件 (KQL 语法)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索邮件 (KQL 语法)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按主题/发件人/时间等条件搜索邮件并提取 messageId" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "按主题/发件人/时间等条件搜索邮件并提取 messageId" ] } }, "group": "message", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "search_emails" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_emails", "parameter_count": 4, "parameters": { "cursor": { "description": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段。\"\"表示从头开始", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段。\"\"表示从头开始" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用于检索后续结果的分页游标。第一页时为空。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件的起始偏移标识, 其值取自响应中的nextCursor字段。\"\"表示从头开始" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用于检索后续结果的分页游标。第一页时为空。", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "搜索目标邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索目标邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索目标Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索目标邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "搜索目标Email地址", "property": "email", "required": true, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量(最大限制 100, 默认 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量(最大限制 100, 默认 20)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每次请求返回的最大结果数量(1-100)。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量(最大限制 100, 默认 20)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "size" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "size" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "每次请求返回的最大结果数量(1-100)。", "property": "size", "required": false, "type": "string" }, "query": { "description": "KQL 查询表达式 (必填), 其中 date 格式必须遵循 ISO8601 规范", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "KQL 查询表达式 (必填), 其中 date 格式必须遵循 ISO8601 规范" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询表达式用于筛选邮件,其语法类似于 KQL。\n\n对于字符串类型的值,你可以选择以下两种方式之一:\n使用双引号将字符串括起来(如果字符串本身包含双引号,则需使用两个连续的双引号进行转义);\n或者不使用双引号(此时字符串中不能包含空格)。\n\n如果字符串本身已经用双引号括起,则必须再在外层加一层双引号,并对内部原有的双引号进行转义(即每个内部双引号替换为两个双引号)。\n\n支持的字段包括:\n- date(日期)\n- size(大小)\n- tag(标签)\n- folderId(文件夹 ID):常用文件夹 ID 如下:\n* 1:表示“已发送”\n* 2:表示“收件箱”\n* 3:表示“垃圾邮件”\n* 5:表示“草稿”\n* 6:表示“已删除”\n- isRead(是否已读)\n- hasAttachments(是否有附件)\n- subject(主题)\n- attachname(附件名称)\n- body(正文)\n- from(发件人)\n- to(收件人)\n\n示例1:\n查找 2025 年 1 月 1 日之后收到、且不在垃圾邮件或已删除文件夹中的邮件:\ndate\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n\n示例2:\n查找发件人为 “alice” 的邮件,或者收件人为 “alice\u003ca@b.com\u003e” 且位于“已发送”文件夹中的邮件:\n(from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n\n示例3:\n查找主题中包含 “test” 关键词的邮件,或者包含附件名含 “file” 关键词且发件人为 alice 的邮件:\n(subject:\"test\") OR (attachname:\"file\" AND from:alice\u003ca@b.com\u003e)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "KQL 查询表达式 (必填), 其中 date 格式必须遵循 ISO8601 规范" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "查询表达式用于筛选邮件,其语法类似于 KQL。\n\n对于字符串类型的值,你可以选择以下两种方式之一:\n使用双引号将字符串括起来(如果字符串本身包含双引号,则需使用两个连续的双引号进行转义);\n或者不使用双引号(此时字符串中不能包含空格)。\n\n如果字符串本身已经用双引号括起,则必须再在外层加一层双引号,并对内部原有的双引号进行转义(即每个内部双引号替换为两个双引号)。\n\n支持的字段包括:\n- date(日期)\n- size(大小)\n- tag(标签)\n- folderId(文件夹 ID):常用文件夹 ID 如下:\n* 1:表示“已发送”\n* 2:表示“收件箱”\n* 3:表示“垃圾邮件”\n* 5:表示“草稿”\n* 6:表示“已删除”\n- isRead(是否已读)\n- hasAttachments(是否有附件)\n- subject(主题)\n- attachname(附件名称)\n- body(正文)\n- from(发件人)\n- to(收件人)\n\n示例1:\n查找 2025 年 1 月 1 日之后收到、且不在垃圾邮件或已删除文件夹中的邮件:\ndate\u003e2025-01-01T00:00:00Z AND (NOT folderId:3) AND (NOT folderId:6)\n\n示例2:\n查找发件人为 “alice” 的邮件,或者收件人为 “alice\u003ca@b.com\u003e” 且位于“已发送”文件夹中的邮件:\n(from:\"alice\") OR (to:\"alice\u003ca@b.com\u003e\" AND folderId:1)\n\n示例3:\n查找主题中包含 “test” 关键词的邮件,或者包含附件名含 “file” 关键词且发件人为 alice 的邮件:\n(subject:\"test\") OR (attachname:\"file\" AND from:alice\u003ca@b.com\u003e)", "property": "query", "required": true, "type": "string" } }, "path": "mail.search_emails", "primary_cli_path": "mail message search", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索邮件 (KQL 语法)", "use_when": [ "按主题/发件人/时间等条件搜索邮件并提取 messageId" ] }, "mail.search_mail_users": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail user search", "internal/cli/schema_command_registry.json#mail.search_mail_users", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "按姓名、工号或关键词搜索企业邮箱用户", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "列出当前用户自己的邮箱使用 mail mailbox list,搜索邮件内容使用 message search" ], "canonical_path": "mail.search_mail_users", "cli_name": "search", "cli_path": "mail user search", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "keyword", "employee-no" ] ] }, "description": "按关键词或工号搜索邮箱用户,返回匹配的用户列表及分页游标。\n\n注意:仅企业邮箱(非 @dingtalk.com 个人邮箱)可使用此功能;\n使用个人邮箱(如 xxx@dingtalk.com)调用将因无权限而报错。\n\n搜索方式(二选一):\n --keyword 按姓名/关键词搜索(当未提供 --employee-no 时为必填)\n --employee-no 按工号精确搜索;提供工号时 keyword 不再必填\n\n返回字段:\n users 匹配的用户列表,每条包含用户 ID、邮箱地址、姓名、昵称、工号、职位、工作地\n nextCursor 下一页游标,传入 --cursor 翻页\n hasMore 是否还有更多数据\n\nuser 对象字段:\n id 用户 ID\n email 展示使用的邮件地址\n name 用户名(人名)\n nickname 用户昵称(或者花名)\n employeeNo 工号\n jobTitle 职位\n workLocation 工作地\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "command-verb", "examples": [ "dws mail user search --email user@company.com --keyword \"张三\" --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "按姓名、工号或关键词搜索企业邮箱用户" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "按姓名、工号或关键词搜索企业邮箱用户" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "列出当前用户自己的邮箱使用 mail mailbox list,搜索邮件内容使用 message search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "列出当前用户自己的邮箱使用 mail mailbox list,搜索邮件内容使用 message search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail user search", "value": "mail.search_mail_users" }, { "precedence": "reviewed_manual", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "mail user search", "value": "mail.search_mail_users" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail user search", "value": "mail.search_mail_users" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "按关键词或工号搜索邮箱用户,返回匹配的用户列表及分页游标。\n\n注意:仅企业邮箱(非 @dingtalk.com 个人邮箱)可使用此功能;\n使用个人邮箱(如 xxx@dingtalk.com)调用将因无权限而报错。\n\n搜索方式(二选一):\n --keyword 按姓名/关键词搜索(当未提供 --employee-no 时为必填)\n --employee-no 按工号精确搜索;提供工号时 keyword 不再必填\n\n返回字段:\n users 匹配的用户列表,每条包含用户 ID、邮箱地址、姓名、昵称、工号、职位、工作地\n nextCursor 下一页游标,传入 --cursor 翻页\n hasMore 是否还有更多数据\n\nuser 对象字段:\n id 用户 ID\n email 展示使用的邮件地址\n name 用户名(人名)\n nickname 用户昵称(或者花名)\n employeeNo 工号\n jobTitle 职位\n workLocation 工作地\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索账号" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "按关键词或工号搜索邮箱用户,返回匹配的用户列表及分页游标。\n\n注意:仅企业邮箱(非 @dingtalk.com 个人邮箱)可使用此功能;\n使用个人邮箱(如 xxx@dingtalk.com)调用将因无权限而报错。\n\n搜索方式(二选一):\n --keyword 按姓名/关键词搜索(当未提供 --employee-no 时为必填)\n --employee-no 按工号精确搜索;提供工号时 keyword 不再必填\n\n返回字段:\n users 匹配的用户列表,每条包含用户 ID、邮箱地址、姓名、昵称、工号、职位、工作地\n nextCursor 下一页游标,传入 --cursor 翻页\n hasMore 是否还有更多数据\n\nuser 对象字段:\n id 用户 ID\n email 展示使用的邮件地址\n name 用户名(人名)\n nickname 用户昵称(或者花名)\n employeeNo 工号\n jobTitle 职位\n workLocation 工作地\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail user search --email user@company.com --keyword \"张三\" --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail user search --email user@company.com --keyword \"张三\" --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users.interface_ref", "value": { "product_id": "mail", "rpc_name": "search_mail_users" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.search_mail_users.interface_ref", "value": { "product_id": "mail", "rpc_name": "search_mail_users" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索邮箱用户" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索账号" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索邮箱用户" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要查找他人的企业邮箱地址时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要查找他人的企业邮箱地址时" ] } }, "group": "user", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "search_mail_users" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_mail_users", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor 字段", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "cursor" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor 字段" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "cursor", "property": "cursor", "required": false, "type": "string" }, "email": { "description": "搜索目标邮箱地址 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索目标邮箱地址 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "email" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索目标邮箱地址 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "email", "property": "email", "required": false, "type": "string" }, "employee-no": { "description": "按工号搜索用户;提供此参数时 keyword 不再必填", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按工号搜索用户;提供此参数时 keyword 不再必填" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按工号精确查询" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按工号搜索用户;提供此参数时 keyword 不再必填" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "employeeNo" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "employeeNo" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "command_constraint", "selected": false, "source": "require_one_of_constraint", "value": false }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按工号精确查询", "property": "employeeNo", "required": false, "type": "string" }, "keyword": { "description": "搜索关键词(未提供 --employee-no 时为必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词(未提供 --employee-no 时为必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索关键词(名字、昵称、拼音、工号、办公地点等)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词(未提供 --employee-no 时为必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "keyword" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "keyword" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "command_constraint", "selected": false, "source": "require_one_of_constraint", "value": false }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed CLI accepts either a fuzzy keyword or an exact employee number, represented by a typed require-one-of constraint rather than two unconditional requirements.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "搜索关键词(名字、昵称、拼音、工号、办公地点等)", "property": "keyword", "required": false, "type": "string" }, "limit": { "description": "每页返回数量", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "size" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "size" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "size" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "size", "interface_type": "number", "property": "size", "required": false, "type": "string" } }, "path": "mail.search_mail_users", "primary_cli_path": "mail user search", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索邮箱用户", "use_when": [ "需要查找他人的企业邮箱地址时" ] }, "mail.send_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail draft send", "internal/cli/schema_command_registry.json#mail.send_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "发送草稿箱中已有的邮件草稿", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "创建或编辑草稿分别使用 draft create 和 draft update" ], "canonical_path": "mail.send_draft", "cli_name": "send", "cli_path": "mail draft send", "confirmation": "not_required", "description": "将草稿箱中已有的草稿发送出去。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft send --from user@company.com --id \u003cmessageId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "发送草稿箱中已有的邮件草稿" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "发送草稿箱中已有的邮件草稿" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建或编辑草稿分别使用 draft create 和 draft update" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建或编辑草稿分别使用 draft create 和 draft update" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail draft send", "value": "mail.send_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail draft send", "value": "mail.send_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将草稿箱中已有的草稿发送出去。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发送草稿箱中的邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将草稿箱中已有的草稿发送出去。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft send --from user@company.com --id \u003cmessageId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft send --from user@company.com --id \u003cmessageId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "send_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "send_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "发送草稿" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发送邮件草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "发送草稿" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知草稿 messageId 且用户要求发送该草稿时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知草稿 messageId 且用户要求发送该草稿时" ] } }, "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "send_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_draft", "parameter_count": 2, "parameters": { "from": { "description": "发件人邮箱 (必填),别名: --sender", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填),别名: --sender" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填),别名: --sender" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "email" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "from" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "草稿邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "草稿邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件的唯一标识" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "草稿邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "messageId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "messageId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件的唯一标识", "property": "messageId", "required": true, "type": "string" } }, "path": "mail.send_draft", "primary_cli_path": "mail draft send", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "发送草稿", "use_when": [ "已知草稿 messageId 且用户要求发送该草稿时" ] }, "mail.send_email": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail message send", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.send_email", "internal/cli/schema_command_registry.json#mail.send_email", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.send_email", "live-dws-schema:mail.send_email", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "以指定邮箱地址发送一封邮件", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "只需创建草稿不发送时用 mail draft create", "回复/转发已有邮件时用 mail message reply / forward" ], "canonical_path": "mail.send_email", "cli_name": "send", "cli_path": "mail message send", "confirmation": "not_required", "description": "发送一封邮件到指定收件人,支持添加普通附件和内联附件(如图片)。\n\n当指定 --attachment 或 --inline-attachment 时,自动执行以下流程:\n 1. 创建草稿\n 2. 为每个普通附件(isInline=false)创建上传会话并上传文件内容\n 3. 为每个内联附件(isInline=true,自动生成 contentId)创建上传会话并上传文件内容\n 4. 发送草稿\n\n内联附件说明:\n 使用 --inline-attachment 指定内联图片(支持 jpg/jpeg/png/gif/webp/bmp/svg),CLI 自动生成 contentId(格式:inline-{文件名}-{序号}@alimail.com)\n 在 --content 中使用占位符 [inline:文件名] 引用内联图片,CLI 自动将正文转为 HTML 并注入 \u003cimg\u003e 标签\n 若 content 中无对应占位符,内联图片会自动追加到正文末尾\n 注意:仅支持图片类型作为内联附件,视频、音频、PDF 等文件请改用 --attachment\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成...\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "以指定邮箱地址发送一封邮件" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "以指定邮箱地址发送一封邮件" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_email.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需创建草稿不发送时用 mail draft create", "回复/转发已有邮件时用 mail message reply / forward" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "只需创建草稿不发送时用 mail draft create", "回复/转发已有邮件时用 mail message reply / forward" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail message send", "value": "mail.send_email" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail message send", "value": "mail.send_email" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "发送一封邮件到指定收件人,支持添加普通附件和内联附件(如图片)。\n\n当指定 --attachment 或 --inline-attachment 时,自动执行以下流程:\n 1. 创建草稿\n 2. 为每个普通附件(isInline=false)创建上传会话并上传文件内容\n 3. 为每个内联附件(isInline=true,自动生成 contentId)创建上传会话并上传文件内容\n 4. 发送草稿\n\n内联附件说明:\n 使用 --inline-attachment 指定内联图片(支持 jpg/jpeg/png/gif/webp/bmp/svg),CLI 自动生成 contentId(格式:inline-{文件名}-{序号}@alimail.com)\n 在 --content 中使用占位符 [inline:文件名] 引用内联图片,CLI 自动将正文转为 HTML 并注入 \u003cimg\u003e 标签\n 若 content 中无对应占位符,内联图片会自动追加到正文末尾\n 注意:仅支持图片类型作为内联附件,视频、音频、PDF 等文件请改用 --attachment\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "使用指定的Email地址作为发件人发送一封邮件。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "发送一封邮件到指定收件人,支持添加普通附件和内联附件(如图片)。\n\n当指定 --attachment 或 --inline-attachment 时,自动执行以下流程:\n 1. 创建草稿\n 2. 为每个普通附件(isInline=false)创建上传会话并上传文件内容\n 3. 为每个内联附件(isInline=true,自动生成 contentId)创建上传会话并上传文件内容\n 4. 发送草稿\n\n内联附件说明:\n 使用 --inline-attachment 指定内联图片(支持 jpg/jpeg/png/gif/webp/bmp/svg),CLI 自动生成 contentId(格式:inline-{文件名}-{序号}@alimail.com)\n 在 --content 中使用占位符 [inline:文件名] 引用内联图片,CLI 自动将正文转为 HTML 并注入 \u003cimg\u003e 标签\n 若 content 中无对应占位符,内联图片会自动追加到正文末尾\n 注意:仅支持图片类型作为内联附件,视频、音频、PDF 等文件请改用 --attachment\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成...\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail message send --from user@company.com --to colleague@company.com --subject \"周报\" --content \"本周完成...\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_email.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "send_email" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.send_email.interface_ref", "value": "mail.send_email" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "send_email" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "发送邮件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发送邮件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "发送邮件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "用户明确要发邮件,且已确认发件人邮箱、收件人、主题与正文" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工依据实时 dws schema(或 Skill/Cobra/pinned MCP 对照)决策化选型文案与门禁;不改写命令身份与参数契约;示例不含 --yes。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "用户明确要发邮件,且已确认发件人邮箱、收件人、主题与正文" ] } }, "group": "message", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "send_email" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "send_email", "parameter_count": 7, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "抄送人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "抄送人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "抄送人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "ccRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cc" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "ccRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件正文 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件正文 (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": true, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "邮件标题 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件标题 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件标题 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": true, "type": "string" }, "to": { "description": "收件人列表 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "收件人列表 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "收件人列表 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": true, "type": "string" } }, "path": "mail.send_email", "primary_cli_path": "mail message send", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "发送邮件", "use_when": [ "用户明确要发邮件,且已确认发件人邮箱、收件人、主题与正文" ] }, "mail.shortcut_contact_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +contact-list", "cobra-help:dws mail +contact-list", "internal/cli/schema_command_registry.json#mail.shortcut_contact_list", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出指定邮箱的所有邮件联系人", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_contact_list", "cli_name": "+contact-list", "cli_path": "mail +contact-list", "confirmation": "not_required", "description": "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +contact-list --email user@company.com --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的所有邮件联系人" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的所有邮件联系人" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +contact-list", "value": "mail.shortcut_contact_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +contact-list", "value": "mail.shortcut_contact_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +contact-list --email user@company.com --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +contact-list --email user@company.com --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱的所有邮件联系人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱的所有邮件联系人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_contact_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "limit", "required": true, "type": "string" } }, "path": "mail.shortcut_contact_list", "primary_cli_path": "mail +contact-list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出指定邮箱的所有邮件联系人", "use_when": [ "当你想查看某邮箱通讯录里有哪些联系人、或需要取得联系人 ID 以便更新或删除时使用;传入邮箱和每页数量,返回联系人列表,支持分页。" ] }, "mail.shortcut_find_mail_user": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +find-mail-user", "cobra-help:dws mail +find-mail-user", "internal/cli/schema_command_registry.json#mail.shortcut_find_mail_user", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_find_mail_user", "cli_name": "+find-mail-user", "cli_path": "mail +find-mail-user", "confirmation": "not_required", "description": "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +find-mail-user --query \"张三\"", "dws mail +find-mail-user --query alice --limit 10" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +find-mail-user", "value": "mail.shortcut_find_mail_user" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +find-mail-user", "value": "mail.shortcut_find_mail_user" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +find-mail-user --query \"张三\"", "dws mail +find-mail-user --query alice --limit 10" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +find-mail-user --query \"张三\"", "dws mail +find-mail-user --query alice --limit 10" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_find_mail_user", "parameter_count": 2, "parameters": { "limit": { "description": "返回条数上限(可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回条数上限(可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回条数上限(可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词(姓名/花名/邮箱片段,必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词(姓名/花名/邮箱片段,必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词(姓名/花名/邮箱片段,必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "query", "required": true, "type": "string" } }, "path": "mail.shortcut_find_mail_user", "primary_cli_path": "mail +find-mail-user", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "按关键词搜索邮箱联系人并投影列表(姓名/昵称/邮箱/工号等)", "use_when": [ "当你只知道某人的姓名、花名或邮箱片段,想在企业邮箱通讯录里按关键词把匹配的邮箱用户找出来、并只看一份精简清单(姓名、昵称、邮箱地址、工号、职位、工作地)而不想拿到一大坨原始字段时使用;内部按 --query 关键词调用邮箱用户搜索,再在本地把每个匹配用户投影成整洁记录打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改任何数据;注意仅企业邮箱可用(个人邮箱如 xxx@dingtalk.com 会因无权限报错);若没有命中则提示「没搜到邮箱联系人」。" ] }, "mail.shortcut_folder_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +folder-list", "cobra-help:dws mail +folder-list", "internal/cli/schema_command_registry.json#mail.shortcut_folder_list", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出顶层文件夹或指定父文件夹下的子文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_folder_list", "cli_name": "+folder-list", "cli_path": "mail +folder-list", "confirmation": "not_required", "description": "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +folder-list --email user@company.com" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出顶层文件夹或指定父文件夹下的子文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出顶层文件夹或指定父文件夹下的子文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +folder-list", "value": "mail.shortcut_folder_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +folder-list", "value": "mail.shortcut_folder_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +folder-list --email user@company.com" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +folder-list --email user@company.com" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出顶层文件夹或指定父文件夹下的子文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出顶层文件夹或指定父文件夹下的子文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_folder_list", "parameter_count": 2, "parameters": { "email": { "description": "邮件所属邮箱地址(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" }, "folder": { "description": "父文件夹 ID,不传则返回顶层文件夹", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父文件夹 ID,不传则返回顶层文件夹" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父文件夹 ID,不传则返回顶层文件夹" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" } }, "path": "mail.shortcut_folder_list", "primary_cli_path": "mail +folder-list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出顶层文件夹或指定父文件夹下的子文件夹", "use_when": [ "当你需要了解某个邮箱有哪些文件夹、或要取得文件夹 ID 以便移动邮件、按文件夹列信/建规则时使用;传入邮箱(可选父文件夹 ID 查子级),返回文件夹列表及其 ID。" ] }, "mail.shortcut_recent_mail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +recent-mail", "cobra-help:dws mail +recent-mail", "internal/cli/schema_command_registry.json#mail.shortcut_recent_mail", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_recent_mail", "cli_name": "+recent-mail", "cli_path": "mail +recent-mail", "confirmation": "not_required", "description": "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +recent-mail", "dws mail +recent-mail --limit 30" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +recent-mail", "value": "mail.shortcut_recent_mail" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +recent-mail", "value": "mail.shortcut_recent_mail" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +recent-mail", "dws mail +recent-mail --limit 30" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +recent-mail", "dws mail +recent-mail --limit 30" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_recent_mail", "parameter_count": 3, "parameters": { "email": { "description": "要查看的邮箱地址(可选,默认取你绑定的第一个邮箱)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要查看的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要查看的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": false, "type": "string" }, "folder": { "description": "文件夹 ID(可选,默认定位收件箱)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件夹 ID(可选,默认定位收件箱)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件夹 ID(可选,默认定位收件箱)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" }, "limit": { "description": "返回会话条数上限(可选,默认 20,最大 100)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回会话条数上限(可选,默认 20,最大 100)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回会话条数上限(可选,默认 20,最大 100)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" } }, "path": "mail.shortcut_recent_mail", "primary_cli_path": "mail +recent-mail", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出收件箱近期邮件会话并投影列表(主题/发件人/时间/threadId)", "use_when": [ "当你想快速看一眼自己邮箱里近期的邮件会话(收件箱线程/conversation),只需要一份精简清单(主题、发件人、最后修改时间、会话 threadId)、而不想翻完整正文或原始字段时使用;内部先确定要看的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再解析要看的文件夹——你可以用 --folder 指定文件夹 ID,不指定时自动定位收件箱——然后列出该文件夹下的近期会话,最后在本地把每条会话投影成 {subject, from, date, threadId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做列举与本地投影,不会修改、发送或删除任何邮件;若最近没有邮件则提示「最近没有邮件」。" ] }, "mail.shortcut_search_mail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +search-mail", "cobra-help:dws mail +search-mail", "internal/cli/schema_command_registry.json#mail.shortcut_search_mail", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_search_mail", "cli_name": "+search-mail", "cli_path": "mail +search-mail", "confirmation": "not_required", "description": "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +search-mail --query \"subject:周报\"", "dws mail +search-mail --query \"from:alice AND date\u003e2025-06-01T00:00:00Z\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +search-mail", "value": "mail.shortcut_search_mail" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +search-mail", "value": "mail.shortcut_search_mail" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +search-mail --query \"subject:周报\"", "dws mail +search-mail --query \"from:alice AND date\u003e2025-06-01T00:00:00Z\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +search-mail --query \"subject:周报\"", "dws mail +search-mail --query \"from:alice AND date\u003e2025-06-01T00:00:00Z\"" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_search_mail", "parameter_count": 3, "parameters": { "email": { "description": "要搜索的邮箱地址(可选,默认取你绑定的第一个邮箱)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要搜索的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要搜索的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": false, "type": "string" }, "query": { "description": "KQL 搜索表达式(如 subject:周报、from:alice、folderId:2)(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "KQL 搜索表达式(如 subject:周报、from:alice、folderId:2)(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "KQL 搜索表达式(如 subject:周报、from:alice、folderId:2)(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "query", "required": true, "type": "string" }, "size": { "description": "返回条数上限(可选,默认 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回条数上限(可选,默认 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回条数上限(可选,默认 20)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "size" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "size" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "size", "required": false, "type": "string" } }, "path": "mail.shortcut_search_mail", "primary_cli_path": "mail +search-mail", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "按 KQL 关键词搜索邮件并投影列表(主题/发件人/时间/messageId)", "use_when": [ "当你想按关键词(KQL 表达式,如 subject:周报、from:alice、hasAttachments:true、folderId:2 等)快速搜自己的邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要搜的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再执行邮件搜索,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会修改、发送或删除任何邮件;若没有命中则返回空列表。" ] }, "mail.shortcut_tag_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +tag-list", "cobra-help:dws mail +tag-list", "internal/cli/schema_command_registry.json#mail.shortcut_tag_list", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出指定邮箱下的所有邮件标签", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_tag_list", "cli_name": "+tag-list", "cli_path": "mail +tag-list", "confirmation": "not_required", "description": "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +tag-list --email user@company.com" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱下的所有邮件标签" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱下的所有邮件标签" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +tag-list", "value": "mail.shortcut_tag_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +tag-list", "value": "mail.shortcut_tag_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +tag-list --email user@company.com" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +tag-list --email user@company.com" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱下的所有邮件标签" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱下的所有邮件标签" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_tag_list", "parameter_count": 1, "parameters": { "email": { "description": "用户的邮箱地址(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户的邮箱地址(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户的邮箱地址(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" } }, "path": "mail.shortcut_tag_list", "primary_cli_path": "mail +tag-list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出指定邮箱下的所有邮件标签", "use_when": [ "当你要查看邮箱里有哪些标签、或需要取得标签 ID 以便给邮件/会话加标签时使用;传入邮箱地址,返回全部邮件标签及其 ID。" ] }, "mail.shortcut_template_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +template-list", "cobra-help:dws mail +template-list", "internal/cli/schema_command_registry.json#mail.shortcut_template_list", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出指定邮箱的所有邮件模板", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_template_list", "cli_name": "+template-list", "cli_path": "mail +template-list", "confirmation": "not_required", "description": "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +template-list --email user@company.com --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的所有邮件模板" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱的所有邮件模板" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +template-list", "value": "mail.shortcut_template_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +template-list", "value": "mail.shortcut_template_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +template-list --email user@company.com --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +template-list --email user@company.com --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱的所有邮件模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱的所有邮件模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_template_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" }, "limit": { "description": "每页返回数量(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "limit", "required": true, "type": "string" } }, "path": "mail.shortcut_template_list", "primary_cli_path": "mail +template-list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出指定邮箱的所有邮件模板", "use_when": [ "当你想查看某个邮箱下已有哪些邮件模板、或需要取得模板 ID 以便查看详情或更新时使用;传入邮箱和每页数量,返回模板列表,支持分页。" ] }, "mail.shortcut_thread_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +thread-list", "cobra-help:dws mail +thread-list", "internal/cli/schema_command_registry.json#mail.shortcut_thread_list", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出指定邮箱文件夹下的邮件会话(thread)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_thread_list", "cli_name": "+thread-list", "cli_path": "mail +thread-list", "confirmation": "not_required", "description": "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +thread-list --email user@company.com --folder 104 --limit 20" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱文件夹下的邮件会话(thread)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出指定邮箱文件夹下的邮件会话(thread)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +thread-list", "value": "mail.shortcut_thread_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +thread-list", "value": "mail.shortcut_thread_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +thread-list --email user@company.com --folder 104 --limit 20" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +thread-list --email user@company.com --folder 104 --limit 20" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出指定邮箱文件夹下的邮件会话(thread)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出指定邮箱文件夹下的邮件会话(thread)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_thread_list", "parameter_count": 7, "parameters": { "ascending": { "description": "是否按时间升序", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否按时间升序" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否按时间升序" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "ascending" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "ascending" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "property": "ascending", "required": false, "type": "boolean" }, "cursor": { "description": "分页游标,首次请求可不传", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,首次请求可不传" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,首次请求可不传" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "email": { "description": "会话所属邮箱地址(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "会话所属邮箱地址(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "会话所属邮箱地址(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": true, "type": "string" }, "end": { "description": "结束 UTC 时间,如 2024-12-31T23:59:59Z", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "结束 UTC 时间,如 2024-12-31T23:59:59Z" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "结束 UTC 时间,如 2024-12-31T23:59:59Z" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "end" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "end" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "end", "required": false, "type": "string" }, "folder": { "description": "邮件文件夹 ID(不是文件夹名称)(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件文件夹 ID(不是文件夹名称)(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件文件夹 ID(不是文件夹名称)(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": true, "type": "string" }, "limit": { "default": "20", "description": "本次列出的会话数,最大 100", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本次列出的会话数,最大 100" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本次列出的会话数,最大 100" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" }, "start": { "description": "开始 UTC 时间,如 2024-01-01T00:00:00Z", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "开始 UTC 时间,如 2024-01-01T00:00:00Z" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "开始 UTC 时间,如 2024-01-01T00:00:00Z" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "start" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "start" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "start", "required": false, "type": "string" } }, "path": "mail.shortcut_thread_list", "primary_cli_path": "mail +thread-list", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出指定邮箱文件夹下的邮件会话(thread)", "use_when": [ "当你想按会话(同一往来主题的邮件串)而非单封邮件来浏览某个文件夹时使用;传入邮箱和文件夹 ID,可按时间范围和升降序筛选,返回会话列表及其 conversationId,供 +thread 查看详情。" ] }, "mail.shortcut_unread_mail": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +unread-mail", "cobra-help:dws mail +unread-mail", "internal/cli/schema_command_registry.json#mail.shortcut_unread_mail", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "列出未读邮件并投影列表(主题/发件人/时间/messageId)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_unread_mail", "cli_name": "+unread-mail", "cli_path": "mail +unread-mail", "confirmation": "not_required", "description": "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +unread-mail", "dws mail +unread-mail --email user@company.com" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "列出未读邮件并投影列表(主题/发件人/时间/messageId)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "列出未读邮件并投影列表(主题/发件人/时间/messageId)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +unread-mail", "value": "mail.shortcut_unread_mail" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +unread-mail", "value": "mail.shortcut_unread_mail" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +unread-mail", "dws mail +unread-mail --email user@company.com" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +unread-mail", "dws mail +unread-mail --email user@company.com" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出未读邮件并投影列表(主题/发件人/时间/messageId)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出未读邮件并投影列表(主题/发件人/时间/messageId)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_unread_mail", "parameter_count": 2, "parameters": { "email": { "description": "要查询的邮箱地址(可选,默认取你绑定的第一个邮箱)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要查询的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要查询的邮箱地址(可选,默认取你绑定的第一个邮箱)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": false, "type": "string" }, "size": { "description": "返回条数上限(可选,默认 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回条数上限(可选,默认 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回条数上限(可选,默认 20)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "size" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "size" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "size", "required": false, "type": "string" } }, "path": "mail.shortcut_unread_mail", "primary_cli_path": "mail +unread-mail", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "列出未读邮件并投影列表(主题/发件人/时间/messageId)", "use_when": [ "当你想快速看自己邮箱里有哪些未读邮件、并只看一份精简清单(主题、发件人、时间、邮件 messageId)而不想翻完整正文时使用;内部先确定要查的邮箱地址——你可以用 --email 指定,不指定时自动取你绑定的第一个邮箱——再用 KQL 过滤条件 isRead:false 搜索未读邮件,最后在本地把每封邮件投影成 {subject, from, date, messageId} 打印出来,可配合 --format/--jq/--fields。这是纯只读操作,只做搜索与本地投影,不会把邮件标记为已读,也不会修改、发送或删除任何邮件;若没有未读邮件则返回空列表。" ] }, "mail.shortcut_user_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:mail +user-search", "cobra-help:dws mail +user-search", "internal/cli/schema_command_registry.json#mail.shortcut_user_search", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json" ], "agent_summary": "按关键词或工号搜索邮箱用户(仅企业邮箱)", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "mail.shortcut_user_search", "cli_name": "+user-search", "cli_path": "mail +user-search", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "keyword", "employee-no" ] ] }, "description": "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。\n\n参数约束:\n - --keyword、--employee-no 至少指定一个", "display": "邮箱 / 邮件收发", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws mail +user-search --keyword \"张三\"", "dws mail +user-search --email user@company.com --employee-no \"E123456\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "按关键词或工号搜索邮箱用户(仅企业邮箱)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": "按关键词或工号搜索邮箱用户(仅企业邮箱)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail +user-search", "value": "mail.shortcut_user_search" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail +user-search", "value": "mail.shortcut_user_search" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。\n\n参数约束:\n - --keyword、--employee-no 至少指定一个" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。\n\n参数约束:\n - --keyword、--employee-no 至少指定一个" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +user-search --keyword \"张三\"", "dws mail +user-search --email user@company.com --employee-no \"E123456\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail +user-search --keyword \"张三\"", "dws mail +user-search --email user@company.com --employee-no \"E123456\"" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/mail.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "按关键词或工号搜索邮箱用户(仅企业邮箱)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "按关键词或工号搜索邮箱用户(仅企业邮箱)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/mail.json", "value": [ "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_user_search", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标,取自响应中的 nextCursor", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,取自响应中的 nextCursor" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "email": { "description": "搜索目标邮箱地址", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索目标邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索目标邮箱地址" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "email", "required": false, "type": "string" }, "employee-no": { "description": "按工号精确搜索", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按工号精确搜索" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按工号精确搜索" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "employeeNo" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "employeeNo" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "employeeNo", "required": false, "type": "string" }, "keyword": { "description": "搜索关键词(未提供 --employee-no 时为必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词(未提供 --employee-no 时为必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词(未提供 --employee-no 时为必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "keyword" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "keyword" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "keyword", "required": false, "type": "string" }, "limit": { "description": "每页返回数量", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "limit", "required": false, "type": "string" } }, "path": "mail.shortcut_user_search", "primary_cli_path": "mail +user-search", "product_id": "mail", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "按关键词或工号搜索邮箱用户(仅企业邮箱)", "use_when": [ "当你只知道同事的姓名或工号、需要查出其企业邮箱地址以便发信或添加联系人时使用;提供关键词或工号(至少其一),返回匹配的企业邮箱用户列表。" ] }, "mail.update_draft": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail draft update", "internal/cli/schema_command_registry.json#mail.update_draft", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "更新已有邮件草稿的内容", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "已发送邮件不能用草稿更新" ], "canonical_path": "mail.update_draft", "cli_name": "update", "cli_path": "mail draft update", "confirmation": "not_required", "description": "更新草稿箱中已有草稿的内容,支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿更新与附件上传,草稿保留在草稿箱(不发送)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --subject \"新标题\" --content \"新正文\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新已有邮件草稿的内容" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新已有邮件草稿的内容" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已发送邮件不能用草稿更新" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已发送邮件不能用草稿更新" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail draft update", "value": "mail.update_draft" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail draft update", "value": "mail.update_draft" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新草稿箱中已有草稿的内容,支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿更新与附件上传,草稿保留在草稿箱(不发送)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新邮件草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新草稿箱中已有草稿的内容,支持添加普通附件和内联图片。\n\n指定 --attachment 或 --inline-attachment 时,CLI 自动完成草稿更新与附件上传,草稿保留在草稿箱(不发送)。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --subject \"新标题\" --content \"新正文\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail draft update --from user@company.com --id \u003cmessageId\u003e --subject \"新标题\" --content \"新正文\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_draft" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_draft.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_draft" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新草稿" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新邮件草稿" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新草稿" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知草稿 messageId 并需要修改主题、正文或收件人时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知草稿 messageId 并需要修改主题、正文或收件人时" ] } }, "group": "draft", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_draft" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_draft", "parameter_count": 8, "parameters": { "attachment": { "description": "附件文件路径,可多次指定 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件文件路径,可多次指定 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "attachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "cc": { "description": "抄送人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "抄送人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "抄送人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "抄送人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "ccRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cc" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "ccRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "邮件正文", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件正文" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件正文" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "from": { "description": "发件人邮箱 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "发件人邮箱 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": true, "type": "string" }, "id": { "description": "草稿邮件 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "草稿邮件 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "待更新的邮件id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "草稿邮件 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "待更新的邮件id", "property": "id", "required": true, "type": "string" }, "inline-attachment": { "description": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内联附件文件路径(如图片),可多次指定,cid 自动生成 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "reviewed local inline-attachment preprocessing input", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "inlineAttachment" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "reviewed local inline-attachment preprocessing input", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "subject": { "description": "邮件标题", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件标题" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件标题" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "收件人列表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "收件人列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "收件人列表" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.update_draft", "primary_cli_path": "mail draft update", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新草稿", "use_when": [ "已知草稿 messageId 并需要修改主题、正文或收件人时" ] }, "mail.update_mail_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail folder update", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.mail.prod.json#mail.update_mail_folder", "internal/cli/schema_command_registry.json#mail.update_mail_folder", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.update_mail_folder", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "重命名指定邮件文件夹", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "创建或删除文件夹使用对应命令" ], "canonical_path": "mail.update_mail_folder", "cli_name": "update", "cli_path": "mail folder update", "confirmation": "not_required", "description": "更新指定邮箱下邮件文件夹的名称。\n\n注意:--id 需要填写要更新的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 更新结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "重命名指定邮件文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "重命名指定邮件文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_mail_folder.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建或删除文件夹使用对应命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建或删除文件夹使用对应命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail folder update", "value": "mail.update_mail_folder" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail folder update", "value": "mail.update_mail_folder" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新指定邮箱下邮件文件夹的名称。\n\n注意:--id 需要填写要更新的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 更新结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "该工具支持修改指定邮箱下邮件文件夹的名称。需要传入要更新的文件夹 ID 和新名称。文件夹 ID 可通过列出邮件文件夹获得,不要把文件夹名称当作 ID。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新指定邮箱下邮件文件夹的名称。\n\n注意:--id 需要填写要更新的文件夹 ID,不是文件夹名称。文件夹 ID 可通过 dws mail folder list 获取。\n\n返回字段:\n success 是否成功\n result 更新结果,成功时为空对象\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail folder update --email user@company.com --id \u003cfolderId\u003e --name \"新文件夹名\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_mail_folder.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "update_mail_folder" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_mail_folder.interface_ref", "value": "mail.update_mail_folder" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "mail", "rpc_name": "update_mail_folder" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新邮件文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新邮件文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新邮件文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 folderId 并需要修改文件夹名称时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 folderId 并需要修改文件夹名称时" ] } }, "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_mail_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_mail_folder", "parameter_count": 3, "parameters": { "email": { "description": "邮件所属邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件所属的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "邮件所属邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件所属的邮箱地址", "property": "email", "required": true, "type": "string" }, "id": { "description": "要更新的邮件文件夹 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要更新的邮件文件夹 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要更新的邮件文件夹 ID,不是文件夹名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要更新的邮件文件夹 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要更新的邮件文件夹 ID,不是文件夹名称", "property": "id", "required": true, "type": "string" }, "name": { "description": "更新后的邮件文件夹名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "更新后的邮件文件夹名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新后的邮件文件夹名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "更新后的邮件文件夹名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "更新后的邮件文件夹名称", "property": "name", "required": true, "type": "string" } }, "path": "mail.update_mail_folder", "primary_cli_path": "mail folder update", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新邮件文件夹", "use_when": [ "已知 folderId 并需要修改文件夹名称时" ] }, "mail.update_user_mail_contact": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail contact update", "internal/cli/schema_command_registry.json#mail.update_user_mail_contact", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "更新个人邮件联系人的资料", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "企业通讯录资料不能通过此命令修改" ], "canonical_path": "mail.update_user_mail_contact", "cli_name": "update", "cli_path": "mail contact update", "confirmation": "not_required", "description": "更新已有邮件联系人的信息。仅传入需要更新的字段即可。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --display-name \"李四\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新个人邮件联系人的资料" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新个人邮件联系人的资料" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "企业通讯录资料不能通过此命令修改" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "企业通讯录资料不能通过此命令修改" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail contact update", "value": "mail.update_user_mail_contact" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail contact update", "value": "mail.update_user_mail_contact" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新已有邮件联系人的信息。仅传入需要更新的字段即可。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "修改用户邮箱联系人信息" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新已有邮件联系人的信息。仅传入需要更新的字段即可。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --display-name \"李四\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail contact update --email user@company.com --contact-id \u003ccontactId\u003e --display-name \"李四\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_user_mail_contact" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_mail_contact.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_user_mail_contact" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/mail marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新邮件联系人" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "update_user_mail_contact" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新邮件联系人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 contactId 并需要改显示名或邮箱信息时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 contactId 并需要改显示名或邮箱信息时" ] } }, "group": "contact", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_user_mail_contact" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_user_mail_contact", "parameter_count": 7, "parameters": { "contact-email": { "description": "联系人邮箱地址 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人邮箱地址 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "contactEmail" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人邮箱地址 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "contactEmail" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "contactEmail" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "contactEmail", "property": "contactEmail", "required": false, "type": "string" }, "contact-id": { "description": "联系人唯一标识 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人唯一标识 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要修改的联系人 id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人唯一标识 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "contactId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "contactId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要修改的联系人 id", "property": "contactId", "required": true, "type": "string" }, "display-name": { "description": "联系人显示名称 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人显示名称 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "displayName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人显示名称 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "displayName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "displayName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "displayName", "property": "displayName", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "first-name": { "description": "联系人名 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人名 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "firstName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人名 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "firstName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "firstName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "firstName", "property": "firstName", "required": false, "type": "string" }, "last-name": { "description": "联系人姓 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人姓 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "lastName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人姓 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "lastName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "lastName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "lastName", "property": "lastName", "required": false, "type": "string" }, "middle-name": { "description": "联系人中间名 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "联系人中间名 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "middleName" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "联系人中间名 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "middleName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "middleName" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "middleName", "property": "middleName", "required": false, "type": "string" } }, "path": "mail.update_user_mail_contact", "primary_cli_path": "mail contact update", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新邮件联系人", "use_when": [ "已知 contactId 并需要改显示名或邮箱信息时" ] }, "mail.update_user_message_template": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws mail template update", "internal/cli/schema_command_registry.json#mail.update_user_message_template", "internal/cli/schema_hints/metadata/mail.json", "internal/cli/schema_hints/selection/mail.json", "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template", "skills/mono/SKILL.md", "skills/mono/references/products/mail.md" ], "agent_summary": "更新已有邮件模板的内容", "agent_summary_source": "dws-agent-selection/mail", "availability": "available", "avoid_when": [ "创建新模板时使用 mail template create" ], "canonical_path": "mail.update_user_message_template", "cli_name": "update", "cli_path": "mail template update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "from", "subject", "content", "name", "to", "cc" ] ] }, "description": "更新已有邮件模板的内容。仅传入需要更新的字段即可。\n\n注意: 邮箱服务端仅支持更新草稿模板 (创建时带 --is-draft);\n非草稿模板不可修改 (服务端返回 Invalid parameter),只能删除后重建。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作", "display": "邮箱 / 邮件收发", "effect": "write", "effect_source": "command-verb", "examples": [ "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --subject \"新标题\" --content \"新正文\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新已有邮件模板的内容" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": "更新已有邮件模板的内容" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建新模板时使用 mail template create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "创建新模板时使用 mail template create" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "mail template update", "value": "mail.update_user_message_template" }, { "precedence": "reviewed_manual", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "mail template update", "value": "mail.update_user_message_template" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "mail template update", "value": "mail.update_user_message_template" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新已有邮件模板的内容。仅传入需要更新的字段即可。\n\n注意: 邮箱服务端仅支持更新草稿模板 (创建时带 --is-draft);\n非草稿模板不可修改 (服务端返回 Invalid parameter),只能删除后重建。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新用户邮件模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新已有邮件模板的内容。仅传入需要更新的字段即可。\n\n注意: 邮箱服务端仅支持更新草稿模板 (创建时带 --is-draft);\n非草稿模板不可修改 (服务端返回 Invalid parameter),只能删除后重建。\n\n错误说明:\n domain.notFound 该用户的邮箱不是由钉钉邮箱托管,无法完成操作" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --subject \"新标题\" --content \"新正文\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "dws mail template update --email user@company.com --id \u003ctemplateId\u003e --subject \"新标题\" --content \"新正文\"" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_user_message_template" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.mail.update_user_message_template.interface_ref", "value": { "product_id": "mail", "rpc_name": "update_user_message_template" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": false, "source": "internal/cli/schema_hints/selection/mail.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "internal/cli/schema_hints/metadata/mail.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新邮件模板" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "update_user_message_template" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新邮件模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "selected": true, "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 并需要修改名称、主题、正文或收件人时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "AI 生成并复核的 Agent 选择语义,依据精确 CommandRegistry identity、真实 Cobra help 与产品参考,不改写执行、安全或接口事实。", "source": "internal/cli/schema_hints/selection/mail.json", "value": [ "已知 templateId 并需要修改名称、主题、正文或收件人时" ] } }, "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "mail", "rpc_name": "update_user_message_template" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_user_message_template", "parameter_count": 8, "parameters": { "cc": { "description": "模板抄送人列表,逗号分隔 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板抄送人列表,逗号分隔 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "抄送人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板抄送人列表,逗号分隔 (可选)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "ccRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cc" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "ccRecipients" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "抄送人Email地址列表", "interface_type": "array", "property": "ccRecipients", "required": false, "type": "string" }, "content": { "description": "模板邮件正文 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板邮件正文 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "markdown格式的邮件正文内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板邮件正文 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "body" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "body" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "command_constraint", "selected": false, "source": "require_one_of_constraint", "value": false }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "markdown格式的邮件正文内容", "property": "body", "required": false, "type": "string" }, "email": { "description": "用户邮箱地址 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用户的邮箱地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户邮箱地址 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "email" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "email" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "用户的邮箱地址", "property": "email", "required": true, "type": "string" }, "from": { "description": "模板发件人邮箱 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板发件人邮箱 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "发信Email地址" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板发件人邮箱 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "from" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "from" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "发信Email地址", "property": "from", "required": false, "type": "string" }, "id": { "description": "模板唯一标识 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "模板id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板唯一标识 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "id" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "id" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "模板id", "property": "id", "required": true, "type": "string" }, "name": { "description": "模板名称 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板名称 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "名称" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板名称 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "command_constraint", "selected": false, "source": "require_one_of_constraint", "value": false }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "名称", "property": "name", "required": false, "type": "string" }, "subject": { "description": "模板邮件标题 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板邮件标题 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "邮件主题" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板邮件标题 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "subject" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "subject" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "command_constraint", "selected": false, "source": "require_one_of_constraint", "value": false }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed patch command accepts any non-empty subset of mutable template fields; a typed require-one-of constraint owns that requirement.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "邮件主题", "property": "subject", "required": false, "type": "string" }, "to": { "description": "模板收件人列表,逗号分隔 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板收件人列表,逗号分隔 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "收件人Email地址列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板收件人列表,逗号分隔 (可选)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "toRecipients" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "to" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "toRecipients" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "收件人Email地址列表", "interface_type": "array", "property": "toRecipients", "required": false, "type": "string" } }, "path": "mail.update_user_message_template", "primary_cli_path": "mail template update", "product_id": "mail", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新邮件模板", "use_when": [ "已知 templateId 并需要修改名称、主题、正文或收件人时" ] } } }