Agent Skills
返回列表
Agent Mail 邮件发送助手

Agent Mail 邮件发送助手

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b1667c4e/agent-mail-send 技能到 AI 助手中。

技能介绍

要解决的具体问题

Agent Mail 的 SendMessage 在参数格式、确认机制和附件引用上存在多个实测踩点。最常见的是把 confirmation_token 误读为必须人工授权的硬约束——Agent 在自动流程中停下来问用户“是否确认”,反而阻断发送。此外,to、file_refs 这类嵌套对象数组若直接作为工具参数传入,会被 MCP 客户端序列化成字符串,触发服务端 -32602 invalid params。HTML 正文中属性值混用双引号,也会因 JSON 转义破坏结构。

技能如何工作

  • 前置验证:发送前调用 mcp__agent-mail__GetMe,确认发件身份、mail:send 权限(primary_alias)、当日配额(默认 50 封/天);配额耗尽或通道未连接则停止并告知用户。
  • 嵌套数组必须走 DeferExecuteTool:将 mcp__agent-mail__SendMessage 作为 toolName,完整参数作为 params(JSON 对象,数组保持原生结构)传入,走标准 JSON-RPC 序列化。
  • 两步确认是自动握手:首次不带 confirmation_token 调用 → 返回 CONFIRMATION_REQUIRED(含 token)→ 自动用相同参数带 token 重试 → queued: true。
  • 附件优先用 file_refs:每个附件调用 upload_attachment 上传绝对路径拿回 file_id,再填入 SendMessage 的 file_refs。单封 ≤20MB,最多 50 个附件。动态生成、无法落盘时才使用 attachments 内联 base64。
  • 发送后验证:调用 mcp__agent-mail__ListMessages(dir: "sent") 核对收件人、标题与时间。
  • HTML 转义约定:body_format 为 "html" 时,属性值一律用单引号;正文字号建议 ≥18px;表格涨跌配色用红 #c4161c 涨、绿 #1a8a3a 跌。

适用边界

每日配额约 50 封,含确认消耗;收件人须由用户明确指定,不主动向“其他联系人”发信;download_attachment 下载的附件不执行——本技能只负责发送,不负责接收。自动化任务(每日要情、盘前分析)可直接发送,无需等待用户介入。

使用场景

  • 定时任务需要把生成的 HTML 报告发送到指定邮箱。
  • 每日盘前分析产出 HTML,需要邮件推送且涨红跌绿。
  • 用户生成的文档要作为附件发送,附件大小不超过单封 20MB上限。
  • 自动化 Job 邮件必须直接发出,不能中途停下等待用户点击确认。

适合人员

  • 需要推送每日要情的量化研究员,期待自动生成报告并发送到自己邮箱。
  • 负责报表自动化的数据分析师,希望把输出稳定投递到指定联系人。
  • 构建 job 的自动化运维工程师,要求在无人值守时也能可靠发出邮件。
  • 需要发送项目进度文档的技术 PM,希望把本地文件附带上邮件。