关于 email-best-practices
email-best-practices 是帮助开发者构建可靠、合规且易用邮件的指导技能,涵盖从收集订阅许可到发送、追踪和无障碍设计的流程。
主要功能
- 01邮件送达与 DNS 身份验证
- 02交易邮件规划与实现
- 03订阅许可和合规指导
- 04发送重试与幂等处理
- 05Webhook、退信与抑制管理
- 06邮件无障碍检查
适用场景
- 01排查邮件进入垃圾箱的问题
- 02规划密码重置和验证邮件
- 03构建合规的营销邮件订阅
- 04处理投递事件与退信
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ resend/ resend-skills --skill email-best-practices安装后在 Claude Code 中输入/email-best-practices确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/accessibility.mdcompliance.mddeliverability.mdemail-capture.mdemail-types.mdlist-management.mdmarketing-emails.mdsending-reliability.mdtransactional-email-catalog.mdtransactional-emails.mdwebhooks-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 | 合规 |
| 判断事务性邮件还是营销邮件 | 电子邮件类型 |
| 处理重试、幂等性和错误 | 发送可靠性 |
| 处理送达事件、设置 Webhook | Webhook 和事件 |
| 管理退信、投诉和抑制名单 | 列表管理 |
| 确保电子邮件的无障碍体验(屏幕阅读器、替代文本、对比度) | 无障碍 |
从这里开始
新应用? 先查看目录,规划应用需要发送哪些电子邮件(密码重置、验证等),然后设置送达能力(DNS 身份验证),再发送第一封电子邮件。
遇到垃圾邮件问题? 先检查送达能力——身份验证问题是最常见的原因。Gmail/Yahoo 会拒收未经身份验证的电子邮件。
要发送营销电子邮件? 按以下步骤操作:电子邮件收集(收集同意)→ 合规(法律要求)→ 营销电子邮件(最佳实践)。
要实现生产环境就绪的发送? 提高可靠性:发送可靠性(重试 + 幂等性)→ Webhook 和事件(跟踪送达情况)→ 列表管理(处理退信)。
关注无障碍体验?
大多数电子邮件都无法通过基本的无障碍检查。请参阅无障碍,了解 lang/dir、用于呈现的表格、标题、替代文本、<title> 和对比度。
评论
支持 Markdown