Communitygithub.com

open-design-landing

建立一個採用 Atelier Zero 視覺語言的單頁式編輯型登陸頁面(或投影片組),包含溫暖紙張背景、滾動揭示動畫與 Headroom 式黏性導覽列。

open-design-landing 是什麼?

此技能專為 AI 代理(如 Claude Code、Codex)設計,能根據品牌簡報自動建立世界級的單頁編輯型登陸頁面。它採用 OpenDesign 行銷頁面所使用的「Atelier Zero」設計系統,包含溫暖紙張背景、Inter Tight 與 Playfair Display 字型、斜體襯線強調、虛線分隔線、珊瑚色終止圓點以及滾動揭示動畫。代理會依序執行四個步驟:首先透過詢問使用者收集品牌資訊,並填寫型別化的 `inputs.json` 檔案;接著根據預算與時間選擇圖片策略(佔位符、透過 gpt-image-2 生成,或自備資產);然後執行 `compose.ts` 腳本,將 JSON 與 `styles.css` 合併成一個自包含的 HTML 檔案;最後可選擇性地將內容鏡像至 `apps/landing-page/` 的 Astro 行銷網站,以進行可部署的生產環境輸出。此技能支援所有主要 AI 代理平台,並透過明確的步驟與自我檢查清單確保品質。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/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 張超現實拼貼圖板。

這是 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 欄位最少回答數備註
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(sans+em+dot)
5about + capabilities.cards[4]全部4 張卡片 × {num,tag,title,body}
6labs.cards[5] + method.steps[4]全部兩個網格均為固定數量
7work.cards[2] + testimonial全部5 個合作夥伴圖示以內聯 SVG path 資料提供
8cta + 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 中,以確保視覺一致性。

另請參閱

Individual skills in this repo

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

相關技能