Communitygithub.com

jhy0285/monofield

產生世界級單頁編輯登陸網站,採用 Atelier Zero 視覺語言(Monocle / Apartamento / Études 編輯拼貼美學)——與 Open Design 自身行銷頁面相同的風格。代理程式會根據品牌簡報填寫 typed `inputs.json`,可選用 gpt-image-2 生成 16 張拼貼素材,接著執行純函數組合器輸出獨立的 HTML 檔案;另外可選擇鏡像 Astro 行銷網站至 `apps/landing-page/`。自動加入滾動顯現動畫與 Headroom 風格的固定導覽列。

monofield 是什麼?

這個技能讓 AI 代理程式能根據品牌簡報,自動建立一個完整的單頁編輯登陸網站。它基於 Atelier Zero 設計系統,包含溫暖紙張背景、Inter Tight 與 Playfair Display 字型、斜體襯線強調、虛線分隔線、珊瑚色終止點、滾動顯現動畫以及 16 張超現實拼貼圖板。 技能運作流程包含四個步驟:首先,代理程式透過結構化提問收集品牌資訊,並填入 typed `inputs.json`。第二步,選擇圖片策略(佔位符、AI 生成或自備)。第三步,執行組合腳本,將 `inputs.json` 與 `styles.css` 合成一個自包含的 HTML 檔案,內嵌所有樣式、滾動動畫、固定導覽列及 GitHub 星數擷取功能。第四步可選擇將內容鏡像到可部署的 Astro 網站。 此技能支援 Cursor、Claude Code 等代理程式平台,並附有詳細的自我檢查清單,確保輸出結果在瀏覽器中無錯誤、所有圖片載入正常、響應式斷點正確、無障礙通過對比度檢測。它明確界定了不應做的事項,例如不得發明新顏色或字型、不得遺漏滾動動畫屬性等。

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

在你喜歡的 AI 中提問

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

預覽

來自技能 README

monofield preview

說明文件

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 欄位最少答案注意事項
1brand.{name,mark,tagline,description,location}5Mark = 單一字形(Ø, ▲, ★…)
2brand.{license,version,year,primary_url,contact_email}4URL 為必填;授權預設為 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 路徑資料
8cta + 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,以保持視覺上的一對一一致性。

另請參閱

Individual skills in this repo

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

jhy0285/monofield

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

jhy0285/monofield

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

jhy0285/monofield

A standalone pricing page — header, plan tiers, feature comparison table, and an FAQ. Use when the brief asks for "pricing", "plans", "subscription tiers", or a "compare plans" page.

jhy0285/monofield

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jhy0285/monofield

Minimal pre-launch landing with email capture, brand logo, and optional decorative layer. Reads DESIGN.md for colors, typography, and layout rules. Best for: product launches, beta signups, early access programs, indie projects.

jhy0285/monofield

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

jhy0285/monofield

Use this plugin when the user wants a premium, GSAP-driven cinematic B2B landing page: a scroll-driven full-screen video slider hero with clip-path ellipse transitions, SplitText char-reveal headlines, a masonry product gallery, scroll-reveal about text, a partner marquee, Lottie-style feature cards, and a multi-office footer. Invoke for 'cinematic landing page', 'video hero landing', 'bakery / food-service landing', 'GSAP scroll site', or when the user references the Cinematic Landing Page template.

jhy0285/monofield

Use this plugin when the user wants a single-page immersive parallax landing page with a scroll-driven portal/curtain entrance and a curved arc card slider — a 'dreamcore' / 'reverie' hero that scales a portal image toward the viewer as the user scrolls into a second dream-world scene. Invoke for 'parallax landing', 'scroll cinematic hero', 'portal zoom landing', 'arc card slider', or when the user references the Dreamcore Landing template.

jhy0285/monofield

Use this plugin when the user wants a dark, pure-monochrome newsletter / content-platform landing page (Mindloop): fullscreen video hero, Instrument-Serif italic accent words, liquid-glass controls, scroll-driven word-by-word mission reveal, and an HLS-video CTA. Invoke for 'Mindloop landing', 'black monochrome newsletter landing page', 'video hero content platform', or when the user references the Mindloop template.

jhy0285/monofield

Programmatic video creation with React. Useful for branded explainers, social cuts, dashboards-to-video, and reproducible motion graphics.

相關技能