Agent Mail 邮件发送助手
将以下提示词粘贴到你的 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,希望把本地文件附带上邮件。