Communitygithub.com

open-design-landing

產生世界級的單頁編輯式落地頁面,採用 Atelier Zero 視覺語言(Monocle / Apartamento / Études 編輯拼貼風格)——與 Open Design 自身行銷頁面相同的美學。Agent 會根據品牌簡報填入型別化的 `inputs.json`,可選擇透過 gpt-image-2 生成 16 張拼貼素材,接著執行純函數組合器輸出獨立的 HTML 檔案;另一條路徑可鏡像 Astro 行銷站點於 `apps/landing-page/`。自動整合捲動觸發動畫與 Headroom 風格的固定導航列。

open-design-landing 是什麼?

這個技能致力於建立一個世界級的單頁編輯式落地頁面,完全以 Atelier Zero 設計系統為基礎,展現如 Monocle、Apartamento 或 Études 等雜誌般的拼貼美學。它透過 Agent 自動與使用者互動,收集品牌資訊(如名稱、標語、導航連結等),並填充一個結構嚴謹的 `inputs.json`,再透過純函數組合器將內容與規範的 CSS 樣式表合併,產生一個完全自包含的 HTML 檔案,其中已內嵌所有樣式、字型與必要的 JavaScript(例如 IntersectionObserver 實現的捲動觸發動畫、Headroom 風格固定導航列)。此技能支援三種圖片策略:無成本且快速的佔位 SVG 框架模式、透過 fal.ai 或 Azure 的 gpt-image-2 服務生成 16 張原創拼貼素材的模式,以及使用者自行提供已準備好圖片的模式。此外,它也提供一個選用流程,可將產生的內容鏡像複製到一個可部署的 Astro 專案中,作為正式上線的版本。這個技能專為需要頂級、雜誌風格與高性能行銷頁面的創辦人、設計工作室或開源項目的維護者設計,並支援在任何現代瀏覽器或 Astro 架構上運作。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Keimoshi/Silverloft/tree/HEAD/open-design-port/skills/open-design-landing

在你喜歡的 AI 中提問

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

預覽

來自技能 README

open-design-landing preview

說明文件

open-design-landing 是做什麼的?

建立一個單頁編輯式落地頁面(或一組投影片——請參閱兄弟技能 open-design-landing-deck),採用 Atelier Zero 設計系統:暖紙色背景、Inter Tight 與 Playfair Display 字型、斜體襯線強調標記、虛點細線分隔、珊瑚色終止圓點、捲動觸發動畫,以及 16 張超現實拼貼圖板。

這是標準的 Open Design 行銷頁面配方——範例輸出正是您在 open-design 看到的頁面。

此技能完全參數化。Agent 會根據使用者的簡報填入一個型別化的 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 斷點。

工作流程合約

請按順序執行以下四個步驟。Agent 應在移至下一步前完成當前步驟,並寧可向使用者提出一個聚焦的問題,也不要自行編造文案。

1. 收集品牌輸入

使用 AskQuestion(或您 UI 中的等效功能)分段收集品牌簡報;請不要將整個 schema.ts 傾倒給使用者。將他們的回答映射到符合型別形狀的 inputs.json 中。

八個問題組,按順序:

組別Schema 欄位最少答案數備註
1brand.{name,mark,tagline,description,location}5Mark = 單一字元 (Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL 為必填;license 預設 Apache-2.0
3nav[] (最多 5 個)3可選的計數徽章
4hero.{label,headline,lead,primary,secondary,stats}全部Headline 為 MixedText(無襯線+斜體+圓點)
5about + capabilities.cards[4]全部4 張卡片 × {num,tag,title,body}
6labs.cards[5] + method.steps[4]全部兩個網格固定數量
7work.cards[2] + testimonial全部5 個合作夥伴標記為內聯 SVG 路徑資料
8cta + footer.{columns[4],mega}全部Mega kicker 是像標題一樣的 MixedText

打開 inputs.example.json 查看一個完整的運作範例(Open Design 自身)。

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/

將 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

將 16 個與 assets/image-manifest.json 檔名匹配的 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 建置,以獲得一個準備好在任何 CDN 上使用的靜態 out/ 匯出。

未來的迭代可能會捆綁一個組合器,該組合器可以一條指令從 inputs.json 生成完整的 apps/landing-page/ 樹。在此之前,複製並編輯是支援的路徑。


交付前自我檢查

在標記完成前,Agent 必須驗證:

  • <out>/index.html 在瀏覽器中開啟,無控制台錯誤。
  • 所有 16 個圖片插槽均已載入(在 DevTools 網路標籤中無 404 錯誤)。
  • 標題斜體強調標記以 Playfair 字型呈現(非無襯線字型)。
  • 每個 display h1/h2 結尾處出現珊瑚色終止圓點。
  • 從上到下滾動;每個區塊依序播放一次動畫。
  • 調整大小至 880px 和 560px;無橫向滾動條,無重疊。
  • prefers-reduced-motion: reduce(DevTools → Rendering)能乾淨地停用轉場效果。
  • Lighthouse:對比度 AA、font-display 交換、主視覺無版面位移(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  # 人類可讀的提示包

邊界

  • 請勿發明新的顏色或字型。令牌位於 design-systems/atelier-zero/DESIGN.md 中;在新增新的色階之前,請先擴展設計系統。
  • 請勿從生成的標記中移除 data-reveal 屬性。沒有它們,頁面將變得靜態且感覺死氣沉沉。
  • 請勿將組合後的 HTML 包裝在會注入自身樣式表順序的框架中——Atelier Zero 依賴樣式表的級聯順序來實現紙質紋理和側邊欄的 z-index。
  • 請勿為 Astro 落地頁面的複製版本新增獨立的樣式表檔案;直接將 styles.css 照原樣複製到 app/globals.css 中,以確保視覺一致性。

另請參閱

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能