omd:landing — 壓倒性一頁式頁面 是做什麼的?
一個頁面透過滾動層層堆疊,壓倒訪客。不是排列卡片網格,而是
一個視覺概念從首屏誕生,在各個章節中以不同構圖變奏,最後在行動呼籲區收束。
品牌依據來自專案 DESIGN.md,構圖觀測來自登陸頁面技術法典(規則 ID LC-n),產品行為與在地決策權限則從簡報中讀取。
法典位置 — 儲存庫:docs/design-excellence/landing-craft-codex.md · 安裝版:node_modules/oh-my-design-cli/docs/design-excellence/landing-craft-codex.md
(兩者皆無時,以 node -p "require('path').dirname(require.resolve('oh-my-design-cli/package.json'))" 找出套件根目錄,再讀取其下的 docs/design-excellence/)。
若兩者皆未讀取,則不開始。
輸入
DESIGN.md全文(若為 Core v2 則包含 §Scope·Foundations·Components·Content·Motion 錨點;若為舊版則包含所有章節)。 僅使用此處的記號 — 禁止發明。.omd/preferences.md中的待處理事項可覆蓋 DESIGN.md。- 至少一行簡報:訪客應感受到什麼 + 應採取何種行動。若無簡報,則以一批問題(最多 5 個)來收集。
若為無人值守模式(
unattended),則為每個問題選擇第一個選項,並在trace.md中記錄為autoSelected。 - 法典
landing-craft-codex.md— 完整讀取規則表格,並選取本次執行要應用的規則 ID,記錄於故事板中。
執行目錄(先建立)
SLUG=$(printf '%s' "<brand-or-brief>" | tr '[:upper:] ' '[:lower:]-' | tr -cd 'a-z0-9-' | cut -c1-40)
RUN=.omd/runs/landing-$SLUG-$(date +%Y%m%d-%H%M)
mkdir -p "$RUN/assets" && printf '%s\n' "<브리프 원문 그대로>" > "$RUN/task.md"
<run> = 上方 $RUN。所有產出僅寫入此目錄(慣例同 omd-harness,並在 .omd/runs/INDEX.md 中附加一行)。
產出(僅限執行目錄內)
<run>/
concept.md 藝術總監產出 — 概念一句話、氛圍、調色盤使用方式、資產方向、禁止清單
storyboard.md 章節表格:順序·目的·視埠高度·構圖(LC-n)·資產計畫(提示詞)·滾動效果·文案架構
assets/ 生成圖片(omd:media 頻道) + 行內 SVG 原始檔
render.html 單一檔案(無外部請求),支援 1440·390 響應式,使用 IntersectionObserver 顯示,固定項目 ≤1,支援 reduced-motion
system.md 此頁面的設計系統說明(包含記號引用路徑)
loop-trace.json 自評回合中各項缺陷數量(render-integrity·landing-integrity·designer-review),autoSelected
trace.md 圖片提示詞原文、頻道、成本、sha256、重試記錄
程序
1. 概念(代理 omd-art-director)
從 DESIGN.md 的品牌事實(§1 敘事·§Principles·§Voice)與簡報中萃取一句概念。
概念不是形容詞列舉,而是頁面「展示了什麼」(例如:「展示付款流動的管道剖面圖」)。
藝術總監將概念、氛圍、資產方向、禁止事項(法典中的 anti-pattern + Vercel「generated-design reflexes」等)
寫入 concept.md。在建置前,於同一檔案中放置適用範圍表格:
決策 | 依據種類(品牌事實/具權限的專案決策/法典觀測) | 來源·目標表面 | 本次應用/未解決原因 | 驗證方法。
公開控制項的平凡觀測是該控制項的證據,而非禁止所有登陸頁面物件、3D 與照明的理由。
不將本地場景效果提升為企業事實,也不建立未經確認的記號。若來源與目標不同,則留下審查理由。
呼叫提示詞中已有的資產,以文字描述方式傳遞(主體·構圖·主色·留白位置;像素尺寸使用 sips -g pixelWidth -g pixelHeight)。
藝術總監不得以 Read 方式開啟圖片檔案 — 曾因大圖 tool_result 導致會話停滯(dogfooding 2026-09-02)。
2. 故事板
章節 6~8 個。每個章節需包含 (a) 目的一句話,(b) 視埠高度(引用法典的章節節奏規則),
(c) 構圖模式 — 法典表格中的模式名稱與 LC-n(bleed / inset / stacked / split / pinned-reveal …),
(d) 資產計畫 — 類型(照片/算圖/插畫/抽象 UI)·所呈現的產品狀態/意義·比例·佈局·主體畫面佔比目標·生成提示詞原文(在提示詞中鎖定品牌調色盤 hex 碼),(e) 滾動效果(顯示方式,持續時間與緩動曲線使用 DESIGN.md Motion 記號),(f) 文案架構。
指定一個壓倒時刻 — 頁面達到高潮的章節與其前的留白章節。
密度預算(以數字記錄 — 僅敘述會導致空白頁面)
僅靠數量與比例並不能證明場景有意義。保留以下數值,但須為每個資產規劃其呈現的產品狀態/意義及實際主體佔用面積(而非容器),並在渲染中確認。禁止為湊數而重複使用 SVG、同一張白紙的裁切/放大版、或無意義的衛星圖像。
與
omd-restraint的界線(LC-59 密度旋鈕)。 以下底線在旋鈕 ≥ 6(展示型登陸頁面)時全面適用。 若旋鈕 ≤ 5(產品·型錄·文件頁面),則omd-restraint的上限(首屏片段 ≤ 5、字型大小 ≤ 4、CTA ≤ 2 …)優先。 無論如何,R1(一個焦點)·R2(首屏片段)·R10(事實僅出現一次)維持不變。
- 媒體總量 ≥ 頁面 vh × 1.0。 若頁面為 12vh,則媒體至少 12 個。計算圖片、影片、有意義的行內 SVG (不計算單一圖示 — 僅計算 24px 以上、非裝飾、具內容意義者)。
- 首屏媒體 ≥ 3 個。 法典實測中 affinity 的首屏媒體為 8 個。
- 若使用橫向滾動(LC-15),則項目 ≥ 8 個。 3~4 個項目的橫向滾動不是密度閥門,而是空白行。
- 動態資產 ≥ 1 個。 若
omd:setup已設定影片頻道,則使用image_to_video將一個章節資產轉為 6 秒循環影片。 若設定了prefers-reduced-motion,則以相同幀的靜止圖片替代(自動播放·靜音·loop·playsinline)。 若無頻道,則在trace.md中記錄此事實 — 不可悄悄跳過。 - 各章節墨水面積目標 ≥ 26%(法典實測區間 26–54% 的下界)。若不足,則調整內距、主體大小、或必要的狀態呈現。
- 不可將垂直內距統一為固定 vh。 首次產出的所有章節均為
18vh/24vh,導致節奏單調 (中位數 = 最大值 = 378px)。密度較低的章節應減少內距,僅在壓倒時刻前後留下較大留白。
3. 資產
使用 omd:media 偵測到的頻道執行故事板中的提示詞(無頻道 → 將提示詞包與手動佇列
留在 assets/QUEUE.md,並在位置放置品牌調色盤的抽象 SVG 佔位圖 — 禁止使用圖庫或表情符號)。
禁止生成人物照片、禁止生成 Logo(文字商標)。在 trace.md 中記錄每個圖片的提示詞·頻道·成本。
失敗的生成需根據原因修正;頻道限制或佔位圖需連同實際數量記錄於 trace.md。
若一個原始場景已能滿足目的,則不增加複製品,直接以該構圖渲染審查版本。密度預算不足與
原始 checker FAIL 應保留原樣,提交至應用邊界審查。審查版本生成不視為完成·豁免·PASS。
圖片的比例應取自該圖片將放置的插槽的實際長寬比(禁止使用預設值 — omd:media §1)。
4. 建置
單一 render.html。CSS 變數直接使用 DESIGN.md 的記號名稱(--color-…, --space-…)。
重置 UA 預設樣式(figure/blockquote 邊距 — #78)。圖片使用 assets/ 相對路徑或 data URI。
動畫僅使用 transform 與 opacity,持續時間最多 3 種,@media (prefers-reduced-motion: reduce) 中全部停止。
文字最大寬度·字型階層·章節高度須在法典數值範圍內。
照片上的文字必須有遮罩(LC-36「壓倒必須可讀」):首屏·固定階段·反轉章節的導航·文字標記·主標題·
CTA·焦點環須超越背景像素對比 WCAG 4.5:1(一般)·3:1(大文字·UI);其手段為記號顏色的 alpha
遮罩(::before)與焦點環光暈 — 首次 toss 因無遮罩導致導航 1.05:1·文字標記 1.07:1 而收到 BLOCK 6。
muted 系列記號不得用於任何正文文字(包括眉題·法律聲明) — 對比僅 3.0:1。滾動顯示(opacity:0)須在
<noscript> 與 @media (scripting: none) 中全部顯示 — 無 JavaScript 時出現空白頁面視為缺陷。
對比·鍵盤需求與此技能的觸控操作性目標並非觀察到的品牌幾何。若現有記號組合無法滿足,
則在適用範圍表格中提出必要的在地決策,並遵循權限邊界。不得以品牌一致性為由豁免無障礙失敗。
5. 自評迴圈(最多 3 次 — 在所有適用檢查完成後判定)
在具有 test-v2/tools/ 的儲存庫中使用左側路徑;無則(已安裝套件)使用括號內的 omd 指令 — 為同一工具。
① node test-v2/tools/render-integrity.mjs <run>/render.html (安裝版: omd check render <run>/render.html) # 確定性
② node test-v2/tools/landing-integrity.mjs <run>/render.html (安裝版: omd check landing <run>/render.html) # 法典機械規則
②′ node test-v2/tools/text-contrast.mjs <run>/render.html (安裝版: omd check contrast <run>/render.html) # 照片·漸層上文字·焦點環·無 JS(前兩次 run 的 BLOCK 系列)
③ 實際路由的 1440·390 螢幕截圖:對照故事板檢查各章節邊界與 hero·peak·行為·結果狀態
③-b LI-24~26 密度底線(螢幕墨水 12%·首屏媒體 3 個·媒體 1 個/vh)的原始判定與應用邊界審查一併記錄
④ `omd-designer-review` 子代理啟動(Agent,輸入:`<run>/render.html` 絕對路徑 + 專案 DESIGN.md 路徑 + 工具呼叫上限 20 次·15 分鐘·先給 review.md 骨架 — 僅統計 BLOCK)
③ 不止於截圖。實作者須直接檢視圖片,確認標題·主體·對應控制項·結果是否位於畫面內。
不可將大 section 的 scrollIntoView 中間裁切誤認為章節開頭。結合 viewport·滾動位置·狀態·output hash,
若畫面被裁切則重新截取。滾動/鏡頭路徑亦須以實際輸入驗證,不得僅憑 QA seek 主張連續性。
記錄各資產主體面積的測量方式與實測值,與佔比目標進行比對。若為估計值則標示「估計」。
若頁面包含行為,則實際執行適用項目:empty → 錯誤輸入的行內錯誤 → correction → save → reload, 鍵盤進入/執行/返回,渲染的觸控目標 ≥44×44 CSS px(此技能的操作性目標,正文行內連結除外),無 JS·reduced-motion 替代方案。 錯誤需確認欄位關聯·focus·aria-invalid;儲存結果需確認對應內容與持久性。不適用項目(如無儲存功能的頁面) 則記錄 task 理由,且不以開發者狀態切換器替代行為。
僅修正 FAIL 項目。在 loop-trace.json 中記錄各工具的缺陷·行為證據·畫面確認·④BLOCK·未執行項目。
即使①②已 PASS,仍不可跳過對比·行為·實際畫面·獨立審查。僅在完成所有適用檢查且無未解決 FAIL/BLOCK 時,
才算驗證完成。若缺陷未減少,或相同規則 ID 連續兩次 FAIL,則停止修正迴圈並提交 omd:issue。
中斷不視為成功,且須保留未執行的檢查。來源衝突審查與原始 checker 判定應分開保存,不製作任意豁免。
6. 展示
使用 omd:showcase <run>/render.html 製作滾動影片(mp4/gif);若無則使用
test-v2/content-runs/build-scroll-compare.mjs 擷取幀 → ffmpeg。底部須顯示非正式聲明。
區分實際輸入影片與靜止幀蒙太奇。驗證結果與使用者的視覺採用應分開報告;
在使用者實際採用該結果之前,不得主張美學批准或採用完成。
法典應用摘要(全文見法典;此處說明各階段應參考哪些規則)
| 階段 | 規則 | 核心數值(實測,5 個網站) |
|---|---|---|
| 概念·首屏 | LC-1 | 首屏資產覆蓋 viewport 的 89 |
| 節奏 | LC-8~12, LC-14 | 頁面 10 |
| 構圖·留白 | LC-4~7 | 章節的 46 |
| 資產 | LC-17~20, §6 表格 | 每頁 29 |
| 字型 | LC-21~25 | display:body 3.0 |
| 色彩·轉換 | LC-26~28 | 維持一個底色(252 或 12);反轉僅用於一個章節(強調裝置);色調約為 240,240,252 |
| 動畫 | LC-13, LC-29~32 | 主導持續時間一個(100/300/320/400ms,33 |
| 自評 | LI-1~23 · #86 | landing-integrity.mjs 進行機械判定(頁面 vh·章節比例·首屏覆蓋率·字型比·gutter·持續時間·easing·snap·影片屬性·圖庫主機·均勻卡片網格·h1);text-contrast.mjs 處理照片上文字對比·焦點環·無 JS |
硬性規則
- 禁止發明 DESIGN.md 中不存在的記號·品牌事實。禁止發明法典中不存在的「品味」規則 — 無依據的判斷須在
concept.md中標示為「假設」。 - 法典數值與 DESIGN.md 記號衝突時,DESIGN.md 優先(例如:法典 LC-21 display:body 3.0×↑ 與 Toss h1 36/body 14 = 2.57× 衝突時)。 先確認適用對象是否相同,並在適用範圍表格中記錄範圍不足與理由。此非自動 PASS。對於缺少 Motion 記號的 DESIGN.md(多數), 使用法典 LC-29/30 的值(300/400ms 等)時須標示為**「在地擴展」**。
- 禁止使用實際網站文案·截圖·Logo 原始檔。禁止發明統計數據。
- 僅建立一個頁面。若要求增加頁數,則交由
omd:autopilot(多頁面)處理。 - 此技能為生成器。判定由工具與
omd-designer-review執行 — 不可自行聲稱「良好」。