mcpField
E
email-best-practices

email-best-practices

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

关于 email-best-practices

email-best-practices 是帮助开发者构建可靠、合规且易用邮件的指导技能,涵盖从收集订阅许可到发送、追踪和无障碍设计的流程。

主要功能

  1. 01邮件送达与 DNS 身份验证
  2. 02交易邮件规划与实现
  3. 03订阅许可和合规指导
  4. 04发送重试与幂等处理
  5. 05Webhook、退信与抑制管理
  6. 06邮件无障碍检查

适用场景

  1. 01排查邮件进入垃圾箱的问题
  2. 02规划密码重置和验证邮件
  3. 03构建合规的营销邮件订阅
  4. 04处理投递事件与退信

安装

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

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

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

包含的文件

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

references/
accessibility.md
compliance.md
deliverability.md
email-capture.md
email-types.md
list-management.md
marketing-emails.md
sending-reliability.md
transactional-email-catalog.md
transactional-emails.md
webhooks-events.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