等待清單頁面技能 (Waitlist Page Skill)
上市前的頁面是你與未來使用者的第一次握手。這個技能建立一個專注且誠實的入口:你的品牌識別、你正在打造的產品,以及一條加入早期名單的明確路徑。沒有虛假的稀缺感、沒有虛假的倒數計時、沒有膨脹的戰術——只是一個乾淨、行動裝置優先的容器,用來承載真誠的興趣。
工作流程
前置作業:載入強化模板與品牌基礎
- 載入品牌識別 — 讀取
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+:置中佈局,附有寬敞的空白區域。
- 驗證所有文字保持可讀,並且 Email 輸入框和提交按鈕在 375×667 和 390×844 解析度下完全可見(沒有被裁剪)。
驗證:在輸出前執行強化品質檢查
- 執行品質檢查清單 — 讀取
references/checklist.md。在輸出前,驗證每一個 P0 關卡:- 恰好一個 CTA(Email 表單)
- 沒有倒數計時器、沒有虛假的社交證明、沒有 emoji
- 在 375px 下沒有水平捲動
- Email 輸入框有
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 鍵盤支援
- WCAG AA 對比度:內文 ≥4.5:1,按鈕標籤 ≥4.5:1
- 標誌的 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 關卡(必須通過):
- 單一 CTA:Email 表單是唯一的互動元素。沒有導航、沒有次要按鈕、沒有社交連結。
- 標誌位置:固定在左上角,符合 DESIGN.md 的強調色,在行動裝置上縮放(50px → 40px)。
- 色彩一致性:每個顏色都來自 DESIGN.md 調色盤。唯一允許的硬編碼例外:
#2D6A4F用於--success。 - 無反模式:沒有倒數計時器、沒有虛假社交證明、沒有 emoji 圖示、沒有 lorem ipsum。
- 內容完整性:標題和文案直接對應
product_name和tagline輸入——沒有填充內容。 - 行動裝置相容性:在 375px 下沒有水平捲動。Email 輸入框和提交按鈕在 375×667 和 390×844 下完全可見(無裁剪)。垂直溢出可捲動,不隱藏。
- 字體規範:僅使用顯示字體 + 內文字體(2 字體規則)。跨區塊大小一致。
- 表單結構:兩個欄位(名字為選填,Email 為必填),
checkValidity()保護,成功訊息帶有role="status"。 - 代碼跳脫:所有使用者提供的文字已進行 HTML 跳脫;色彩代碼遵循嚴格語法且不包含不安全字元(
;,{},<,>,/*,@,url();字型名稱已進行 URL 編碼;{{LOGO_MARK}}是已跳脫的文字縮寫或經過嚴格清理的內嵌 SVG(無腳本、無事件處理器、無 foreignObject、無外部 href)。
P1 關卡(為獲得高品質提交結果,建議通過):
- 主視覺區塊視覺上醒目且在折頁上方。
- Email 提交按鈕有懸停和啟用狀態。
- 表單驗證提供清晰回饋。
- 頁面在所有行動裝置視口下可捲動(無裁剪);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="即將推出 — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>
在成品上方放置一行描述;下方不要有任何內容。
輸出後: 如果使用者要求更改,請就地更新 index.html,並在輸出下一個版本之前重新執行 P0 檢查清單關卡。不要在迭代時跳過驗證。