Communitygithub.com

Xipher-Labs/walter-os

在 4-8 小時內,使用 Astro + Tailwind + shadcn 風格元件,快速打造高品質落地頁面。包含預設的最佳實踐、經過驗證的章節結構、內建效能與 SEO 優化。

walter-os 是什麼?

此技能專為快速產出高轉換率的 B2B/SaaS 落地頁面而設計,目標是在 4-8 小時內完成從零到部署的完整流程。它提供了一套強烈預設的技術棧:Astro、Tailwind CSS 以及 shadcn/ui 風格的元件,並部署在 Vercel 上。此技能的核心價值在於將眾多繁瑣但至關重要的最佳實踐(如無障礙設計、核心網頁指標、安全性標頭)自動化整合,讓開發者能專注於內容與體驗設計。其工作流程包含一套經過驗證的 10 個章節結構,從英雄區域到最終的行動呼籲,以及一份詳盡的、按小時劃分的時間表,引導使用者完成設定、文案撰寫、視覺打磨、表單與分析整合、SEO 和效能調校。此技能不支援需要認證或動態使用者內容的多頁面應用程式,這類需求應使用 Next.js 等框架。它與其他技能(如 `frontend-quality`、`web-security-baseline`)深度整合,確保最終交付的頁面具備企業級品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Xipher-Labs/walter-os/tree/HEAD/skills/landing-page-fast

在你喜歡的 AI 中提問

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

說明文件

Landing Page Fast

基於實戰經驗的落地頁面生產流程。決策都已幫你做好。產出:一個能正常運作、已部署、符合品牌調性的頁面,只需 4-8 小時,而非數週。

此技能已內建 frontend-quality 規則(無障礙、核心網頁指標、行動優先)和 web-security-baseline 標頭 — 你無需在建置過程中分心思考這些。

技術棧(預設 — 若無正當理由,請勿偏離)

  • Astro + Tailwind + shadcn/ui 風格元件 + Vercel。
  • TypeScript 嚴格模式。
  • 使用 astro:assets 進行圖片優化。
  • 若為多頁面,使用 astro:transitions(保持精簡 — 單頁面出貨更快)。

何時偏離:

  • 需要認證閘道 / 動態的每位使用者內容,且未來會發展成完整應用程式 → 使用 Next.js 15 App Router 而非 Astro。
  • 操作人員已為此專案標準化使用 SvelteKit → 使用 SvelteKit。

請勿使用:WordPress、Wix、無框架的原始 HTML+JS、不含 Tailwind 的純 CSS。這些技術出貨較慢,且難以演化。

章節結構(經 B2B/SaaS 技術受眾驗證)

按此順序排列。除非有明確理由,否則不要跳過任何環節:

  1. 英雄區域 — 標題 + 副標題 + 主要行動呼籲 + 視覺元素
  2. 社會證明 — 客戶標誌、數據橫幅、推薦(僅限真實案例)
  3. 問題 — 現狀有何缺失(在此建立可信度)
  4. 解決方案 — 這如何解決問題(最多 3 個功能)
  5. 運作方式 — 3-4 個步驟,附圖表或截圖
  6. 使用案例 — 2-3 種人物誌,不要更多
  7. 定價 — 顯示價格,除非真的無法公開
  8. 常見問題 — 5-8 個真實問題與真實答案
  9. 最終行動呼籲 — 重申價值,重複行動指令
  10. 頁尾 — 法律資訊、社群、聯絡方式

跳過「關於我們 / 團隊」,除非創辦人的可信度本身就是賣點(大多數 B2B 基礎設施產品:跳過;創辦人主導的消費產品:包含)。

英雄區域構成

[標題:6-10 個字,價值承諾]
[副標題:15-25 個字,說明對象/內容/原因]
[主要行動呼籲] [次要行動呼籲 — 「看看如何運作」]
[視覺元素:截圖、圖表或 30 秒示範循環]

標題規則:

  • 承諾結果,而非功能。
  • 具體勝於抽象。
  • 包含主要關鍵字以利 SEO 和資格認定。

範例:

  • ❌ "為現代應用程式打造的強大基礎設施"
  • ✅ "P99 低於 50 毫秒的 Solana RPC 基礎設施"
  • ❌ "公開招標的透明平台"
  • ✅ "10 分鐘內加入公開招標"

專案特定預設值

[專案 A] 落地頁

  • 主要本地化市場,需要第二語言時,英文放在 /en。
  • 英雄區域:儀表板截圖,並突顯一個招標卡片。
  • 信任訊號:法律參考(相關合規標章)、稽核標誌、適用的法規認證。
  • 色彩:品牌主色 + 中性奶油色 + 沉穩強調色。
  • 行動優先的嚴格要求:多數使用者使用手機。
  • 表單擷取:WhatsApp + 電子郵件(WhatsApp 在阿根廷的中小企業中非常普遍)。

[專案 B] 落地頁

  • 主要本地化市場,需要第二語言時,英文放在 /en。
  • 信任、信任、再信任。合規標章、加密視覺化、病人自主權訊息。
  • 攝影風格:溫暖、人性化,切忌科技感/冰冷感。
  • 色彩:比[專案 A]更溫暖的色調(陶土色、鼠尾草綠、奶油色)。
  • 表單精簡 — 僅需電子郵件 + 「我是 [病人 | 醫生 | 診所]」選擇器。
  • 隱私揭露資訊顯眼(引用適用的當地病人權利和個人資料保護法)。

[公司] 產品頁

  • 以英文為優先,不進行本地化。
  • 程式碼為主。包含可直接複製貼上的即時代碼片段。
  • 隨處可見效能數據("p99 < 50ms"、"100k TPS"),並附基準測試方法連結。
  • 免費試用版註冊行動呼籲。
  • 色彩:[公司] 品牌調色盤,取自 brand-creation 的產出。

按小時劃分的時間表

第 1 小時:設定

pnpm create astro@latest <project> -- --template basics --typescript strict
cd <project>
pnpm add @astrojs/tailwind @astrojs/sitemap @astrojs/vercel
pnpm dlx astro add tailwind sitemap vercel
pnpm add -D @astrojs/check

初始化 Vercel 專案(CLI 會自動偵測 Astro):

pnpm dlx vercel link
pnpm dlx vercel deploy --prod  # 基本空白部署,驗證管線

第 2-3 小時:文案 + 結構

  • 先在 Markdown 中撰寫文案(放在 docs/landing-copy.md)。
  • 文案尚未確定前,不要進行設計。
  • 逐個章節進行。建置時使用行動優先的視口。

第 4 小時:視覺潤飾

  • 使用 nanobanana 技能或真實截圖來製作英雄區域視覺。
  • 章節插圖風格一致(不要混用)。
  • 嚴格使用 Tailwind 間距比例(不使用任意值)。

第 5 小時:表單 + 分析

  • 表單透過 Vercel Edge Function 將資料發送至 Resend(交易式電子郵件)或 Supabase(等待清單資料庫)。
  • 加入 Plausible 腳本(自架於 Walter-VM 或雲端,每月 €9)。
  • 測試完整流程:表單 → 電子郵件確認 → 資料庫記錄。

第 6 小時:SEO + 標頭

  • 每個頁面的中繼標籤(title, description, og:, twitter:)。
  • 標準網址。
  • JSON-LD 結構化資料(Organization 或 Product)。
  • Robots.txt + sitemap.xml(Astro 外掛自動產生)。
  • 安全性標頭(在 vercel.json 或中介軟體中):
    {
      "headers": [{
        "source": "/(.*)",
        "headers": [
          { "key": "Strict-Transport-Security",
            "value": "max-age=31536000; includeSubDomains; preload" },
          { "key": "X-Content-Type-Options", "value": "nosniff" },
          { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" },
          { "key": "Permissions-Policy",
            "value": "camera=(), microphone=(), geolocation=()" },
          { "key": "Content-Security-Policy",
            "value": "default-src 'self'; img-src 'self' data: https:; style-src 'self' 'unsafe-inline'; script-src 'self' https://plausible.io" }
        ]
      }]
    }
    

第 7 小時:效能檢查

  • 執行 Lighthouse。所有四項分數 ≥ 95。
  • 圖片尺寸正確(使用次世代格式,並根據視口調整大小)。
  • 初始套件壓縮後 < 150KB。
  • LCP 元素預先載入。

第 8 小時:部署 + 驗證

  • 透過 Vercel 設定自訂網域(Cloudflare DNS 指向 Vercel)。
  • 正式環境部署。
  • 在真實手機上測試。
  • 提交至 Google Search Console。
  • 成功記錄第一個分析事件。

效能預算(嚴格)

指標預算工具
Lighthouse 效能≥ 95CI
Lighthouse 無障礙≥ 95CI
Lighthouse 最佳實踐≥ 95CI
Lighthouse SEO≥ 95CI
3G 網路下的 LCP< 2.5sWebPageTest
INP p75< 200msRUM(Plausible 啟用時,或 web-vitals 函式庫)
CLS< 0.1RUM
初始 JS gzipped< 150KBbundlewatch
首字節時間< 200msVercel edge

若任何指標未達標:修正後方可上線。指標不佳的行銷頁面會立即扼殺轉換率。

文案規則

針對技術型產品([公司]):

  • 以客戶會搜尋的名詞開頭("Solana RPC")。
  • 儘早提供數據 — 在前 5 秒內給出一個相信的理由。
  • 展示勝於說明:程式碼片段、截圖、真實數字。
  • 一個行動呼籲,重複出現。

針對消費 / 本地化市場([專案 A]、[專案 B]):

  • 使用平實的詞彙、簡短的句子。
  • 以使用者心中想問的問題開頭。
  • 信任訊號(合規、安全標章)要更醒目。
  • 多個行動呼籲也可以(註冊、了解更多、聯絡我們)。

表單擷取

// Vercel Edge function: /api/signup.ts
export const config = { runtime: 'edge' }

export default async function handler(req: Request) {
  if (req.method !== 'POST') return new Response('Method Not Allowed', { status: 405 })

  const { email, source } = await req.json()

  // 透過 Vercel KV / Upstash 按 IP 進行速率限制
  // 使用 zod 驗證電子郵件
  // 插入 Supabase 等待清單資料表(受 RLS 保護)
  // 透過 Resend 觸發確認電子郵件
  // 回傳 200 或特定錯誤

  return Response.json({ ok: true })
}

絕對不要:

  • 信任客戶端來「記住」提交狀態。
  • 跳過伺服器端驗證。
  • 忘記速率限制(一個使用者、一個機器人、一次 DDoS — 都是同一個錯誤)。

分析預設值

Plausible(自架於 Walter-VM 或雲端):

<script defer data-domain="[project-a].com.ar" src="https://plausible.<domain>/js/script.js"></script>

追蹤項目:

  • 頁面瀏覽(預設)
  • 外部點擊(data-domain="..." data-track-outbound="true")
  • 表單提交(自訂事件)
  • 長頁面的滾動深度(自訂事件,具防抖功能)

請勿:

  • 加入 Google Analytics。過於沉重、侵犯隱私,且在歐盟-AAR 範圍內定義模糊。
  • 加入工作階段重播工具。特別是在[專案 B]中(有受保護健康資訊風險)。
  • 加入熱力圖。過於沉重且令人反感。

反模式(請勿執行)

  • 輪播英雄區域 — 沒有人會點擊第一張之後的幻燈片。
  • 太多行動呼籲 — 英雄區域同時出現「註冊」+「了解更多」+「觀看示範」+「閱讀部落格」= 決策癱瘓。
  • 辦公室裡多樣化、微笑的人群的庫存照片 — 立刻發出「通用 SaaS」訊號。
  • 50 個微小競爭對手標誌的跑馬燈 — 選 4-6 個可讀的即可。
  • 功能牆 — 選 3 或 6 個,不要選 27 個。
  • 自動播放含聲音的影片 — 立刻跳出。
  • 頁面載入前的彈出視窗 — 立刻跳出。
  • 阻擋頁面的 Cookie 橫幅 — 在歐盟違法,到處都惹人厭。請使用最小化、不阻擋的通知。

何時進行 A/B 測試

在每週訪客數達到 1,000 人以上之前,不要進行。低於此數字,雜訊會主導結果。

準備好時:

  • 一次只測試一個元素(標題、英雄視覺、行動呼籲文案)。
  • 使用 Vercel A/B 測試或 Plausible 的分流測試。
  • 達到統計顯著性後才能宣布贏家。

嚴格規則

  • 8 小時預算是硬性規定。如果你在第 6 小時仍在設計,請直接出貨第 7 小時的工作,並跳過第 8 小時的潤飾。 不完美的上線版本,好過儲存在儲存庫中的完美版本。
  • 每個外部腳本都需經過稽核。 不要有「既然都要做,順便加入 Hotjar / FullStory / Drift」的想法。每個腳本都會拖慢頁面速度並增加隱私風險。
  • 未經預覽部署核准,不得進行正式環境變更。
  • Lighthouse 未通過 = 封鎖上線。

整合

  • nanobanana:用於產生英雄區域 / 插圖。
  • brand-creation:提供調色盤、字體、語調的產出。
  • frontend-quality:內建規則(無障礙 + 效能)。
  • web-security-baseline:內建標頭。
  • seo-keyword-research(待辦事項,已延後):為文案和中繼標籤提供資訊。
  • pr-review:用於合併前的最終審查。

此技能不包含的事項

  • 需要認證、儀表板等的多頁面應用程式 → 請從 Next.js 開始。
  • 部落格設定。請使用 Astro Starlight 或 Mintlify 風格的文件框架。
  • 電子郵件行銷自動化。請使用 ConvertKit / Beehiiv。
  • 客戶支援對話。如果必須使用,請用 Crisp(阿根廷選項,支援多語言)。

Individual skills in this repo

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

相關技能