Communitygithub.com

LuzzyMeow/LuzzyRP

以精簡的預先啟動落地頁面捕捉電子郵件,展示品牌標誌,並可選裝飾圖層。讀取 DESIGN.md 以獲得顏色、字體與佈局規則。

LuzzyRP 是什麼?

這個技能為你的產品、Beta 測試或早期體驗計畫建立一個極簡、誠實且可轉換的等待清單頁面。它強制使用模板驅動的工作流程:從 `assets/template.html` 載入預先設計好的結構,並根據 `DESIGN.md` 中的品牌規範(顏色系統、字體配對與間距規則)進行自訂。生成的 HTML 為單一檔案,內嵌 CSS,並包含行動優先的回應式設計、無障礙支援與聚焦樣式。此技能明確拒絕虛假的稀缺性行銷(例如倒數計時器、虛假社交證明),轉而支援乾淨的 CTA(電子郵件表單)與可選的動態裝飾。其安全措施包括嚴格的顏色表達式語法(防止 CSS 注入)、文字與 SVG 的 HTML 跳脫,以及透過 `checkValidity()` 進行的客戶端表單驗證。輸出之前,它會執行全面的 P0 品質檢查,驗證色彩一致性、模板合規性與單一 CTA。在所有檢查通過後,它會輸出一份準備好供開發人員或 AI 代理進一步自訂的成品。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LuzzyMeow/LuzzyRP/tree/HEAD/docs/skills/open-design/design-templates/waitlist-page

在你喜歡的 AI 中提問

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

說明文件

等待清單頁面技能

預先啟動頁面是你與未來用戶的第一次握手。這個技能打造了一個專注且誠實的入口:你的品牌識別、你正在開發的產品、以及一條加入早期清單的明確路徑。沒有虛假的稀缺性、沒有偽造的倒數計時、沒有灌水戰術——只是一個乾淨、行動優先的容器來承載真實的興趣。

工作流程

前置準備:載入強化模板與品牌基礎

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

步驟:帶有驗證與跳脫的 Token 替換

  1. 從輸入映射 Token — 對於模板中的每個佔位符(例如 {{PRODUCT_NAME}}、{{BG_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{LOGO_MARK}}),遵循以下替換規則:
    • 文字 Token ({{PRODUCT_NAME}}、{{TAGLINE}}):在插入 HTML 文字節點或屬性值之前,對 <、>、&、"、' 進行 HTML 跳脫。
    • HTML Token ({{LOGO_MARK}}):如果使用文字縮寫,預設對其進行 HTML 跳脫。如果使用內聯 SVG,你必須使用允許清單嚴格對其進行清理:移除 <script> 標籤、事件處理器 (on*)、<foreignObject>、外部引用 (href、xlink:href、url()),以及任何被禁止的屬性/元素,然後再插入。如果 SVG 無法被安全地清理,則回退到轉義的文字縮寫。絕不要輸出未經清理的原始任意 HTML。確保任何 SVG 都能在其容器內乾淨地縮放。
    • 顏色表達式 Token ({{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。
    • 字體名稱 Token ({{DISPLAY_FONT_CSS}}、{{BODY_FONT_CSS}}):這些是 CSS font-family 值,如果包含空格則已帶引號(例如 'DM Sans'、Syne)。直接插入到 --font-display 和 --font-body 宣告中;不要添加額外引號。
    • 字體 URL Token ({{DISPLAY_FONT_URL}}、{{BODY_FONT_URL}}):空格必須編碼為 + 以用於 Google Fonts URL(例如 DM+Sans、IBM+Plex+Serif)。在插入前驗證 URL 格式是否正確。
  2. 驗證 Token 映射規則 — 所有顏色 Token 現在都在 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 跳脫;顏色 Token 遵守嚴格的語法;字型已進行 URL 編碼
    • 通過 P0 否則不輸出。 如果任何 P0 閘門失敗,請詢問用戶或修復 Token 映射並重試。
  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}} Token 替換為已驗證/跳脫的值。
  • 在輸出前,執行 references/checklist.md 中的每個 P0 閘門;如果任何失敗,修復並重新驗證。

P0 閘門(必須通過):

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

P1 閘門(高品質提交應通過):

  • 主視覺區域在外觀上與眾不同且在摺頁之上。
  • 電子郵件提交按鈕具有懸停和活動狀態。
  • 表單驗證提供清晰回饋。
  • 頁面在所有行動裝置視口下可滾動(無裁剪);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 檢查清單閘門。請勿在迭代中跳過驗證。

相關技能