SKILL.md
readonly只读
name
email-best-practices
description
在构建邮件功能、邮件进入垃圾箱、高退信率、设置SPF/DKIM/DMARC认证、实现邮件捕获、确保合规（CAN-SPAM、GDPR、CASL）、处理Webhook、重试逻辑、使邮件可访问（替代文本、标题、对比度、屏幕阅读器）或区分事务性邮件与营销邮件时使用。
邮件最佳实践
构建可投递、合规、用户友好的邮件指南。
架构概览
[用户] → [邮件表单] → [验证] → [双重确认]
↓
[记录同意]
↓
[抑制检查] ←──────────────[准备发送]
↓
[幂等发送 + 重试] ──────→ [邮件API]
↓
[Webhook事件]
↓
┌────────┬────────┬─────────────┐
↓ ↓ ↓ ↓
已投递 退信 投诉 打开/点击
↓ ↓
[更新抑制列表]
↓
[列表清理任务]
快速参考
| 需要... | 参见 |
|---|---|
| 设置SPF/DKIM/DMARC，解决垃圾邮件问题 | 可投递性 |
| 构建密码重置、OTP、确认邮件 | 事务性邮件 |
| 规划应用所需的邮件类型 | 事务性邮件目录 |
| 构建新闻订阅、验证邮箱 | 邮件捕获 |
| 发送新闻简报、促销邮件 | 营销邮件 |
| 确保CAN-SPAM/GDPR/CASL合规 | 合规 |
| 区分事务性邮件与营销邮件 | 邮件类型 |
| 处理重试、幂等性、错误 | 发送可靠性 |
| 处理投递事件、设置Webhook | Webhook与事件 |
| 管理退信、投诉、抑制 | 列表管理 |
| 使邮件可访问（屏幕阅读器、替代文本、对比度） | 可访问性 |
从这里开始
新应用？
从目录开始，规划应用所需的邮件类型（密码重置、验证等），然后在发送第一封邮件前设置可投递性（DNS认证）。
垃圾邮件问题？
首先检查可投递性——认证问题是最常见的原因。Gmail/Yahoo会拒绝未认证的邮件。
营销邮件？
按此路径操作：邮件捕获（收集同意）→ 合规（法律要求）→ 营销邮件（最佳实践）。
生产级发送？
增加可靠性：发送可靠性（重试+幂等性）→ Webhook与事件（跟踪投递）→ 列表管理（处理退信）。
可访问性？
大多数邮件未能通过基本的可访问性检查。参见可访问性了解lang/dir、展示性表格、标题、替代文本、<title>和对比度。
