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 に準拠する法令遵守
トランザクションメールとマーケティングメールのどちらかを判断するメールの種類
再試行、冪等性、エラーに対処する送信の信頼性
配信イベントを処理する、Webhook を設定するWebhook とイベント
バウンス、苦情、抑制リストを管理するリスト管理
メールをアクセシブルにする(スクリーンリーダー、代替テキスト、コントラスト)アクセシビリティ

ここから始めましょう

新しいアプリですか? まずカタログでアプリに必要なメール(パスワードリセット、確認メールなど)を計画し、最初のメールを送信する前に到達性(DNS 認証)を設定してください。

迷惑メールの問題がありますか? まず到達性を確認してください。認証の問題が最も一般的な原因です。Gmail/Yahoo は認証されていないメールを拒否します。

マーケティングメールですか? 次の手順に従ってください。メールアドレスの収集(同意の取得)→ 法令遵守(法的要件)→ マーケティングメール(ベストプラクティス)。

本番環境での送信に備えますか? 信頼性を高めましょう。送信の信頼性(再試行+冪等性)→ Webhook とイベント(配信の追跡)→ リスト管理(バウンスへの対処)。

アクセシビリティが必要ですか? ほとんどのメールは、基本的なアクセシビリティチェックに合格しません。アクセシビリティで、lang/dir、プレゼンテーション用テーブル、見出し、代替テキスト、<title>、コントラストについて確認してください。

コメント