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 対応