Communitygithub.com

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

重複使用一個 Resend 帳戶和一個已驗證的寄件者網域,支援多個品牌產品,特別適合獨立開發者和免費方案組合。在為其他應用程式新增交易郵件時,無需建立新的 Resend 帳戶或驗證網域,同時保留每個產品的識別身份、收件人、回覆路由、範本、安全邊界、傳遞可靠性,並共享配額意識。

VibeCode-Protocol-Suite 是什麼?

這個技能讓獨立開發者或小型產品組合能夠透過單一 Resend 帳戶和已驗證的寄件者網域,為多個品牌應用程式提供交易郵件功能。它最佳化免費方案的使用,使每個產品保有獨立的寄件者顯示名稱、收件信箱、回覆路由、主題慣例、品牌化 HTML 與純文字範本,以及完整的部署與記錄隔離。所有應用程式共享帳戶層級的免費配額和已驗證網域的聲譽,避免重複驗證網域或購買多個方案。此技能支援以 Resend API 為基礎的郵件實作,並提供明確的環境變數、安全最佳實踐(如 API 金鑰分開管理)、聯繫表單路由(內部通知與訪客確認分開傳送)、以及品牌隔離與防禦性錯誤處理的詳細指南。它適用於任何使用 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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

共享 Resend 作品集

透過一個 Resend 帳戶和已驗證的網域,為多個產品實作郵件功能。最佳化獨立開發者或小型作品集對免費方案的使用,避免讓每個應用程式看起來都像同一個產品。

核心模型

共享基礎設施,而非產品身份:

一個 Resend 帳戶
└── 現有已驗證的寄件者網域
    ├── 產品 A 寄件者身份
    ├── 產品 B 寄件者身份
    └── 產品 C 寄件者身份

每個應用程式保有它自己的:

  • 寄件者顯示名稱
  • 目的地收件匣
  • 回覆路由
  • 主題慣例
  • 品牌化 HTML 和純文字範本
  • 部署環境變數
  • 傳遞記錄與失敗行為

所有應用程式共享帳戶層級的免費方案配額和已驗證網域的聲譽。

作品集探索

實作前:

  1. 檢查目標應用程式以及任何已有 Resend 設定的同系列應用程式。
  2. 識別標準的 Resend 帳戶和已驗證的網域。
  3. 確認產品顯示名稱、共享寄件者信箱、內部收件者、支援回覆信箱以及預期的郵件類型。
  4. 確認目標部署是否已有 Resend API 金鑰。
  5. 除非現有帳戶無法滿足已陳述的需求,否則不要要求使用者建立另一個帳戶、驗證另一個網域或購買方案。

帳戶與金鑰策略

重複使用同一個 Resend 帳戶和已驗證網域。當帳戶允許時,優先為每個部署的應用程式使用獨立的 API 金鑰;這能限制金鑰外洩或輪換的影響,同時維持在單一帳戶和配額下。只有在無法取得獨立金鑰或使用者明確偏好該取捨時,才重複使用同一個金鑰。

切勿將其他儲存庫中的祕密複製到原始碼管理中。直接將選擇的金鑰新增到每個部署的祕密環境變數中。

各產品配置

在實際可行時,使用僅伺服器端的變數和產品特定的名稱。從使用者現有的 Resend 帳戶、已驗證寄件者設定和預期的產品收件匣解析這些值——切勿將範例身份複製到實作中。

變數角色用途
Resend API 金鑰驗證伺服器端提供者呼叫
產品寄件者身份將當前產品的顯示名稱與現有已驗證網域上的地址組合
產品聯絡收件者接收此產品的內部通知
產品回覆地址當與聯絡收件者不同時,接收使用者面對訊息的回覆

可見的顯示名稱提供產品身份;現有的已驗證地址提供可送達性。切勿為 API 金鑰使用 NEXT_PUBLIC_ 或等效的用戶端暴露變數。

聯繫表單路由

傳送兩封獨立的訊息:

內部通知
寄件者:配置的產品寄件者身份
收件者:配置的內部產品收件匣
回覆:訪客提交的已驗證地址

訪客確認信
寄件者:配置的產品寄件者身份
收件者:訪客提交的已驗證地址
回覆:配置的內部產品收件匣

不要將訪客和內部收件匣放在同一個收件者清單中。分開的訊息可避免地址暴露,並允許不同的內容。

將內部通知視為主要傳遞。僅在 Resend 接受它並傳回訊息 ID 後,才回傳表單成功。接著嘗試發送訪客確認信;記錄其失敗,但不要宣稱主要查詢已遺失。

品牌隔離

為每個產品建立不同的範本外殼,同時保持提供者模組模式可重複使用。自訂:

  • 產品名稱和描述
  • 顏色、排版和標題處理
  • 郵件預覽文字
  • 主題和語氣
  • 頁尾所有權、支援地址和回覆期望

使用表格佈局、行內 CSS、600–640px 的內容寬度、轉義的使用者值以及純文字版本。不要僅僅因為寄件基礎設施是共享的,就重複使用另一個產品的視覺識別。

共享免費方案保障措施

  • 檢查目前 Resend 免費方案的限制,而非依賴記憶中的數字。
  • 記住每個應用程式都消耗同一個帳戶配額。
  • 僅傳送必要的交易性訊息;避免重複通知。
  • 在公開表單上保持反垃圾郵件控制:驗證、長度限制、蜜罐陷阱和適當的限速。
  • 避免可能產生重複信件的重試迴圈。在流程有實際重試風險時使用持久化或冪等性。
  • 監控提供者拒絕和配額錯誤,但不記錄祕密或不必要的個人資料。
  • 僅在測量到的流量、隔離、合規性或聲譽需求證明合理時,才升級到另一個帳戶或付費方案。

可靠實作

  1. 在正確的工作區安裝官方的 resend 套件。
  2. 將提供者呼叫保留在僅伺服器端的模組中。
  3. 驗證 result.data?.id 並確保 result.error 不存在。
  4. 捕獲 SDK 和網路例外。
  5. 明確設定 replyTo。
  6. 當郵件未配置時回傳 503,主要傳遞失敗時回傳 502。
  7. 在使用者介面中保留直接的電子郵件、電話或訊息後援。
  8. 永遠不要將僅記錄的處理回報為成功傳遞。

驗證

  • 確認在重複使用的 Resend 帳戶中,共享網域已驗證。
  • 確認產品特定的寄件者、收件者和回覆值。
  • 測試內部傳遞,接著訪客確認信,然後測試雙向回覆。
  • 測試驗證、蜜罐陷阱、缺少金鑰、提供者拒絕和後援路徑。
  • 執行儲存庫原生的類型檢查、Lint、測試和建置命令。
  • 確認部署包含其 API 金鑰和產品變數。
  • 在宣稱即時傳遞正常運作之前,先執行一次真實提交。

Individual skills in this repo

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

相關技能