技能介绍

要解决什么问题

在 Agent 或对话里发事务/通知/营销邮件，往往卡在三件事：CAM 子账号与 AK/SK 怎么配、发信域名 SPF/DKIM/DMARC 是否通过、以及「模板 ID / 发信地址」不能靠猜。直接手写 tencentcloud-sdk-python 或 curl，还容易绕过 --dry-run 预览就把邮件发出去了。

技能如何工作

本 Skill 用 ses_tool.py 封装腾讯云 SES 核心 API，用 dns_checker.py 做 DNS 诊断（不依赖密钥）。典型发信链路会按文档约定走：先验密钥 → 解析发件人/收件人/模板或内容 → list-domains 查域名是否 SendingEnabled → 缺地址则创建 → 写入类操作 必须先 --dry-run 展示 JSON 预览 → 再正式发送 → 用 MessageId 查投递与送达状态。

能力概览：

域名与地址：查询、创建、提交验证；未验证时走域名认证向导（主域名 @ vs 子域名前缀差异）
发送：send-template（批量收件人、抄送/密送、附件、退订链接等）；自定义 HTML/文本走 send-simple，但需用户确认已开通权限
模板：列表、详情、创建/更新/删除
DNS：SPF 语法与 lookup 次数、DKIM（TXT 非 CNAME）、DMARC、MX、CNAME 冲突与多节点传播

边界与注意

只调用 Skill 脚本，未封装接口应引导去 SES 控制台
域名/模板 ID 必须来自真实 list 查询，禁止编造
密钥：专用子账号 + QcloudSESFullAccess，环境变量 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY，禁止硬编码；群聊勿让用户贴密钥
域名未验证前不可发信；定时/批量发送即使预览过也要用户再次确认