Email Best Practices

核心用法

本技能提供端到端的电子邮件系统构建框架，分为七大核心模块：

1. 身份认证体系（SPF/DKIM/DMARC）：解决垃圾邮件过滤问题，强制要求DNS记录配置以通过Gmail/Yahoo等主流邮箱的验证
2. 邮件类型决策：区分事务性邮件（密码重置、OTP）与营销邮件的法律和技术边界
3. 合规管理：覆盖CAN-SPAM（美国）、GDPR（欧盟）、CASL（加拿大）三大法规的同意书收集、退订机制、数据留存要求
4. 捕获与验证：双选确认（Double Opt-In）流程、邮箱格式验证、抑制列表检查
5. 可靠投递：幂等发送、指数退避重试、webhook事件处理
6. 列表健康管理：退信（Bounce）分类处理、投诉（Complaint）自动响应、定期清理任务
7. 监控与事件流：投递状态追踪、打开/点击统计、实时反馈回路

显著优点

• 生产级完备性：不仅提供最佳实践，还包含可直接落地的架构图、检查清单、法规对照表
• 风险前置：将合规要求嵌入设计阶段，避免后期法律风险与平台封禁
• 故障自愈设计：重试逻辑、幂等性、抑制列表形成闭环，降低运维负担
• 多场景覆盖：从初创SaaMVP到千万级用户的电商系统均有对应路径

潜在局限

• 服务商依赖：具体实现需绑定SendGrid、AWS SES、Mailgun等第三方API，技能本身不提供自托管方案
• 地域法规盲区：仅明确覆盖美/欧/加三大区域，亚太（如中国《个人信息保护法》、新加坡PDPA）需额外补充
• 实时性风险：邮件服务商策略（如Gmail 2024年批量发送新规）变化快，静态文档可能滞后
• 深度技术细节不足：DNS记录的具体语法、加密密钥轮换周期等需查阅服务商文档

适合人群

• 后端工程师搭建用户通知系统
• 技术负责人评估邮件服务商选型
• 产品经理设计注册/营销流程
• 运维工程师处理投递率下降故障

常规风险

| 风险类型 | 具体表现 | 缓解措施 |

|---------|---------|---------|

| 合规处罚 | GDPR罚款可达全球营收4% | 启用技能中的[Compliance]模块，强制双选确认 |

| 域名声誉损毁 | 误发垃圾邮件导致全域名进黑名单 | 先配置DMARC监控模式（p=none），再逐步强化 |

| 数据泄露 | webhook端点未鉴证，事件payload暴露 | 验证X-Signature头部，使用HTTPS回调 |

| 无限重试风暴 | 下游API故障触发指数退避失败 | 设置max_retry上限，启用死信队列（DLQ） |

核心用法

该 Skill 是一套完整的电子邮件开发最佳实践知识库，采用模块化文档结构覆盖邮件系统全生命周期：

架构流程：从用户表单提交 → 邮箱验证 → 双重确认订阅 → 合规性检查 → 幂等发送 + 重试机制 → Webhook 事件处理 → 退信/投诉管理 → 列表清理，形成闭环。

关键模块：

• 送达率优化（Deliverability）：SPF/DKIM/DMARC DNS 认证配置，解决进垃圾箱问题
• 事务邮件（Transactional）：密码重置、OTP、订单确认等触发式邮件
• 邮件捕获（Email Capture）：注册表单、邮箱验证、双重确认订阅流程
• 营销邮件（Marketing）：Newsletter、促销活动的发送策略
• 合规指南（Compliance）：CAN-SPAM、GDPR、CASL 法规要求
• 可靠性保障（Sending Reliability）：幂等发送、指数退避重试、错误处理
• Webhook 与事件：投递状态追踪、退信/打开/点击事件处理
• 列表管理：退信硬删除、投诉处理、列表卫生作业

显著优点

1. 权威来源：Resend（知名邮件基础设施服务商）官方维护，T1 可信级别
2. 生产就绪：涵盖从开发到运维的完整链路，直接可落地
3. 合规先行：内置 GDPR/CASL/CAN-SPAM 合规指导，降低法律风险
4. 架构清晰：流程图 + 快速参考表 + 场景化入口（"New app?" / "Spam issues?"），降低决策成本
5. 纯文档零风险：无执行代码、无依赖、无数据收集，安全性 S 级

局限性与注意事项

1. 外部依赖：部分深度内容链接至 Resend 官方博客/文档，需网络访问
2. 技术栈偏向：示例代码以现代 Web 技术栈为主，传统邮件系统迁移需适配
3. 非工具型 Skill：仅提供指导，不包含可直接运行的邮件发送代码或 SDK
4. 更新频率：依赖 Resend 官方维护，法规变更时需关注文档同步

适合人群

• 初创团队：规划邮件系统架构，避免踩坑
• 后端工程师：实现可靠的邮件发送管道、重试逻辑、Webhook 处理
• 产品经理/增长团队：设计合规的用户订阅/退订流程
• 运维/DevOps：配置 DNS 认证、监控送达率、处理退信投诉
• 独立开发者：快速搭建 production-ready 的邮件功能

常规风险

| 风险类型 | 评估 | 说明 |

|---------|------|------|

| 代码执行风险 | 🟢 无 | 纯 Markdown 文档，无可执行文件 |

| 数据隐私风险 | 🟢 无 | 自身不收集数据，仅提供合规指导 |

| 供应链攻击 | 🟢 无 | 无依赖文件，无包管理器配置 |

| 外部链接失效 | 🟡 低 | 引用 Resend 官方 URL，建议定期检查 |

| 合规误用风险 | 🟡 低 | 用户需结合自身司法管辖区法律审查 |

使用建议：适合作为邮件系统设计的知识基准，实际实施时建议结合具体邮件服务商（Resend/SendGrid/Amazon SES 等）的最新 API 文档。