Communitygithub.com

cosmasgicter/mihasv3

產生一個世界級的單頁編輯式著陸頁面,採用 Atelier Zero 視覺語言(Monocle / Apartamento / Études 編輯拼貼風格)——與 Open Design 自身行銷頁面相同的美學。Agent 會從品牌簡報填入型別化的 `inputs.json`,可選擇透過 gpt-image-2 生成 16 張拼貼素材,接著執行純函數編排器以輸出一個自包含的 HTML 檔案;另一條路徑則可鏡像 `apps/landing-page/` 中的 Astro 行銷網站。捲動揭示動畫與 Headroom 風格的黏性導航列會自動串接。

mihasv3 是什麼?

此技能旨在建立一個高度風格化的單頁編輯式著陸頁面,採用 Atelier Zero 設計系統,特點包括暖紙背景、Inter Tight 與 Playfair Display 字型、斜體襯線強調、虛線細規則、珊瑚色終止點、捲動揭示動畫,以及 16 張超現實拼貼圖片。整個流程完全參數化:Agent 從使用者提供的品牌簡報中,逐步收集資訊並填入型別化的 `inputs.json` 檔案。接著,Agent 需決定圖片策略——可使用佔位符號(無成本)、透過 fal.ai 的 gpt-image-2 生成原創拼貼(約 $0.40 及 6 分鐘),或由使用者提供自備的 PNG 素材(無成本且即時)。最後,執行 `scripts/compose.ts` 腳本,將 `inputs.json` 與標準 `styles.css` 合併,產生一個自包含的 HTML 檔案,內嵌所有樣式、捲動揭示動畫、Headroom 黏性導航列及 GitHub 星數抓取器。技能適用於 Claude Code、Coder、Cursor 等支援檔案操作與型別化 JSON 輸入的 AI Agent 平台。其核心價值在於提供一個可重複、高品質的設計輸出,確保初次使用即能產出符合品牌視覺且無需手動調整的專業網頁。

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

在你喜歡的 AI 中提問

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

預覽

來自技能 README

mihasv3 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 為必填;授權預設 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 壓軸字詞是 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

將 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 → 渲染)能乾淨地停用過渡效果。
  • Lighthouse:對比度 AA、字體顯示切換、英雄區無版面位移 (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.

cosmasgicter/mihasv3

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

cosmasgicter/mihasv3

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.

cosmasgicter/mihasv3

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.

cosmasgicter/mihasv3

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.

相關技能