Communitygithub.com

omd:landing — 壓倒性一頁式頁面

基於 DESIGN.md 與登陸頁面技術法典,打造從首屏到行動呼籲區、由單一視覺概念貫穿、以滾動敘事壓倒訪客的一頁式頁面。觸發關鍵字:'랜딩 페이지'、'원페이지'、'landing page'、'one-pager'、'hero to footer'、'스크롤 랜딩'、'affinity.studio 같은'。

omd:landing — 壓倒性一頁式頁面 是什麼?

omd:landing 是一個高度專業化的 AI 代理技能,用於生成「壓倒性」的一頁式登陸頁面。它不是簡單地排列卡片,而是從設計概念文件(DESIGN.md)中萃取一個視覺概念,並透過滾動觸發的章節變奏,將概念從首屏貫穿至行動呼籲區。該技能強制依賴兩項核心文件:專案的 DESIGN.md(品牌事實與設計記號)與登陸頁面技術法典(landing-craft-codex.md,含實測佈局規則),並禁止發明品牌中不存在的元素。 支援的平台為任何可執行 Node.js 與 omd 工具的環境(如 Claude Code, Cursor, Codex 等可執行自訂代理的 IDE 或 CLI 工具)。工作流程包含:藝術總監概念生成、故事板規劃(6–8 個章節,附密度預算、資產類型與滾動效果)、資產生成(透過 omd:media 頻道)、獨立 render.html 建置(含響應式設計與輔助功能)、以及最多三輪的自評循環(使用 render-integrity、landing-integrity、text-contrast 等工具與設計師審查)。 此技能的獨特之處在於其嚴格的數據驅動規則:所有佈局數值(如首屏媒體覆蓋率 89–130%、文字比例、章節高度 10–16vh)均來自五個頂級網站的實測統計,並強制執行對比度(WCAG 4.5:1)與可及性要求。若自我評估未通過所有機器檢查或設計師審查,代理將記錄缺陷並提交問題,而非聲稱「合格」。簡而言之,這是一個為追求極致視覺品質與品牌一致性而設計的、近乎固執的登陸頁面生成技能。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nococn/omd-landing/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

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/)。 若兩者皆未讀取,則不開始。

輸入

  1. DESIGN.md 全文(若為 Core v2 則包含 §Scope·Foundations·Components·Content·Motion 錨點;若為舊版則包含所有章節)。 僅使用此處的記號 — 禁止發明。.omd/preferences.md 中的待處理事項可覆蓋 DESIGN.md。
  2. 至少一行簡報:訪客應感受到什麼 + 應採取何種行動。若無簡報,則以一批問題(最多 5 個)來收集。 若為無人值守模式(unattended),則為每個問題選擇第一個選項,並在 trace.md 中記錄為 autoSelected。
  3. 法典 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-13, LC-3336首屏資產覆蓋 viewport 的 89130% 且至少兩邊出血;標題位於上方 1/3 (17.639.7 %vh);左側錨點 5.4~14.4 %vw;高潮來得早、以規模呈現(前一個章節文字比例最低 → 下個章節最高)
節奏LC-8~12, LC-14頁面 1016 vh(固定項目除外);正文章節中位數 1.01.9 vh;固定階段正好 1 個 viewport;顯示 0.1~6.8/viewport 依旋鈕而定;禁止垂直 snap
構圖·留白LC-4~7章節的 4674% 為空白;文字佔章節的 2.613.6%;兩條車道(出血 1440 + 閱讀 672/1232/1264);一個 gutter(48/88/92/104px)貫穿全頁
資產LC-17~20, §6 表格每頁 2963 張·每章節 37 張;出血資產 16:9;佈局僅有出血或 inset(圓角邊·下方裁切)兩種;圖庫 0 — 僅產品·客戶作品
字型LC-21~25display:body 3.04.6×(襯線體則 7×);正文 1417px;UI 階層 1.051.20,最上方一次跳躍 1.331.75;字重對比小(可為 300/300);僅拉丁 display 使用 −0.02em
色彩·轉換LC-26~28維持一個底色(252 或 12);反轉僅用於一個章節(強調裝置);色調約為 240,240,252
動畫LC-13, LC-29~32主導持續時間一個(100/300/320/400ms,3370%);23 階段,第二階段 1.3~1.6×;僅 opacity(+transform),clip-path·filter 為 0;reduced-motion 必備
自評LI-1~23 · #86landing-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 執行 — 不可自行聲稱「良好」。

相關技能