1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | twilio-sendgrid-deliverability-advisor（隶属 Twilio 官方技能合集 twilio/ai） |
| 作者/维护者 | Twilio, Inc.（官方仓库；SendGrid 现为 Twilio 旗下产品） |
| 来源链接 | https://github.com/twilio/ai/tree/main/skills/sendgrid/twilio-sendgrid-deliverability-advisor |
| 许可证 | MIT（数据来自 GitHub API，并核对仓库根目录 LICENSE 原文） |
| GitHub Stars | 合集仓库 twilio/ai 整体 28★／Forks 7（数据来自 GitHub API；该数字属整个官方技能合集，不代表本技能个体热度） |
| 最新版本 | 未标注独立版本号，随合集仓库持续滚动更新；该技能路径最近一次实质性提交为 2026-05-07，仓库整体最近一次提交为 2026-07-29 |
| 安装方式 | Claude Code 插件市场一键安装，或手动复制到 agent 的 skills/ 目录（见第 10 章） |
2. 功能介绍与亮点
Deliverability Advisor 是一套诊断框架，用于回答开发者最常问的一句话：“为什么我的邮件进了垃圾箱？” 核心能力：
- 平台先分流：先判断开发者用的是 SendGrid（API key 以
SG.开头）还是 Twilio Email，避免张冠李戴给出错误诊断路径。 - 三种问题模式分诊：急性问题（突然被封禁/退信飙升）查“变了什么”；渐进式衰退做“系统性审计”；新账号走“预防性搭建”。
- 按症状分层排查：垃圾箱问题先区分“新 IP/域名未预热”与“老账号恶化”，再排查 SPF/DKIM/DMARC 认证、列表质量、内容问题；退信率、投诉率均给出具体健康阈值表。
- 五大收件方专表 + 拉黑名单速查表：Gmail、Yahoo、Microsoft、Apple、Orange 各自的认证门槛、投诉率上限、特殊坑点（如 Apple 隐私保护虚增打开率），以及 Spamhaus、SpamCop 等黑名单的影响范围与申诉流程。
- 诚实的能力边界：文末 CANNOT 段落写明“不能保证送达”“信誉修复需 2-4 周”“不能绕开 DMARC 前置条件”，不做过度承诺。
3. 适用场景
固定分类：集成与工作流自动化
- 邮件突然被拦截、进垃圾箱或退信率异常，需要快速定位根因的后端/全栈开发者；
- 正在搭建新邮件账号或迁移专用 IP、需要规划预热与认证配置的团队；
- 与同合集
twilio-sendgrid-account-setup（配置）、twilio-sendgrid-webhooks（监控）搭配使用、构建完整邮件可观测性链路的工程团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库带
.claude-plugin清单，README 给出插件市场一键安装命令。 - Codex：原生支持——README 给出
git clone+ 复制到~/.agents/skills/的安装步骤，官方文档明确列入受支持工具。 - Cursor：原生支持——官方文档给出专用的
.agents/skills/自动发现路径与安装命令。 - OpenClaw / Hermes Agent：未验证——官方材料未点名提及，仅笼统声明“遵循开放 Agent Skills 标准的工具均可使用”。
5. 推荐理由
邮件送达问题的麻烦在于原因高度交叉：可能是认证没配对、IP 没预热，也可能只是列表太脏，初级开发者往往不知道从哪查起。这个技能把诊断经验封装成一套可复用的分诊流程：先分平台、再分问题类型、再按症状排查，并把五大收件方各自的隐藏规则（如 Apple 开信率注水、Orange 最严投诉率门槛）整理成表——这些细节分散在官方文档各处，单独查找成本很高。它不涉及代码执行或凭据操作，落地动作仍由开发者自己在控制台完成，风险面很小。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Twilio 为通信云领域官方厂商出品，SendGrid 系其旗下产品；合集仓库整体仅 28★，除官方文档站与合集说明外暂未检索到针对本技能的独立第三方评价或活跃讨论 |
| 可用性 | 8 | 随合集一条插件命令即可安装，无需单独配置账号或凭据即可使用（纯诊断建议，落地操作留给开发者）；SKILL.md 含症状分诊表、五大收件方对照表、黑名单速查表，文档完整度高；该技能路径最近一次实质更新距今约 3 个月，仓库整体近期仍在持续提交；无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①Shell 命令执行——全文不含需执行的脚本或命令，纯诊断性文字建议；②联网外发——技能本身不发起网络请求，只指导开发者查看自己的控制台；③API Key/凭据处理——仅要求观察 key 前缀（SG.）作平台判断，技能本身不接触、不存储凭据；④可疑指令——未见提示词注入或隐蔽外发迹象；⑤作者信誉——Twilio 官方仓库，通信云上市公司；⑥License——MIT，已核对 LICENSE 原文；⑦维护时间——仓库整体最近提交 2026-07-29，本技能路径最近实质更新为 2026-05-07。
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 同类方案 | 定位 | 与本 skill 的差异 |
|---|---|---|
同合集内 twilio-sendgrid-account-setup |
指导完成 API Key、域名认证、SDK 安装等首次配置 | 定位互补而非竞争：Account Setup 负责“从零搭起来”，Deliverability Advisor 负责“搭好之后出问题怎么查”，两者被官方 SKILL.md 相互引用 |
同合集内 twilio-sendgrid-webhooks |
被动接收并解析投递/互动事件（bounce、spam_report 等） | Webhooks 提供的是原始事件数据流，本身不给诊断结论；Deliverability Advisor 消费这些信号并给出“下一步该做什么”的分诊逻辑，二者是数据与解读的关系 |
| Amazon SES Agent Skills（AWS 官方） | 面向 Amazon SES 的一组 Agent Skill，覆盖身份验证、配置集、租户搭建与故障排查 | 覆盖的是 SES 生态且以搭建/排障为主线，未见针对送达率问题做类似分症状、分收件方的系统性诊断框架 |
| Postmark Skills（Postmark 官方） | 覆盖发信、收信、模板、Webhook 与“邮件最佳实践”五大方向的一组 Agent Skill | 送达率、合规等内容作为“最佳实践”技能里的一部分收录，不是独立成篇的诊断顾问；本技能把送达率单独拆出来做成完整的分诊决策树，覆盖深度更聚焦 |
8. 用户评价
该技能所属的 Twilio Skills 合集在官方文档站有正式说明，但截至目前，尚未检索到针对这份 SKILL.md 本身的具名第三方开发者评价或社区讨论。
9. 其他补充
技能末尾按诊断结论动态建议安装 twilio-sendgrid-account-setup、twilio-sendgrid-engagement-quality、twilio-sendgrid-suppressions、twilio-sendgrid-webhooks 等配套技能，形成可按需展开的邮件运维技能链。
10. 安装使用方式
Claude Code：
/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio安装后也可直接调用：/twilio-sendgrid-deliverability-advisor
Codex：
git clone https://github.com/twilio/ai.git
cp -r ai/skills/ ~/.agents/skills/Cursor / 其他遵循 Agent Skills 标准的工具：
git clone https://github.com/twilio/ai.git .twilio-ai
cp -r .twilio-ai/skills/ .agents/skills/安装后无需重启会话；技能在检测到送达率相关问题（进垃圾箱、退信、被拉黑等）时被动激活，也可手动触发。使用前无需额外账号配置，建议动作需回到 SendGrid 控制台自行执行。
11. 注意事项
- 技能所属的 Twilio Skills 与配套 MCP 均为 Public Beta，官方声明部分功能尚未完全实现、后续可能变更，且不受 Twilio Support Terms 或 SLA 保障；
- 明确不适用于 Twilio Email（
comms.twilio.com，走 Account SID/Auth Token 认证）——应改用twilio-email-deliverability-advisor； - 本技能只输出诊断建议，不会代替开发者修改 DNS 记录、调整设置或申请黑名单移除，落地操作仍需人工在控制台完成；
- SEQ 深度诊断依赖 SendGrid Pro/Premier 付费计划与近 30 天 ≥1000 封发信量，免费/入门计划账号无法获取该项指标；
- 声誉修复没有捷径，官方口径是“持续 2-4 周良好发送行为”，技能不能加速这一过程。