open-design-landing
建立一個單頁編輯型登陸網站(或幻燈片組——請參閱同類的 open-design-landing-deck 技能),採用 Atelier Zero 設計系統:暖紙背景、Inter Tight + Playfair Display 字體、斜體襯線強調間距、虛線分隔線、珊瑚色終止點、捲動揭示動畫,以及 16 張超現實拼貼圖版。
這是標準的 Open Design 行銷頁面配方——產出的範例即為您於 open-design 所見的頁面。
此技能為完全參數化。AI 會根據使用者的簡報填入一個型別明確的 inputs.json;composer 將該 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 個合作夥伴標誌)、行動呼籲(緞帶 + 電子郵件藥丸)。
- 包含每個章的
data-reveal屬性,用於交錯的捲動動畫效果。 - 內嵌的 IntersectionObserver 腳本(鏡像
apps/landing-page/app/_components/reveal-root.tsx)。 - 內嵌的 Headroom 導覽腳本(鏡像
header.tsx)。 - 內嵌的 GitHub 星數擷取器(自動從
brand.primary_url偵測)。 - 完全響應式,支援 1280 / 1080 / 880 / 560 斷點。
工作流程合約
請依序執行以下四個步驟。AI 應在繼續下一步前完成每個步驟,並優先向使用者提出聚焦的問題,而非自行編造文案。
1. 收集品牌輸入
使用 AskQuestion(或您 UI 中的等效功能)分塊收集品牌簡報;不要將整個 schema.ts 傾倒給使用者。將他們的答案映射到符合型別形狀的 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(無襯線+斜體+點) |
| 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 | 首次建置。展示。內部簡報。尚無圖片預算。 | 免費,<1 秒 |
generate | 最終交付。品牌想要原創拼貼。 | 約 $0.40,約 6 分鐘 |
bring-your-own | 使用者已有美術指導的 PNG。將它們放入 assets_path。 | 免費,0 秒 |
相應地設定 inputs.imagery.strategy。
placeholder — 框架模式
npx tsx scripts/placeholder.ts <out>/assets/
寫入 16 個 .svg 檔案(為相容性加上 .png 別名)至 <out>/assets/。每個佔位圖會顯示槽位 ID、比例、像素尺寸以及來自 image-manifest.json 的提示提示。Composer 的 <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
將 16 個與 assets/image-manifest.json 檔名相符的 PNG 放入 inputs.imagery.assets_path。完成。
3. 組合產出
npx tsx scripts/compose.ts <inputs.json> <out>/index.html
Composer 會讀取 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/ 套件:將它複製到您的工作空間,根據 inputs.json 的內容調整 app/page.tsx,並將您的 <out>/assets/*.png 複製到 app/image-assets.ts / R2 URL 所預期的路徑。使用 pnpm --filter @open-design/landing-page build 建置,以產生準備好部署到任何 CDN 的靜態 out/ 匯出。
未來的版本可能會捆綁一個 composer,能夠透過一個指令從
inputs.json產生完整的apps/landing-page/目錄樹。在此之前,複製並編輯是受支援的方式。
交付前的自我檢查
在標記為完成之前,AI 必須驗證:
-
<out>/index.html能在瀏覽器中打開,且無控制台錯誤。 - 所有 16 個圖片槽位皆正確載入(開發者工具網路分頁中無 404 錯誤)。
- 標題的斜體強調間距正確顯示為 Playfair(而非無襯線字體)。
- 每個
display級別的 h1/h2 結尾處皆出現珊瑚色終止點。 - 從頭捲動到尾端;每個章節都應動畫顯示一次。
- 調整視窗大小至 880px 及 560px;無水平捲軸,無重疊。
-
prefers-reduced-motion: reduce(開發者工具 → 渲染)能乾淨地停用轉場效果。 - Lighthouse 檢查:對比度 AA 標準、font-display swap、英雄區無版面位移(CLS < 0.05)。
本技能包含的檔案
skills/open-design-landing/
├── SKILL.md # 此合約
├── README.md # 快速入門
├── schema.ts # 型別化輸入(單一事實來源)
├── 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/— 同類的幻燈片技能,重複使用此設計系統。
