open-design-landing 是做什麼的?
建立一個單頁編輯型登陸頁面(或投影片組——請參閱同系列的
open-design-landing-deck 技能)
採用 Atelier Zero 設計系統:溫暖紙張背景、Inter Tight
- Playfair Display、斜體襯線強調字元、虛線分隔線、珊瑚色 終止圓點、滾動揭示動畫,以及 16 張超現實拼貼圖板。
這是 OpenDesign 行銷頁面的標準配方——範例輸出就是您在 open-design 看到的頁面。
此技能已完全參數化。代理會根據使用者的簡報填寫一個型別化的
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 個合作夥伴圖示)、 CTA(緞帶 + 電子郵件按鈕)。
- 頁尾含 4 個連結欄 + 巨大的斜體襯線 kicker 字。
- 每個章節的滾動揭示動畫(IntersectionObserver,尊重
prefers-reduced-motion)。 - 在 1280 / 1080 / 880 / 560 斷點上完全響應式設計。
工作流程合約
請依序執行以下四個步驟。代理應在繼續下一步前完成 每個步驟,並優先向使用者提出聚焦的問題,而非自行編造文案。
1. 收集品牌資訊
使用 AskQuestion(或您平台中的等效功能)逐步收集品牌簡報;
請不要將完整的 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 為必填;license 預設 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 path 資料提供 |
| 8 | cta + footer.{columns[4],mega} | 全部 | Mega kicker 是像標題那樣的 MixedText |
請開啟 inputs.example.json 查看完整的
實際範例(即 OpenDesign 本身)。
2. 決定圖片策略
| 策略 | 何時選擇 | 成本 / 延遲 |
|---|---|---|
placeholder | 初次製作。示範用途。內部投影片。尚無圖片預算。 | $0,<1s |
generate | 最終交付。品牌想要原創拼貼圖。 | ~$0.40,約 6 分鐘 |
bring-your-own | 使用者已有藝術指導用的 PNG。直接放到 assets_path。 | $0,0s |
相應地設定 inputs.imagery.strategy。
placeholder — 框架模式
npx tsx scripts/placeholder.ts <out>/assets/
在 <out>/assets/ 中寫入 16 個 .svg 檔案(並為相容性建立 .png
別名)。每個預留位置顯示插槽 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
將 16 個 PNG 檔案(檔名需符合 assets/image-manifest.json)放置在
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 建置,以產生可匯出到
任何 CDN 的靜態 out/ 目錄。
未來版本可能提供一個編排器,能從
inputs.json一步產生完整的apps/landing-page/目錄樹。在此之前,複製並編輯是支援的做法。
交付前的自我檢查
在標記完成之前,代理必須驗證:
-
<out>/index.html可在瀏覽器中開啟,且無控制台錯誤。 - 所有 16 個圖片插槽均已載入(DevTools 網路分頁中無 404 錯誤)。
- 標題中的斜體強調字元以 Playfair 字型渲染(而非 sans-serif)。
- 每個
display層級的 h1/h2 結尾處出現珊瑚色終止圓點。 - 從頂部滾動到底部;每個章節都會動畫顯示一次。
- 調整視窗大小至 880px 和 560px;無水平滾動條,無重疊。
-
prefers-reduced-motion: reduce(DevTools → 算繪)能乾淨地 停用轉場效果。 - Lighthouse:對比度 AA、font-display swap、英雄區無佈局變動 (CLS < 0.05)。
此技能中的檔案
design-templates/open-design-landing/
├── SKILL.md # 此合約
├── README.md # 快速入門
├── schema.ts # 型別化的輸入(單一事實來源)
├── styles.css # Atelier Zero 樣式表(單一事實來源)
├── inputs.example.json # 以 OpenDesign 為實際範例
├── 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 張拼貼圖板(OpenDesign 實例)
├── 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 靜態對應版本。design-templates/open-design-landing-deck/— 同系列投影片技能,重用此設計系統。
