Communitygithub.com

LinXueyuanStdio/viben

最小化的產品發布前登陸頁面,包含電子郵件收集、品牌標誌與可選裝飾層。會讀取 DESIGN.md 以取得色彩、字體和佈局規則。最適用於:產品發布、Beta 註冊、早期體驗計畫、個人專案。

viben 是什麼?

這是一個專門用於建立「產品發布前等待頁面」的 AI 代理技能(適用於 Claude Code、Cursor、Codex 等平台)。其核心目標是協助開發者快速打造一個聚焦品牌、誠實且無干擾的登陸頁面,用於收集潛在用戶的電子郵件。此技能強調「最小化干擾」與「品牌一致性」:它會強制從使用者提供的 `DESIGN.md` 檔案中讀取色彩系統、字體配對與空間規則,並使用一個已預先加固的 HTML 模板(`assets/template.html`)作為基礎,嚴格透過取代 `{{PLACEHOLDER}}` 令牌來產生最終的 `index.html` 檔案。其工作流程極具結構性,包含了嚴格的令牌驗證(如 CSS 顏色注入防護、SVG 消毒、HTML 跳脫)、響應式佈局檢查(從 375px 到 1440px+),以及一個分為 P0(必須通過)與 P1(建議通過)的品質閘道檢查清單。此技能完全禁止使用倒數計時器、虛假社交證明、表情符號等常見的暗模式(dark patterns),旨在產生一個符合無障礙標準(WCAG AA)、行動裝置優先且風格統一的純淨等待頁面。它支援的平臺廣泛,只要是能執行 SKILL.md 中定義之工作流程的 AI 代理程式即可。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LinXueyuanStdio/viben/tree/HEAD/resources/design-templates/waitlist-page

在你喜歡的 AI 中提問

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

說明文件

Waitlist Page 技能

發布前的頁面是你與未來用戶的首次握手。此技能建立一個專注且誠實的入口:你的品牌識別、你正在打造的產品,以及一條加入早期名單的清晰路徑。沒有虛假稀缺、沒有假倒數計時、沒有人為炒作——只有一個乾淨、以行動裝置為優先的容器,用來承載真實的興趣。

工作流程

前置檢查:載入強化模板與品牌基礎

  1. 載入品牌識別 — 讀取 DESIGN.md 以取得色彩系統、字體配對與空間規則。這是你的基礎。一個等待頁面要生存或毀滅,取決於它與所代表品牌的一致性。如果 DESIGN.md 缺失,請在繼續之前要求使用者提供。
  2. 讀取並複製可重複使用的模板 — 讀取 assets/template.html。這個模板是所有輸出的強化種子。將其複製為 index.html 作為你的基礎。不要從頭開始撰寫 HTML,也不要偏離此結構。模板已包含了所有必要的佈局、表單結構、裝飾、焦點樣式與無障礙基礎設施。

步驟:帶有驗證與跳脫的令牌對應

  1. 從輸入對應令牌 — 對於模板中的每個佔位符(例如 {{PRODUCT_NAME}}、{{BG_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{LOGO_MARK}}),請遵循以下的取代規則:
    • 文字令牌 ({{PRODUCT_NAME}}、{{TAGLINE}}):在插入 HTML 文字節點或屬性值之前,對 <、>、&、"、' 進行 HTML 跳脫。
    • HTML 令牌 ({{LOGO_MARK}}):如果使用文字縮寫,預設對其進行 HTML 跳脫。如果使用行內 SVG,你必須嚴格使用許可清單進行清理:移除 <script> 標籤、事件處理器 (on*)、<foreignObject>、外部參考 (href、xlink:href、url()) 以及任何不允許的屬性/元素,然後再進行插入。如果 SVG 無法安全地清理,則退回使用已跳脫的文字縮寫。永遠不要發出未經處理、未經清理的任意 HTML。確保任何 SVG 都能在其容器內乾淨地縮放。
    • 顏色表達式令牌 ({{BG_EXPRESSION}}、{{FG_EXPRESSION}}、{{ACCENT_EXPRESSION}}、{{DECO_EXPRESSION}}、{{STRIPE_EXPRESSION}}、{{SUCCESS_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{BTN_LABEL_EXPRESSION}}、{{TICKER_BG_EXPRESSION}}、{{TICKER_FG_EXPRESSION}}、{{DECO_STROKE_EXPRESSION}}、{{LOGO_SHADOW_EXPRESSION}}、{{LOGO_FG_EXPRESSION}}):必須嚴格遵守明確的顏色語法(#hex、rgb/rgba、hsl/hsla、oklch 或僅使用區域變數的 color-mix())。嚴格拒絕任何包含 ;、{}、<、>、註解 (/*)、@、url( 或外部參考的輸入,以防止 CSS 注入。請不要用 # 包裹或添加額外引號。範例:rgba(196, 169, 154, 0.38)、color-mix(in srgb, var(--fg) 38%, transparent)、#FDE8DF。按原樣插入到 :root CSS 變數中。如果 DESIGN.md 中有提供,則從中推導 --success;否則僅允許使用後備值 #2D6A4F。
    • 字體名稱令牌 ({{DISPLAY_FONT_CSS}}、{{BODY_FONT_CSS}}):這些是 CSS font-family 值,如果包含空格則已包含引號(例如 'DM Sans'、Syne)。按原樣插入到 --font-display 和 --font-body 宣告中;請勿添加額外引號。
    • 字體 URL 令牌 ({{DISPLAY_FONT_URL}}、{{BODY_FONT_URL}}):空格必須編碼為 + 以用於 Google Fonts URL(例如 DM+Sans、IBM+Plex+Serif)。在插入前驗證 URL 格式是否正確。
  2. 驗證令牌對應規則 — 所有顏色令牌現在都在 CSS 變數中:
    • --bg = {{BG_EXPRESSION}}(例如 #FDE8DF)
    • --fg = {{FG_EXPRESSION}}(例如 #1A1410)
    • --accent = {{ACCENT_EXPRESSION}}(品牌徽章)
    • --deco = {{DECO_EXPRESSION}}(主要裝飾)
    • --deco-stripe = {{STRIPE_EXPRESSION}}(強調條紋)
    • --input-border = {{BORDER_EXPRESSION}}(帶透明度的完整 CSS 表達式)
    • --success = {{SUCCESS_EXPRESSION}} 或 #2D6A4F 後備值
    • --btn-label = {{BTN_LABEL_EXPRESSION}}(按鈕文字顏色,用於對比)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}}(動態跑馬燈背景)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}}(動態跑馬燈文字)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}}(SVG 筆畫,通常以 12–15% 不透明度調低)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}}(標誌容器陰影,微妙的背景色調)
    • --logo-fg = {{LOGO_FG_EXPRESSION}}(標誌縮寫的對比文字顏色)
  3. 回應式佈局 — 模板包含以行動裝置為優先的縮放:
    • 375px:表單堆疊為單欄,標誌縮小至 40px,裝飾壓縮,無水平捲動。
    • 768px:舒適的兩欄呼吸空間。
    • 1440px+:居中佈局,帶有寬裕的空白。
    • 驗證所有文字保持可讀,且電子郵件輸入框與按鈕在 375×667 與 390×844 的螢幕上完全可見(無裁剪)。

驗證:在輸出前執行強化品質閘道

  1. 執行品質檢查清單 — 讀取 references/checklist.md。在輸出前驗證每個 P0 閘道:
    • 僅有一個 CTA(電子郵件表單)
    • 無倒數計時器、無虛假社交證明、無表情符號
    • 在 375px 寬度下無水平捲動
    • 電子郵件輸入框有 type="email" 與 required;名字欄位沒有 required
    • 表單未使用 novalidate;JS 使用 checkValidity() 防護
    • 成功訊息帶有 role="status" 或 aria-live="polite"
    • 所有顏色來自 DESIGN.md 或允許的後備值;沒有憑空發明的 hex 值
    • 所有使用者文字已進行 HTML 跳脫;顏色令牌遵守嚴格語法;字型已進行 URL 編碼
    • 必須通過 P0,否則不予輸出。 如果任何 P0 閘道失敗,請詢問使用者或修正令牌對應後重試。
  2. 驗證 P1 閘道 以進行品質提交(建議):
    • 提交按鈕的懸停與活動狀態
    • 表單驗證提供清晰回饋
    • 跑馬燈動畫尊重 prefers-reduced-motion: reduce
    • 所有互動元素有可見的焦點樣式(input:focus 包含 outline)
    • Tab/Enter 鍵盤支援
    • 內文(≥4.5:1)與按鈕標籤(≥4.5:1)符合 WCAG AA 對比度
    • 標誌 alt/aria-label 存在;跑馬燈有 aria-hidden="true"
    • 已設定 <html lang="">

輸出

  1. 輸出乾淨的 HTML — 單一檔案,CSS 內嵌,圖形使用 SVG。使用 data-od-id 標記互動元素(標題、表單、標誌、跑馬燈、網格等),以便代理程式無需解析即可自訂。

品質閘道

此技能強制執行一個強化、基於模板的工作流程,以確保合規性。你必須遵循此執行路徑;偏離模板將使輸出不合格。

強制性的基於模板執行:

  • 讀取 assets/template.html 作為你的基礎;不要從頭開始撰寫 HTML。
  • 將其複製為 index.html,並僅將 {{PLACEHOLDER}} 令牌取代為已驗證/跳脫的值。
  • 在輸出前,執行 references/checklist.md 中的每個 P0 閘道;如果任何一個失敗,請修正並重新驗證。

P0 閘道(必須通過):

  • 單一 CTA:電子郵件表單是唯一的互動元素。無導航、無次要按鈕、無社交連結。
  • 標誌位置:固定於左上角,符合 DESIGN.md 的強調色,在行動裝置上縮小(50px → 40px)。
  • 顏色一致性:所有顏色來自 DESIGN.md 調色板。唯一允許的硬編碼例外:--success 的 #2D6A4F。
  • 無反模式:無倒數計時器、無虛假社交證明、無表情符號圖示、無 lorem ipsum。
  • 內容完整性:標題與文案直接對應 product_name 與 tagline 輸入——無填充文案。
  • 行動裝置適應性:在 375px 下無水平捲動。電子郵件輸入框與提交按鈕在 375×667 與 390×844 下完全可見(無裁剪)。垂直溢位可捲動,而非隱藏。
  • 字體紀律:僅使用顯示字體 + 內文字體(2 字體規則)。各區塊間尺寸一致。
  • 表單結構:兩個欄位(名字可選,電子郵件必填),checkValidity() 防護,帶有 role="status" 的成功訊息。
  • 令牌跳脫:所有使用者提供的文字已進行 HTML 跳脫;顏色令牌遵守嚴格語法且不含不安全字元(;、{}、<、>、/*、@、url();字體名稱已進行 URL 編碼;{{LOGO_MARK}} 是已跳脫的文字縮寫或經過嚴格清理的行內 SVG(無腳本、無事件處理器、無 foreignObject、無外部 href)。

P1 閘道(建議通過以確保品質提交):

  • 英雄區塊視覺上獨特且在折頁上方(above-the-fold)。
  • 電子郵件提交按鈕有懸停與活動狀態。
  • 表單驗證提供清晰回饋。
  • 頁面在所有行動裝置視口下可捲動(未被裁剪);CTA 無需捲動即可見。
  • 在 prefers-reduced-motion: reduce 下,跑馬燈動畫暫停或移除。
  • 所有互動元素有可見的焦點樣式(outline,非僅 outline:none)。
  • 鍵盤:Tab 鍵可到達每個表單欄位;Enter 鍵可提交。
  • WCAG AA 對比度:內文 ≥4.5:1,按鈕標籤 ≥4.5:1。
  • 標誌 alt/aria-label 存在;跑馬燈有 aria-hidden="true"。
  • <html lang=""> 設定為正確的語言代碼。

裝飾克制:

  • 下方區域提升體驗而不造成干擾。使用不透明度、細微筆畫、柔和動畫。
  • 無漸層跨越超過視口高度的 20%。
  • 旋渦、條紋、網格或跑馬燈均僅使用 DESIGN.md 中的顏色。

輸出

僅在所有 references/checklist.md 中的 P0 閘道通過後才輸出。

在標籤之間輸出成品:

<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>

在成品上方放置一行說明;下方不留任何內容。

輸出後: 如果使用者要求修改,請就地更新 index.html 並在輸出下一版本前重新執行 P0 檢查清單閘道。迭代時不得跳過驗證。

相關技能