mcpField
E
email-best-practices

email-best-practices

github.com/resend开发1468.1k 次安装3 周前更新
代码仓库

关于 email-best-practices

Email Best Practices 是帮助团队构建可送达、合规且易用邮件的参考技能,涵盖邮件规划、身份验证、用户同意、发送可靠性、事件处理和列表管理。

主要功能

  1. 01邮件规划与类型选择
  2. 02送达率及 DNS 身份验证指导
  3. 03用户同意与合规实践
  4. 04重试与幂等发送指导
  5. 05投递事件与 Webhook 处理
  6. 06无障碍与列表管理指导

适用场景

  1. 01规划应用的事务性邮件
  2. 02设置新闻邮件注册和用户同意
  3. 03排查邮件送达及垃圾邮件问题
  4. 04处理重试、退信和投递事件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/resend/email-best-practices --skill email-best-practices

安装后在 Claude Code 中输入/email-best-practices确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
.github/workflows/
sync-skills.yml
references/
email-capture.md
email-types.md
marketing-emails.md
compliance.md
accessibility.md
deliverability.md
list-management.md
sending-reliability.md
transactional-emails.md
webhooks-events.md
transactional-email-catalog.md
tests/
README.md
tests/scenarios/
01-spam-deliverability.md
04-webhook-bounce-handling.md
02-multi-region-compliance.md
05-new-saas-email-plan.md
03-retry-idempotency.md

详细介绍

电子邮件最佳实践

构建可送达、合规且方便用户使用的电子邮件指南。

架构概览

[User] → [Email Form] → [Validation] → [Double Opt-In]
                                              ↓
                                    [Consent Recorded]
                                              ↓
[Suppression Check] ←──────────────[Ready to Send]
        ↓
[Idempotent Send + Retry] ──────→ [Email API]
                                       ↓
                              [Webhook Events]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         Delivered  Bounced  Complained  Opened/Clicked
                       ↓        ↓
              [Suppression List Updated]
                       ↓
              [List Hygiene Jobs]

快速参考

需要……请参阅
设置 SPF/DKIM/DMARC、解决垃圾邮件问题送达能力
构建密码重置、OTP、确认邮件事务性电子邮件
规划应用需要发送哪些电子邮件事务性电子邮件目录
构建新闻简报订阅、验证电子邮件地址电子邮件收集
发送新闻简报、促销邮件营销电子邮件
确保符合 CAN-SPAM/GDPR/CASL合规
判断事务性邮件还是营销邮件电子邮件类型
处理重试、幂等性和错误发送可靠性
处理送达事件、设置 WebhookWebhook 和事件
管理退信、投诉和抑制名单列表管理
确保电子邮件的无障碍体验(屏幕阅读器、替代文本、对比度)无障碍

从这里开始

新应用? 先查看目录,规划应用需要发送哪些电子邮件(密码重置、验证等),然后设置送达能力(DNS 身份验证),再发送第一封电子邮件。

遇到垃圾邮件问题? 先检查送达能力——身份验证问题是最常见的原因。Gmail/Yahoo 会拒收未经身份验证的电子邮件。

要发送营销电子邮件? 按以下步骤操作:电子邮件收集(收集同意)→ 合规(法律要求)→ 营销电子邮件(最佳实践)。

要实现生产环境就绪的发送? 提高可靠性:发送可靠性(重试 + 幂等性)→ Webhook 和事件(跟踪送达情况)→ 列表管理(处理退信)。

关注无障碍体验? 大多数电子邮件都无法通过基本的无障碍检查。请参阅无障碍,了解 lang/dir、用于呈现的表格、标题、替代文本、<title> 和对比度。

评论

支持 Markdown