Communitygithub.com

落地頁上線 — Cloudflare 託管、轉換事件、名單表單

把完成的落地頁準備上線:Workers 靜態託管、無 Cookie 的 Web Analytics、唯一 CTA 的轉換事件、可用的名單表單 Worker、可選 A/B 測試,以及 landing/launch.md 上線清單。全部先在本機測試,沒有你同意絕不部署、不動 DNS。

落地頁上線 — Cloudflare 託管、轉換事件、名單表單 是什麼?

落地頁配方第 3 步(上線):來自 Im-Fran/landing-skills 的 landing-launch。讀取建置產物與 landing/brief.md,辨識技術棧(純 HTML、Astro、Vite/React、Next.js),再寫託管設定、表單 Worker、統計程式碼,並用 Workers Analytics Engine 計算轉換。Cloudflare 指令於 2026-10-04 對照文件核對、以 Wrangler 4.147.0 跑通;技能提醒你再核實,也提供非 Cloudflare 路線,隱私聲明與聯絡方式在你提供前保持明顯佔位。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-launch

在你喜歡的 AI 中提問

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

說明文件

登陸頁面上線

準備一個已建置的登陸頁面上線:主機託管、頁面分析、針對其唯一行動呼籲的轉換事件、一個可運作的潛在客戶表單、可選的 A/B 測試,以及一個上線檢查清單。此技能會在本機端進行準備和測試。未經使用者同意,絕不進行部署或變更 DNS。

Cloudflare 指令、配置鍵和限制會有所變更。此處的內容已根據 Cloudflare 2026-10-04 的文件進行過檢查,Worker 程式碼使用 Wrangler 4.147.0 執行。在依賴任何指令或限制之前,請先確認當前 Cloudflare 文件中的內容,若文件與此技能有不一致之處,請以文件為準。

輸入

首先讀取檔案,僅在一則訊息中向使用者詢問他們未提供的資訊。

輸入來源若缺失
已建置的頁面,以及表單提交到此技能的 Worker 時所需的 /thanks/ 和 /form-error/建置輸出(dist/、public/、匯出資料夾),由 landing-skills:landing-build 寫入執行建置。如果還沒有頁面,則停止並說明頁面應該優先準備(landing-skills:landing-build)。
轉換動作:表單或外部頁面、表單欄位、端點狀態(none yet 或 URL),或外部 URLlanding/brief.md 中的 Conversion action從頁面讀取:表單的 action 和每個欄位的 name,或主要連結。用一個問題與使用者確認。
表單提交的每個欄位 name 以及端點狀態建置的交接資訊;否則為已建置表單的 name 屬性從已建置的表單中讀取。
網域landing/brief.md 中的 Domain詢問。如果仍是 unknown,則使用 workers.dev 位址,並將網域相關項目標記為待處理。
聯絡途徑,用於 /form-error/ 和頁尾landing/brief.md 中的 Contact routes詢問。在獲得回覆前,顯示一個可見的 [PLACEHOLDER: ...],項目標記為待處理。
表單、感謝和錯誤訊息landing/copy.md使用頁面語言撰寫簡短、平實的訊息,並列出供使用者批准。
主機託管選擇使用者推薦 Cloudflare(如下)。如果他們拒絕,則轉到「不使用 Cloudflare」。
隱私權聲明頁面的頁尾和表單向使用者詢問;在此之前顯示一個可見的 [PLACEHOLDER: ...],項目標記為待處理。切勿自行編造。

此技能會寫入的內容:主機託管配置、必要時的表單 Worker、分析程式碼片段和轉換事件,以及包含檢查清單的 landing/launch.md。它不會撰寫文案或改寫已建置頁面的內容。

在撰寫任何配置之前,先識別技術棧(純 HTML、Astro、使用 React 的 Vite、Next.js)及其輸出資料夾。

建議

建議將所有三項工作交給 Cloudflare,並使用以下說詞解釋原因:

  • 主機託管: Workers 靜態資產用來服務頁面;靜態請求在 Free 方案下是免費且無限制的,而且 Cloudflare 建議新專案使用 Workers 而非 Pages。同一個專案可以為表單運行一個小型 Worker,因此頁面無需其他後端。
  • 分析: Cloudflare Web Analytics 不需要 Cookie 或指紋辨識即可計算流量和 Core Web Vitals。它沒有自訂事件,因此轉換由同一個帳戶中的 Workers Analytics Engine(也屬於 Free 方案,免費使用)中的 Worker 進行計算。
  • A/B 測試: 同一個 Worker 可以在頁面提供之前,在邊緣端分配變體。不需要客戶端測試腳本、不會有閃爍問題,且在 JavaScript 關閉時也能運作。

同時說明成本:自訂網域需要將該網域的 DNS 託管在 Cloudflare 上,而且每個運行 Worker 的請求都會計入 Free 方案每天 100,000 次的上限。

流程

  1. 讀取輸入。 從 landing/brief.md 擷取轉換動作(表單或外部頁面、其欄位、端點狀態)、網域和聯絡途徑。從已建置的頁面中,記錄每個表單及其 action 和欄位名稱,以及每個行動呼籲連結。僅詢問仍缺失的資訊。

    然後根據情況選擇,這將決定你要新增的內容:

    • 表單,端點 none yet(表單提交至 /api/lead,但尚無任何服務提供此端點):表單 Worker,步驟 4 和 5。
    • 表單,端點已存在: 不需要表單 Worker 和 Turnstile。檢查表單是否提交到該端點,以及結果頁面是否與其回傳的內容相符,並記錄驗證和垃圾郵件防護是該端點的工作。
    • 外部頁面(結帳、預訂、應用程式商店):無需處理表單。連結指向真實 URL,並在步驟 5 中使用信標計算點擊次數;檢查清單中的表單項目標記為 n/a。
  2. 先修復死胡同。 在建置中搜尋 action 沒有指向任何地方或提交動作被取消的表單、僅顯示感謝訊息的提交處理器、指向純 # 的連結,以及連結到其所在區塊的按鈕。這些都表示轉換不存在。表單將在步驟 4 中取得 Worker 端點;連結則取得使用者的真實 URL,或一個可見的 [PLACEHOLDER: ...] 和一個待處理的檢查清單項目。

  3. 主機託管配置。 為該技術棧撰寫 wrangler.jsonc,在專案中安裝 Wrangler,若缺少則新增 404.html,並且僅在有內容需要放置時才新增 _headers 或 _redirects。閱讀 references/hosting.md。

  4. 表單端點(表單,端點 none yet)。 新增表單 Worker:伺服器端驗證、使用 Siteverify 進行的 Turnstile 驗證、D1 儲存,以及 JavaScript 和非 JavaScript 回應路徑。在建置的表單中新增 Turnstile 小工具;保留建置的標記和增強腳本。檢查 /thanks/ 和 /form-error/ 是否存在,以及 /form-error/ 是否提供簡報中的聯絡途徑。僅在缺少結果頁面時才建立,且絕不覆蓋:它們屬於 landing-skills:landing-build。閱讀 references/forms.md。

    每個欄位都需處理。 列出表單提交的每個欄位 name,並在 Worker 的 FIELDS 表中為每個欄位建立一個條目(是否必填、長度上限、有意義的格式檢查,否則為帶有上限的文字)、在 leads 表中建立一個欄位,以及一個能容納它們的 MAX_BYTES。未經驗證的資料不儲存。Worker 未處理的已提交欄位將導致檢查清單失敗;Worker 會以 unknown_field 拒絕此類 POST,這使得差距在測試中顯而易見,但在該欄位被新增之前,訪客的提交仍然會遺失。

  5. 分析和轉換事件。 在每個頁面中新增 Web Analytics 程式碼片段,並在 Analytics Engine 中記錄轉換:如果你新增了表單 Worker,則在該 Worker 中記錄;如果是連結,則透過信標記錄。對於已存在的端點,轉換會根據該端點的記錄進行計算,而信標則是一個選項。閱讀 references/analytics.md。

  6. A/B 測試,僅在被要求時進行。 在撰寫任何程式碼之前,先就一項變更、基準線、值得採取行動的最小差異以及樣本量達成一致。然後新增變體檔案和 A/B Worker。閱讀 references/ab-testing.md。

  7. 在本機端進行測試。 使用 Turnstile 測試金鑰在 .dev.vars 中執行 npx wrangler dev,並使用 curl 和瀏覽器測試每個路徑:包含所有欄位的有效 POST、無效的電子郵件、每個欄位超過其上限、Turnstile 驗證失敗、JavaScript 關閉時的情況;以及測試:變體分配、第二次請求時的黏性 Cookie、轉換端點。然後執行 npx wrangler deploy --dry-run 並檢查資產數量和大小。本機端運行不需要帳戶。在繼續之前修復任何失敗的問題。

  8. 等待用戶許可。 部署、建立預覽、新增自訂網域或路由、建立 D1 資料庫、執行 d1 execute --remote、設定密碼、建立 Turnstile 小工具,以及將站點新增到 Web Analytics 都會變更使用者的 Cloudflare 帳戶,而部署或 DNS 變更會立即對公眾可見。使用者可能正在審查中,網域可能仍在服務舊站點,錯誤的 DNS 變更可能導致即時站點下線。因此,列出每個面向外部的步驟,包含確切指令及其將變更的內容,並且僅在使用者在該時刻對該步驟表示同意時才執行。對一個步驟的同意不代表對下一個步驟的同意。如果使用者更喜歡自己執行,則依序提供指令。

  9. 部署後(與使用者一起)。 提交即時表單一次,在 D1 中確認資料列,在 Analytics Engine 中確認轉換,確認 Web Analytics 顯示了訪問,並檢查檢查清單中僅能在即時環境下檢查的項目。

  10. 撰寫 landing/launch.md。 記錄主機託管設定、轉換動作及其計算方式、A/B 計畫(如果有)、面向外部步驟的指令,以及上線檢查清單,每個項目標記為 done、pending、fail 或 n/a,並為每個不是 done 的項目提供原因。向使用者展示檢查清單。

上線檢查清單

將此內容複製到 landing/launch.md 中,並將每一行標記為 done、pending (reason)、fail (reason) 或 n/a (reason)。你無法檢查的項目標記為待處理,絕非已完成。當行動呼籲是外部頁面時,表單項目為 n/a。

轉換

  • 行動呼籲導向一個可運作的動作:表單提交到 /api/lead(或使用者現有的端點),或者連結指向使用者的真實 URL。不能有 href="#"、不能是自身錨點、不能是假的成功。
  • 表單提交的每個欄位 name 都在 FIELDS 表中有一個包含長度上限的條目,並在 leads 表中有一個欄位。任何未處理的欄位都是失敗,絕非通過。
  • 對於已存在的端點:它針對 Accept: application/json 回傳包含 ok 的 JSON,否則重新導向到 /thanks/ 或 /form-error/,或者結果頁面與其實際回傳的內容相符;驗證和垃圾郵件防護被記錄為其工作。
  • 當表單提交到此技能的 Worker 時:/thanks/ 和 /form-error/ 存在(建置自身的頁面,未被覆寫),並且 /form-error/ 提供簡報中的聯絡途徑。對於已存在的端點,頁面需與其回傳的內容相符;對於外部連結,則為 n/a。
  • 表單已在本機端測試:有效 POST、無效電子郵件、Turnstile 驗證失敗、JavaScript 關閉(導向 /form-error/)。
  • 按鈕在發送期間被禁用;成功和錯誤透過 role="status" 元素進行宣告。
  • 蜜罐欄位從視覺和輔助技術中隱藏。
  • 部署後即時表單已測試一次;資料列存在於 D1 中。
  • 除非使用者有發送確認郵件的方式,否則不要承諾發送確認郵件。

衡量

  • Web Analytics 程式碼片段已使用真實權杖(token)存在於每個頁面(待處理:在權杖存在之前,程式碼片段位於 HTML 註解中),包括 /thanks/、/form-error/ 和 404.html。
  • 轉換已寫入 Analytics Engine,並且即時測試轉換出現在 SQL 查詢中。
  • Web Analytics 顯示即時訪問。
  • 在 A/B 測試期間:每個變體的訪客數和轉換數會出現,並且樣本量和結束規則會寫在 landing/launch.md 中。

主機託管

  • npx wrangler deploy --dry-run 通過;資產檔案少於 20,000 個,沒有任何一個超過 25 MiB。
  • 自訂網域透過 HTTPS 提供頁面服務;workers_dev 按使用者意願設定。
  • _redirects 中的重新導向已在即時環境中測試。
  • 未知路徑回傳自訂的 404.html,狀態碼為 404。

頁面

  • 標題、中繼描述、權威 URL 以及 Open Graph 和社交卡片標籤已存在;卡片圖片從即時 URL 載入,並且在將連結貼入分享偵錯工具或聊天應用程式時,預覽看起來正確。
  • 存在 robots.txt 和一個列出即時 URL 的 Sitemap;結果頁面和預覽為 noindex。
  • 網站圖示存在。
  • 隱私權聲明已連結在表單旁和頁尾,指明 Turnstile(一個 Cloudflare 腳本)以及表單儲存的每個欄位(按名稱)。聯絡資訊(電子郵件、電話或目標受眾實際使用的訊息渠道)以及網站經營者。
  • 任何「無 Cookie」的陳述仍然為真(當 A/B 測試設定其 Cookie 時則不然)。
  • 每個 [PLACEHOLDER: ...] 都已解決:使用真實照片和螢幕截圖,價格和日期已確認。

帳戶和密碼

  • 已為生產環境主機名稱建立 Turnstile 小工具;真實的 Sitekey 存在於 HTML 中。
  • TURNSTILE_SECRET 已使用 wrangler secret put 設定(絕不提交);.dev.vars* 和 .wrangler/ 在 .gitignore 中。
  • 每個面向外部的步驟在執行前都已獲得使用者確認。

不使用 Cloudflare

建置結果是純靜態輸出:所有 HTML、CSS、JavaScript 和資產在一個資料夾中。任何靜態主機或用戶自己的伺服器都可以直接提供服務。

如果使用者不希望使用 Cloudflare,則不要新增任何 Cloudflare 檔案:不新增 wrangler.jsonc、不新增 Worker、不新增 Turnstile、不新增 Web Analytics 程式碼片段、不新增 .dev.vars。移除你在本次工作階段中先前新增的任何此類檔案。然後直接跳到上線檢查清單,並處理那些沒有提及 Cloudflare 產品的項目。對於表單和轉換,檢查清單項目仍然適用:表單需要一個在使用者伺服器或服務上的真實端點,並在伺服器端進行驗證,而轉換需要一個可以被計算的方式。指出缺少的內容,將其標記為待處理,並將工具的選擇留給使用者。此技能不為其他主機提供配方。

自我檢查

在報告之前:

  • 未經該步驟的同意,沒有部署、預覽、路由或在使用者帳戶中建立任何內容。
  • 每個配置變更都通過了 npx wrangler deploy --dry-run,並且本機 curl 檢查提供了預期的狀態碼。
  • 沒有任何檔案聲稱 Web Analytics 會計算點擊或轉換。
  • 沒有將密碼、權杖或帳戶 ID 寫入已提交的檔案中。
  • landing/launch.md 已存在,並且檢查清單的每一行都已標記,每個不是 done 的項目都有原因,且沒有提交的表單欄位未被處理。

參考資料

  • references/hosting.md:各技術棧的配置、指令、試運行、自訂網域、_redirects 和 _headers、快取、404、預覽。在步驟 3 時閱讀。
  • references/forms.md:表單標記、經過測試的表單 Worker、使用 Turnstile 測試金鑰進行的本機測試、生產環境設定。在頁面有表單的步驟 4 時閱讀。
  • references/analytics.md:Web Analytics 設定、Analytics Engine 中的轉換事件、查詢、隱私權聲明、部署後應檢查的內容。在步驟 5 時閱讀。
  • references/ab-testing.md:Free 方案的成本、經過測試的

…

[truncated for translation]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相關技能