等待清單頁面技能
發布前頁面是你與未來用戶的第一次握手。此技能建立一個專注且誠實的入口:你的品牌識別、你正在打造的東西,以及一條加入早期清單的明確路徑。沒有虛假的稀缺性、沒有假的倒數計時、沒有膨脹的銷售手法——只有一個乾淨、以行動裝置為優先的容器,用以承載真實的興趣。
工作流程
前置作業:載入強化的模板與品牌基礎
- 載入品牌識別 — 讀取
DESIGN.md以取得顏色系統、字型配對與空間規則。這是你的基礎。等待清單頁面成敗與否,取決於與其所代表品牌的一致姓。如果找不到DESIGN.md,請要求使用者先提供一個再繼續。 - 讀取並複製可重複使用的模板 — 讀取
assets/template.html。這個模板是所有輸出的強化解決方案種子。將其複製為index.html作為你的基礎。不要從頭開始撰寫 HTML,也不偏離此結構。模板已內建所有必要的佈局、表單結構、裝飾、焦點樣式與無障礙基礎架構。
步驟:帶驗證與跳脫的標記替換
- 從輸入映射標記 — 針對模板中的每個佔位符(例如
{{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。按原樣插入:rootCSS 變數。如果 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 格式是否正確。
- 文字標記(
- 驗證標記映射規則 — 所有顏色標記現在都存在於 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}}(標誌首字母的對比文字顏色)
- 回應式佈局 — 模板包含以行動裝置為優先的縮放:
- 375px:表單堆疊為單欄,標誌縮小至 40px,裝飾壓縮,無水平捲動。
- 768px:舒適的雙欄呼吸空間。
- 1440px+:置中佈局,帶有充足的留白。
- 驗證所有文字保持可讀,且電子郵件輸入框與按鈕在 375×667 和 390×844 尺寸下完全可見(無裁切)。
驗證:輸出新版前執行強化的品質閘門
- 執行品質檢查清單 — 讀取
references/checklist.md。在輸出前驗證每個 P0 閘門:- 只有一個行動呼籲(電子郵件表單)
- 沒有倒數計時器、沒有虛假的社交證明、沒有表情符號
- 在 375px 寬度下無水平捲動
- 電子郵件輸入框具有
type="email"和required;名字沒有required - 表單沒有使用
novalidate;JS 使用checkValidity()保護 - 成功訊息具有
role="status"或aria-live="polite" - 所有顏色來自 DESIGN.md 或允許的備用值;沒有發明的十六進位值
- 所有使用者文字已進行 HTML 跳脫;顏色標記遵循嚴格語法;字型已進行 URL 編碼
- 通過 P0 否則不要輸出。 如果任何 P0 閘門失敗,請詢問使用者,或修正標記映射後重試。
- 驗證 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="">
輸出
- 輸出乾淨的 HTML — 單一檔案,CSS 內聯,圖形使用 SVG。使用
data-od-id標記互動元素(標題、表單、標誌、跑馬燈、網格等),以便代理無需解析即可自訂。
品質閘門
此技能強制執行基於模板的強化工作流程,以確保合規性。你必須遵循此執行路徑;偏離模板將導致輸出不合格。
強制性的基於模板執行:
- 讀取
assets/template.html作為你的基礎;不要從頭開始撰寫 HTML。 - 將其複製為
index.html,並僅將{{PLACEHOLDER}}標記替換為經過驗證/跳脫的值。 - 在輸出前運行
references/checklist.md中的每個 P0 閘門;如果任何失敗,修正並重新驗證。
P0 閘門(必須通過):
- 單一行動呼籲:電子郵件表單是唯一的互動元素。沒有導航、沒有次要按鈕、沒有社交連結。
- 標誌放置:固定在左上角,符合 DESIGN.md 的強調色,在行動裝置上縮小(50px → 40px)。
- 顏色一致性:每個顏色都來自 DESIGN.md 調色板。唯一允許的硬編碼例外:
#2D6A4F用於--success。 - 無反模式:無倒數計時器、無虛假社交證明、無表情符號圖示、無亂數假文。
- 內容完整性:標題與文案直接對應
product_name和tagline輸入——無填充文案。 - 行動裝置適應:在 375px 下無水平捲動。電子郵件輸入框與提交按鈕在 375×667 和 390×844 下完全可見(無裁切)。垂直溢位可滾動,而非隱藏。
- 字型紀律:僅顯示字型 + 主體字型(2 字型規則)。各區塊大小一致。
- 表單結構:兩個欄位(名字可選,電子郵件必填),
checkValidity()保護,帶有role="status"的成功訊息。 - 標記跳脫:所有使用者提供的文字已進行 HTML 跳脫;顏色標記遵循嚴格語法且不含不安全字元(
;、{}、<、>、/*、@、url();字型名稱已進行 URL 編碼;{{LOGO_MARK}}是跳脫的文字首字母或嚴格清洗過的內嵌 SVG(無腳本、無事件處理器、無 foreignObject、無外部 href)。
P1 閘門(為確保品質提交應通過):
- 英雄區塊視覺上獨特且在摺疊之上。
- 電子郵件提交按鈕具有懸停與啟用狀態。
- 表單驗證提供清晰反饋。
- 頁面在所有行動裝置視口均可滾動(非裁切);行動呼籲在無需滾動下可見。
- 跑馬燈動畫在
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 檢查清單閘門。
…
[為翻譯而截斷]