Communitygithub.com

jpoindexter/theft-kit

生成世界級單頁式編輯風格著陸頁,採用 Atelier Zero 視覺語言(融合 Monocle / Apartamento / Études 的編輯拼貼美學)。代理程式會從品牌簡報填入 typed `inputs.json`,選擇性透過 gpt-image-2 生成 16 張拼貼素材,再執行純函數編譯器產出單一 HTML 檔案。

theft-kit 是什麼?

此技能「open-design-landing」讓 AI 代理能自動構建以 Atelier Zero 設計系統為基礎的高品質單頁編輯著陸頁。它特別適合需要精致、如雜誌般排版,並帶有暖紙紋理背景、特定字體(Inter Tight 與 Playfair Display)及獨特視覺元素(如珊瑚色終止點)的專案。工作流程嚴謹:首先,代理透過結構化問題收集品牌資訊,並將答案填入型別化的 `inputs.json` 檔案。接著,決定圖片策略:使用佔位符進行快速疊代、利用 `gpt-image-2` 生成原創拼貼,或讓使用者提供自訂圖片。最後,編譯器將 JSON 與規範的 CSS 合併,產生一個完全自包含的 HTML 檔案,內建捲動顯示動畫與 Headroom 風格的黏性導航欄。此技能與 Open Design 專案一致,支援多種平台,並提供可選擇的途徑,將內容鏡像至可部署的 Astro 網站 `apps/landing-page/`。其設計非常重視編輯完整性與效能,內建完整的自我檢查清單,確保沒有主控台錯誤、圖片正常載入、響應式設計,並符合無障礙標準。

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

在你喜歡的 AI 中提問

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

預覽

來自技能 README

theft-kit preview

說明文件

open-design-landing

構建一個單頁編輯著陸網站(或是投影片組——請參閱同系列 open-design-landing-deck 技能) 採用 Atelier Zero 設計系統:暖紙背景、 Inter Tight + Playfair Display 字型、斜體襯線強調標記、虛線分隔線、 珊瑚色終止點、捲動顯示動畫,以及 16 張超現實拼貼圖版。

這是 Open Design 行銷頁面的標準配方—— 您可在 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 個合作夥伴標誌)、 行動呼籲(緞帶 + 電子郵件按鈕)。
  • 頁尾包含 4 個連結欄 + 一個巨大的斜體襯線關鍵字。
  • 每個區塊皆有捲動顯示動畫(使用 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 為必填;授權預設為 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/

在 <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 個符合 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/ 套件:將其複製到您的工作區,根據您的 inputs.json 內容調整 app/page.tsx,並將您的 <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 字體(而非無襯線字體)渲染。
  • 每個 display 層級的 h1/h2 結尾處都出現珊瑚色終止點。
  • 從上到下滾動;每個區段動畫只播放一次。
  • 調整視窗大小至 880px 和 560px;無橫向捲軸,無重疊。
  • prefers-reduced-motion: reduce(DevTools → 轉譯)能乾淨地 停用轉場效果。
  • 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 5 individual skills — each has its own dedicated page.

jpoindexter/theft-kit

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.

jpoindexter/theft-kit

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

jpoindexter/theft-kit

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.

jpoindexter/theft-kit

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".

jpoindexter/theft-kit

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.

相關技能