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

ここから始めましょう

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

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

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

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

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

コメント