Community生產力與協作github.com

davepartner/email-automation

在應用程式管理後台建立一個非侵入式「Email Automation」區塊:生命週期提醒郵件(歡迎、購物車放棄、購買後、追加銷售、回訪),搭配經過驗證的漏斗時機、個人化文案、免費的所見即所得編輯器、轉換統計資料,以及僅限管理員的表格。系統預設為暫停,並重複使用應用程式既有的郵件連線。

email-automation 是什麼?

此技能會在你的應用程式管理後台中建立一個完整且非侵入式的「Email Automation」區塊。它專為開發人員和 AI 代理設計,可用於在 Laravel、Rails 或 Node.js 等任何技術棧的現有應用程式中加入生命週期郵件行銷功能。技能會先徹底分析應用程式,然後僅新增必要的資料表、排程器和管理員頁面,絕不改動任何現有核心流程。它支援一整套經過驗證的漏斗時序的郵件序列,包括歡迎、購物車放棄、購買後、追加銷售和回訪郵件,且全部可透過管理員介面中的免費所見即所得編輯器自訂。主要優點包括:重複使用應用程式既有的郵件設定(無需第二個 SMTP)、系統預設為暫停(管理員手動啟用)、僅觀察事件而不攔截的掛鉤設計,以及完整的日誌記錄和統計資料。此技能支援 Claude Code、Cursor 和 Codex 等平台,並強調郵件可遞送性、法律遵循(SPF/DKIM/DMARC、取消訂閱連結)和優雅的管理員體驗,包含健康狀態橫幅和使用者郵件取消功能。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/davepartner/email-automation-AI-Agent-skill/tree/HEAD

Installed? Explore more 生產力與協作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

Email Automation — 管理後台建置工具

在使用者現有的管理後台內,建立一個世界級的郵件自動化系統。它會監控使用者行為,將使用者納入適當的生命週期序列,並透過應用程式自身已設定的郵件連線,發送個人化、逐封發送的提醒郵件——其基礎是經過驗證的漏斗時序,而非大量寄送。

目標: 提升使用者回訪率、購買率和留存率——不打擾任何人,也不破壞任何既有功能。

請先閱讀: 此技能刻意設計為非侵入式。它會在動手修改前先仔細研究應用程式,只新增新的資料表/路由(絕不改寫現有流程),重複使用應用程式的郵件連線,且預設暫停。直到管理員明確開啟前,不會有任何郵件被寄出。


工作流程

0. 探索 ─▶ 1. 設計 ─▶ 2. 建置 ─▶ 3. 掛接事件 ─▶ 4. 管理員 UI ─▶ 5. 驗證 ─▶ 6. 交接
   研究應用程式   定義資料模型    新資料表/       觸發器 →       儀表板 +      乾執行 +     預設暫停 +
   和管理後台   + 郵件序列     排程器/工作者   註冊事件       表格 + 統計     預覽          "啟用?"

0. 探索(強制執行,在任何程式碼之前)

徹底研究應用程式,並產生一份簡短的整合計畫。請參閱 references/discovery.md。

  • 偵測技術棧、框架、ORM/資料庫、認證、工作階段、管理後台(或記錄其不存在)。
  • 尋找現有的郵件連線(SMTP/提供者 SDK)——重複使用它;切勿新增第二個。
  • 對應產品、購物車/結帳、訂單、使用者以及所需的事件。
  • 了解平台的目的和商業模式(電子商務、SaaS、金融科技、預訂…)、其啟用事件和關鍵帳戶步驟——然後提出適合的額外提醒序列(電子郵件驗證、個人資料完成、入門引導、KYC、試用/帳單、預訂、續約…)。
  • 如果沒有管理後台,詢問使用者是否要建立一個簡易的管理後台。

1. 設計

  • 定義資料模型(examples/data-model.md):序列、步驟、註冊、排程郵件、已發送紀錄、設定、封鎖名單。
  • 選擇序列集和時序(references/sequences.md)。

2. 建置(僅限新增)

  • 新增資料表/集合、一個排程器工作,以及發送工作者。請勿修改現有資料表。
  • 新增一個功能開關 / 主暫停開關(預設關閉)和一個全域終止開關。

3. 掛接事件

  • 將應用程式現有的事件(註冊、登入、加入購物車、開始結帳、購買、不活躍)掛接到註冊流程——不改變其行為(觀察,而非攔截)。

4. 管理員 UI

  • 新增一個頂層的 「Email Automation」 選單,包含分頁:序列 · 收件者 · 統計資料 · 設定。請參閱 references/admin-ui.md。
  • 在產品和結帳頁面底部新增僅限管理員的購買/放棄表格。

5. 驗證

  • 乾執行模式、一個預覽/測試發送工具、等冪檢查,以及停止條件稽核。

6. 交接

  • 系統預設暫停。通知管理員,顯示一鍵「啟用」(或讓代理協助),並記錄復原步驟。

序列目錄(經過驗證的漏斗時序)

完整細節、文案意圖和停止條件:references/sequences.md。摘要:

#序列觸發器時序(預設)何時停止
1歡迎 / 啟用註冊0小時 歡迎 → 24小時 價值 → 72小時 社會證明登入 / 購買
2註冊後從未登入註冊 + 未登入1小時 → 24小時 → 72小時登入
3已登入但未購買/使用已登入,不活躍1小時 提醒 → 24小時 → 5天購買 / 啟用
4放棄購物車 / 結帳 / 產品購物車或結帳或產品瀏覽,未購買1小時 提醒(無折扣)→ 24小時 社會證明/異議 → 48–72小時 緊迫感 + 折扣購買
5購買後評論購買(識別產品類型)隔天「用得如何?」→ 2週「經驗 + 追加銷售」評論 / 取消訂閱
6追加銷售 / 交叉銷售購買,有其他產品存在價值時刻後(3–7天)購買推廣品項
7回訪 / 重新互動不活躍 30 / 60 / 90 天中性 → 價值 → 最終「我們將停止發送」活動 / 取消訂閱
8補貨消耗性產品約第 45–60 天再次購買

折扣: 追加銷售可能帶有折扣;放棄購物車則帶有緊迫感 + 折扣。預設 0% —— 當為 0 時,郵件中不得提及任何折扣。一個最低購物車金額保護機制會跳過對極低價值購物車的誘因。(references/sequences.md。)

優先順序: 一個使用者同一時間最多只能加入一個促銷序列——購買 > 購物車 > 瀏覽 > 歡迎 > 未登入 > 不活躍 > 回訪。額外序列:瀏覽放棄、補貨通知、降價通知、催款、推薦。請參閱 references/sequences.md。

加上從應用程式目的衍生的平台特定序列——例如電子郵件驗證、個人資料完成、入門引導設定、KYC、帳單/試用即將結束、預訂提醒、續約。僅加入平台能夠偵測並採取行動的序列(references/sequences.md)。


不可妥協的規則

  1. 先研究再建置。 永遠不要修改現有的認證、購物車、結帳、訂單或使用者流程。只新增資料表/路由。
  2. 重複使用現有的郵件連線。 不建立第二個 SMTP/提供者設定。不進行大量/批次發送——郵件是針對單一使用者且由事件驅動。
  3. 預設暫停。 主開關關閉;通知管理員開啟(代理可以主動提供協助)。
  4. 禁止垃圾郵件。 頻率上限(預設每位使用者每 24 小時 ≤1 封行銷郵件,每週 ≤4 封)、靜音時段,以及一個全域封鎖名單(已取消訂閱、退信、投訴)。尊重興趣 + 同意。
  5. 停止條件永遠優先。 在每次發送前重新檢查目標(購買/登入/啟用),以免已購買的使用者收到購物車提醒。
  6. 個人化、一對一的文案。「寄件者」為一個真實人物(品牌名稱),措辭個人化,提及實際產品,一個清晰的 Call to Action,以及每封郵件中都有的**「聯絡管理員」連結**。
  7. 可遞送性 + 法律遵循。 SPF/DKIM/DMARC、品牌化寄件網域、HTML + 純文字、取消訂閱 + 實體地址,無垃圾郵件觸發詞。請參閱 references/sending-and-compliance.md。
  8. 一切皆可稽核。 每次發送都會被記錄(誰、哪個序列/步驟、何時、為何),且每封排程郵件都在管理後台可見。
  9. 美觀 + 無縫整合。 符合應用程式的設計標記;管理員區塊必須看起來是原生的。使用類似 reviews-to-features 的嚴謹風格:清晰的層級結構、44px 觸控目標、可存取的對比度。
  10. 免費的所見即所得編輯器用於郵件內容。 管理員在免費、自託管的所見即所得編輯器(TinyMCE Community;或 Quill / TipTap / Summernote / GrapesJS)中編輯每個郵件範本。輸出必須適用於郵件(行內 CSS、表格、約 600px 寬、無 JavaScript)、經過清理、包含合併代碼、一個條件式折扣區塊,以及自動產生的純文字版本。

非侵入合約(強制執行)

「非侵入式」是經過驗證的,而非假定。完整檢查清單:references/non-disruption.md。最低要求:

  • 在進行遷移前備份資料庫;遷移是新增式且可逆的(不修改現有資料表)。
  • 掛鉤僅供觀察,並以 try/catch 包覆——失敗的觀察者絕不能中斷註冊/登入/結帳/付款。
  • 預設暫停並設有全域終止開關;重複使用現有的郵件連線。
  • 安裝後對所有五個核心流程進行冒煙測試;執行復原演練(停用 → 刪除資料表 → 確認未受影響)。

管理員介面(管理員得到的)

  • 平靜、不雜亂的版面——最多 4 個分頁,每個檢視畫面一個主要操作,詳細資訊放在抽屜中,次要/破壞性操作放在溢位選單(⋯)中,進階設定預設收起,健康狀態橫幅僅在必要時顯示。
  • 健康狀態橫幅顯示在每個分頁的頂部(僅在有問題時):未設定郵件傳輸、排程器/cron 未執行(附詳細原因和修復方法),以及自動化已暫停。請參閱 references/health-checks.md。
  • Email Automation 選單(頂層),包含分頁:
    • 序列 — 每個序列的 啟動 / 暫停 / 刪除(刪除需確認且為軟刪除/可還原,隱藏在 ⋯ 中)、延遲、折扣、停止條件、一個免費的所見即所得編輯器,以及新增 / 重新排序 / 刪除步驟。
    • 使用者與收件者 — 透過電子郵件搜尋使用者;展開其郵件序列(使用向下箭頭);取消特定郵件或完全排除該使用者;加上完整的已發送紀錄,每頁 100 筆,包含時間和原因。
    • 統計資料 — 收到提醒的使用者中,有多少人轉換、收入、按日 / 週 / 月顯示的圖表。
    • 設定 — 寄件者(寄件者名稱/寄件者電子郵件/回覆地址/實體地址)、主暫停開關、頻率上限、靜音時段。
  • 僅限管理員的表格位於產品和結帳頁面底部:
    • 分頁 已購買 / 已放棄 — 清楚標示 「僅限管理員」。
    • 欄位:電子郵件(→ 使用者面板)、註冊/登入/放棄時間、願意支付金額、電話(→ tel: 通話連結),以及一個展開箭頭,顯示已接收 + 已排程的郵件,並連結到使用者面板以進行取消/排除。
    • 可從 Email Automation → 設定中停用,並在表格標題下方附有說明和連結。

完整 UI 規格:references/admin-ui.md。


何時不該使用

  • 沒有合法的同意基礎用於行銷郵件(先提供同意流程)。
  • 使用者基數非常小,自動化的干擾噪音超過其價值——改用手動發送。
  • 產品不適合使用郵件作為溝通管道(以 SMS/推播為主)——調整引擎,不要強迫使用郵件。
  • 受監管的環境(醫療/金融)需要更嚴格的審查——在文案和資料流程上取得批准。
  • 高保證的務交易型需求——切勿將收據/安全郵件透過此系統路由。

代理產出的交付物

  1. references/discovery.md → 一份針對特定應用程式的整合計畫,包含從平台目的衍生的建議序列短清單。
  2. 新的資料表/遷移檔 + 排程器 + 發送工作者(新增式)。
  3. 事件掛鉤(僅供觀察)。
  4. 管理員「Email Automation」頁面 + 分頁 + 統計圖表,包含免費的所見即所得編輯器、新增 / 重新排序 / 刪除步驟、使用者搜尋 + 每封郵件取消 / 排除,以及健康狀態警告(暫停、cron 未執行、無郵件傳輸)。
  5. 僅限管理員的已購買/已放棄表格。
  6. 一個預覽/測試發送工具 + 乾執行 + 復原說明。
  7. 一份簡短的交接文件:新增了什麼、如何啟用、如何暫停、如何復原。

參考資料

  • references/discovery.md — 研究應用程式,找到管理後台,選擇整合路徑。
  • references/non-disruption.md — 強制執行的非侵入合約(備份、可逆遷移、掛鉤隔離、冒煙測試、復原演練)。
  • references/triggers.md — 每個觸發器(購物車放棄、不活躍等)的確切偵測規則。
  • references/sequences.md — 完整的序列目錄、優先順序、時序、文案意圖、停止條件。
  • references/email-copy.md — 個人化「來自一個人」的文案標準、主旨行、範本。
  • references/sending-and-compliance.md — 排程器、等冪性、頻率上限、可遞送性預檢。
  • references/compliance.md — 同意、簽署的取消訂閱、偏好中心、退信/投訴 Webhook。
  • references/admin-ui.md — 儀表板、使用者分頁(搜尋/取消/排除)、紀錄(每頁 100 筆)、統計資料、僅限管理員的表格、所見即所得編輯器、新增/編輯步驟。
  • references/health-checks.md — 暫停 / cron 未執行 / 無傳輸警告,附帶修復指引。
  • references/reference-implementation.md — 以虛擬碼 + SQL 描述的引擎(鎖定、回收器、歸因)。
  • examples/worker.mjs + examples/worker.test.mjs — 可執行、經過測試的排程器/工作者核心。
  • examples/data-model.md — 資料庫綱要。
  • examples/sequence-config.json — 一個具體、可編輯的序列設定。
  • examples/email-templates.md — 範例渲染郵件。

相關技能