用途:该技能用于通过 Twilio SendGrid 发送应用触发的事务性邮件,并诊断投递情况,包括退信、垃圾邮件投诉和签名事件 Webhook 验证。仅针对 SendGrid 一家服务商,营销活动、模板构建器和其他服务商不在范围内。
主要能力:附带 scripts/email-cli,一个面向智能体、仅用标准库的 CLI,封装 SendGrid v3 API,并内置 ECDSA P-256 签名验证器,无第三方加密依赖。支持发送邮件、查询退信与垃圾邮件投诉、验证 Webhook 签名。
使用方式:读取操作有界,默认 --limit 20、最大 100。发送前必须先用 --dry-run 预览,再用 --yes 确认;缺少二者脚本会以退出码 1 拒绝且不调用 API。发送成功返回 202 与 x-message-id。Webhook 验证需提供原始请求体、签名头、时间戳和公钥文件,时间戳默认 300 秒窗口。退出码:0 成功,1 API 错误或验证失败,2 用法错误。
适用场景:应用触发的事务邮件发送与投递诊断、退信与投诉排查、Webhook 真实性校验。
限制:发送邮件必须有人类明确指令,指定收件人、发件人和内容,并经过预览与确认;已投递邮件无法可靠撤回。不得向未验证地址或真实用户发送。不得在聊天中粘贴 API 密钥、完整邮件正文或抑制列表。未验证签名的 Webhook 不可信任。不适用于营销或批量邮件、其他邮件服务商、组织级投递策略设计,以及应用内邮件功能开发。