Communitygithub.com

J-StaR-Films-Studios/VibeCode-Protocol-Suite

1つのResendアカウントと1つの確認済み送信者ドメインを、複数のブランド製品間で再利用します。特に個人開発者や無料枠ポートフォリオ向けで、製品ごとの個別アカウントやドメイン確認なしにトランザクションメールを追加したい場合に使用します。製品ごとのID、受信者、Reply-Toルーティング、テンプレート、セキュリティ境界、配信信頼性を維持しながら、共有送信クォータを意識します。

VibeCode-Protocol-Suite とは?

このスキルは、1つのResendアカウントと1つの確認済み送信者ドメインのみを使用して、複数のブランド製品にトランザクションメール機能を実装するためのプロトコルスイートです。個人開発者や小規模ポートフォリオが無料枠を最大限活用しつつ、各製品の独自のアイデンティティ(送信者表示名、受信トレイ、Reply-Toルーティング、テンプレートなど)を保持できます。 主な機能として、製品ごとのAPIキー発行によるセキュリティ分離、製品固有の送信者ID設定、内部通知と訪問者確認メールの分離ルーティング、ブランドごとのテンプレート作成、共有無料枠のクォータ管理とアンチスパム対策が含まれます。 このスキルは、Claude Code、Cursor、CodexなどのAIエージェントプラットフォームと連携して動作します。開発者はSKILL.mdに従って、既存のResendアカウントと確認済みドメインを再利用しながら、各製品に適切な環境変数とテンプレートを設定することで、メール機能を迅速かつ安全に追加できます。 無料枠の制限や共有クォータを考慮した実装ガイドラインが提供されており、エラー処理、フォールバック、ログ管理、セキュリティチェックなど、本番環境での信頼性を確保するためのベストプラクティスも含まれています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite/tree/HEAD/assets/.agent/skills/web-dev-standards/shared-resend-portfolio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

共有Resendポートフォリオ

1つのResendアカウントと確認済みドメインを通じて、複数の製品にメール機能を実装します。個人開発者や小規模ポートフォリオが無料枠を最適化し、すべてのアプリが同じ製品に見えることを防ぎます。

コアモデル

インフラを共有しても、製品IDは共有しません:

1つのResendアカウント
└── 既存の確認済み送信者ドメイン
    ├── 製品A 送信者ID
    ├── 製品B 送信者ID
    └── 製品C 送信者ID

各アプリは独自の以下を保持します:

  • 送信者表示名
  • 受信トレイ
  • Reply-To ルーティング
  • 件名の規則
  • ブランド化されたHTMLおよびプレーンテキストテンプレート
  • デプロイ環境変数
  • 配信ログと障害動作

すべてのアプリでアカウントレベルの無料枠クォータと確認済みドメインのレピュテーションを共有します。

ポートフォリオの調査

実装前の手順:

  1. 対象アプリと、Resend設定が動作している兄弟アプリを調査します。
  2. 標準的なResendアカウントと既に確認済みのドメインを特定します。
  3. 製品の表示名、共有送信者メールボックス、内部受信者、サポートReply-To受信トレイ、想定されるメールタイプを確認します。
  4. 対象デプロイにすでにResend APIキーがあるか確認します。
  5. 既存のアカウントが明示された要件を満たせない場合を除き、ユーザーに別のアカウント作成、別のドメイン確認、プラン購入を求めないでください。

アカウントとキー戦略

同じResendアカウントと確認済みドメインを再利用します。アカウントが許可する場合、デプロイされたアプリごとに個別のAPIキーを優先します。これにより、キーの漏洩やローテーションの影響を制限しつつ、1つのアカウントとクォータに留まります。個別キーが利用できないか、ユーザーがそのトレードオフを明示的に好む場合にのみ、同じキーを再利用します。

シークレットを別のリポジトリからソース管理にコピーしないでください。選択したキーを各デプロイのシークレット環境に直接追加します。

製品ごとの設定

可能な限りサーバー専用変数と製品固有の名前を使用します。値はユーザーの既存Resendアカウント、確認済み送信者設定、対象製品の受信トレイから解決します。実装に例のIDをコピーしないでください。

変数の役割目的
Resend APIキーサーバーサイドのプロバイダコールを認証します
製品送信者ID現在の製品の表示名と既存確認済みドメイン上のアドレスを組み合わせます
製品連絡先受信者この製品の内部通知を受け取ります
製品返信アドレス連絡先受信者と異なる場合、ユーザー向けメッセージへの返信を受け取ります

表示される表示名が製品IDを提供し、既存の確認済みアドレスが配信性を提供します。APIキーにNEXT_PUBLIC_または同等のクライアント公開変数を使用しないでください。

お問い合わせフォームのルーティング

2つの別々のメッセージを送信します:

内部通知
送信元: 設定された製品送信者ID
送信先: 設定された内部製品受信トレイ
返信先: 訪問者が送信した検証済みアドレス

訪問者確認
送信元: 設定された製品送信者ID
送信先: 訪問者が送信した検証済みアドレス
返信先: 設定された内部製品受信トレイ

訪問者と内部受信トレイを同じ受信者リストに入れないでください。メッセージを分離することで、アドレス露出を防ぎ、異なるコンテンツを可能にします。

内部通知をプライマリ配信として扱います。Resendがそれを受け入れ、メッセージIDを返した後にのみ、フォーム成功を返します。その後、訪問者確認を試行します。その失敗をログに記録しますが、プライマリ問い合わせが失われたとは主張しないでください。

ブランド分離

プロバイダモジュールパターンを再利用可能に保ちながら、各製品に個別のテンプレートシェルを作成します。次の項目をカスタマイズします:

  • 製品名と説明
  • 色、タイポグラフィ、ヘッダー処理
  • メールプレビューテキスト
  • 件名とトーン
  • フッターの所有権、サポートアドレス、応答期待値

テーブルレイアウト、インラインCSS、600~640pxのコンテンツ幅、エスケープされたユーザー値、プレーンテキストバージョンを使用します。送信者インフラが共有されているという理由だけで、別の製品の視覚的IDを再利用しないでください。

共有無料枠の保護

  • 現在のResend無料枠の制限を、記憶した数字ではなく確認します。
  • すべてのアプリが同じアカウントクォータを消費することを忘れないでください。
  • 必要なトランザクションメールのみを送信し、重複通知を避けます。
  • 公開フォームにはアンチスパム制御を維持します:バリデーション、長さ制限、ハニーポット、適切なレート制限。
  • 重複を送信する可能性のあるリトライループを避けます。ワークフローに意味のあるリトライリスクがある場合は、永続化または冪等性を使用します。
  • シークレットや不要な個人データをログに記録せずに、プロバイダ拒否とクォータエラーを監視します。
  • 測定されたボリューム、分離、コンプライアンス、またはレピュテーション要件が正当化する場合にのみ、別のアカウントまたは有料プランにエスカレーションします。

信頼性の高い実装

  1. 正しいワークスペースに公式のresendパッケージをインストールします。
  2. プロバイダコールをサーバー専用モジュールに保持します。
  3. result.data?.idを検証し、result.errorがないことを確認します。
  4. SDKおよびネットワーク例外をキャッチします。
  5. replyToを明示的に設定します。
  6. メールが設定されていない場合は503、プライマリ配信が失敗した場合は502を返します。
  7. UIに直接メール、電話、またはメッセージングのフォールバックを保持します。
  8. ログのみの処理を成功した配信として報告しないでください。

検証

  • 再利用されたResendアカウントで共有ドメインが確認済みであることを確認します。
  • 製品固有のFrom、To、Reply-Toの値を確認します。
  • 内部配信、訪問者確認、そして双方向の返信をテストします。
  • バリデーション、ハニーポット、キー欠落、プロバイダ拒否、フォールバックパスをテストします。
  • リポジトリネイティブの型チェック、リント、テスト、ビルドコマンドを実行します。
  • デプロイにAPIキーと製品変数が含まれていることを確認します。
  • 実際の送信が機能すると主張する前に、1回実際の送信を実行します。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル