open-design-landing
建立一個單頁編輯登陸網站(或簡報——請見兄弟技能
open-design-landing-deck)
採用 Atelier Zero 設計系統:溫暖紙張背景、Inter
Tight + Playfair Display、斜體襯線強調標示、虛線分隔線、
珊瑚色終止點、滾動顯現動畫,以及 16 張超現實拼貼圖板。
這是 Open Design 行銷頁面的正統做法——範例輸出就是你現在看到的頁面 open-design。
此技能完全參數化。代理程式從使用者的簡報中填入一個 typed
inputs.json;組合器將該 JSON + 正統 styles.css
轉化為可部署的成品。
inputs.json + styles.css 16 個圖片插槽
│ │
└──────────► scripts/compose.ts ◄────────────┘
│
▼
<out>/index.html (自包含)
<out>/assets/ (PNG 或 SVG)
你會得到什麼
一個內含所有下列元素的單一 HTML 檔案:
- 編輯列頂欄(卷次 / 期號 / 語言選項)、Headroom 風格的 固定導覽列,帶有即時 GitHub 星星數。
- 8 個羅馬數字編號區段,使用紙紋背景: 英雄區(含 3 個統計環 + 4 步驟索引)、關於、能力(4 張卡片)、 實驗室(5 張卡片 + 篩選標籤 + 進度條)、方法(4 步驟含縮圖)、 精選作品(深色區塊 + 2 張傾斜卡片)、推薦(引言引用 + 5 個合作夥伴標誌)、 行動呼籲(緞帶 + 電子郵件膠囊)。
- 頁尾含 4 欄連結 + 大型斜體襯線關鍵字。
- 每個區段的滾動顯現動畫(IntersectionObserver,
尊重
prefers-reduced-motion)。 - 在 1280 / 1080 / 880 / 560 中斷點完全響應。
工作流程合約
依序執行以下四個步驟。代理程式應完成每個步驟後再進行下一步, 並優先針對焦點問題提問,而非自行發想文案。
1. 收集品牌資訊
使用 AskQuestion(或你 UI 中的等價功能)分段收集品牌
簡報;不要將整個 schema.ts 拋給使用者。將他們的回答
對應填入符合 typed 形狀的 inputs.json。
八個提問群組,依序如下:
| 群組 | Schema 欄位 | 最少答案 | 注意事項 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = 單一字形(Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URL 為必填;授權預設為 Apache-2.0 |
| 3 | nav[](最多 5 個) | 3 | 可選計數徽章 |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | 全部 | Headline 為 MixedText (sans+em+dot) |
| 5 | about + capabilities.cards[4] | 全部 | 4 張卡片 × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | 全部 | 兩個網格均為固定數量 |
| 7 | work.cards[2] + testimonial | 全部 | 5 個合作夥伴標誌圖形,使用內聯 SVG 路徑資料 |
| 8 | cta + footer.{columns[4],mega} | 全部 | Mega kicker 是 MixedText,類似標題 |
開啟 inputs.example.json 查看完整的
工作範例(Open Design 本身)。
2. 決定圖片策略
| 策略 | 何時選擇 | 成本 / 延遲時間 |
|---|---|---|
placeholder | 第一版。展示。內部簡報。尚無圖片預算。 | $0, <1s |
generate | 最終交付。品牌想要原創拼貼。 | ~$0.40, ~6 min |
bring-your-own | 使用者已有藝術指導方向的 PNG。直接放入 assets_path。 | $0, 0s |
據此設定 inputs.imagery.strategy。
placeholder — 框架模式
npx tsx scripts/placeholder.ts <out>/assets/
產生 16 個 .svg 檔案(附帶 .png 別名以確保相容性)到
<out>/assets/ 目錄中。每個佔位符會顯示插槽 ID、比例、
像素尺寸以及來自 image-manifest.json 的提示提示。
組合器的 <img src='./assets/hero.png'> 等就能直接運作。
generate — gpt-image-2 模式
FAL_KEY=... npx tsx scripts/imagegen.ts <inputs.json> --out=<out>/assets/
對每個插槽呼叫 fal.ai 的 openai/gpt-image-2 同步端點。
組合提示:風格錨點(紙張拼貼編輯系統)
- 品牌變數(從
inputs.json取得的品牌名稱 / 導覽 / 標題 / 斜體強調) - 每個插槽的構圖(例如:裁切石膏頭像 + 樹穿過拱門)。
若目標檔案已存在則跳過該插槽;傳遞
--force重新渲染。
若無 FAL_KEY,腳本會列印提示,讓操作員可以手動透過 /gpt-image-fal 斜線指令技能路由它們。
bring-your-own
將符合 assets/image-manifest.json 檔案名稱的 16 個 PNG 放到
inputs.imagery.assets_path。完成。
3. 組合成品
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
組合器讀取 inputs.json 和 ../styles.css,然後寫入一個
自包含的 HTML 檔案。該頁面包含:
- 完整的 Atelier Zero 樣式表,已內嵌。
- 所有區段標記,帶有
data-reveal屬性以實現交錯的滾動 動畫。 - 內嵌 IntersectionObserver 腳本(鏡像
apps/landing-page/app/_components/reveal-root.tsx)。 - 內嵌 Headroom 導覽腳本(鏡像
header.tsx)。 - 內嵌 GitHub 星星數擷取器(從
brand.primary_url自動偵測)。
4.(可選)鏡像可部署的 Astro 網站
若需要可部署的正式輸出,請複製 apps/landing-page/
套件:將其拷貝到你的工作區,將 app/page.tsx 的內容與你的
inputs.json 對齊,並將你的 <out>/assets/*.png 複製到
app/image-assets.ts / R2 URL 所期望的路徑。使用
pnpm --filter @open-design/landing-page build 建構,產生靜態 out/
匯出,即可部署到任何 CDN。
未來版本可能會捆綁一個組合器,能從
inputs.json一步產生完整的apps/landing-page/目錄結構。在此之前,複製並編輯是目前支援的路徑。
交付前自我檢查
在標記為完成之前,代理程式必須驗證:
-
<out>/index.html可在瀏覽器中開啟,無主控台錯誤。 - 所有 16 個圖片插槽載入成功(DevTools 網路標籤中無 404)。
- 標題的斜體強調標示以 Playfair 字型呈現(非 sans)。
- 每個
display級別的 h1/h2 結尾處出現珊瑚色終止點。 - 從頂部滾動到底部;每個區段播放一次動畫。
- 調整至 880px 和 560px 寬度;無橫向滾動條,無重疊。
-
prefers-reduced-motion: reduce(DevTools → Rendering)可乾淨地 停用過渡效果。 - Lighthouse:對比度 AA,字型顯示交換,英雄區無版面位移 (CLS < 0.05)。
技能中的檔案
skills/open-design-landing/
├── SKILL.md # 本合約
├── README.md # 快速入門
├── schema.ts # typed 輸入(單一事實來源)
├── styles.css # Atelier Zero 樣式表(單一事實來源)
├── inputs.example.json # Open Design 作為工作範例
├── example.html # 正統渲染(從 inputs.example.json 重新產生)
├── scripts/
│ ├── compose.ts # inputs.json + styles.css → index.html
│ ├── imagegen.ts # gpt-image-2 包裝器(fal.ai)
│ └── placeholder.ts # SVG 紙紋框架
└── assets/
├── *.png # 16 張拼貼圖板(Open Design 實例)
├── image-manifest.json # 插槽 → 檔案/尺寸/提示對應
└── imagegen-prompts.md # 人類可讀的提示包
邊界
- 不要發明新顏色或字型。Token 定義在
design-systems/atelier-zero/DESIGN.md中;先在設計系統中延伸 再加入新的色票。 - 不要從產生的標記中刪除
data-reveal屬性。 少了它們,頁面會變成靜態而顯得死氣沉沉。 - 不要將組合出的 HTML 包裝在會注入自身樣式表順序的框架中—— Atelier Zero 依賴樣式表順序級聯來實現紙紋以及側軌道的 z-index。
- 不要為 Astro 登陸頁面分支添加獨立的樣式表檔案;直接將
styles.css逐字複製到app/globals.css,以保持視覺上的一對一一致性。
另請參閱
design-systems/atelier-zero/DESIGN.md— token 規格。apps/landing-page/— 可部署的 Astro 靜態對應專案。skills/open-design-landing-deck/— 重複使用此設計系統的兄弟簡報技能。
