open-design-landing は何をしますか?
Atelier Zeroデザインシステムを使用して、シングルページのエディトリアルランディングサイト(またはスライドデッキ。関連スキル open-design-landing-deck を参照)を構築します。特徴は、暖かみのある紙背景、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ファイル:
- エディトリアルトップバー(ボリューム / 号 / 言語ストリップ)、ヘッドルームスタイルのスティッキーナビ(GitHubスター数のライブ表示付き)。
- 紙テクスチャ背景の8つのローマ数字セクション: ヒーロー(3つの統計リング + 4ステップインデックス)、アバウト、ケイパビリティ(4枚のカード)、ラボ(5枚のカード + フィルターピル + プログレスバー)、メソッド(サムネイル付き4ステップ)、作品紹介(ダークスラブ + 2枚の傾斜カード)、お客様の声(プルクォート + 5つのパートナーグリフ)、CTA(リボン + メールピル)。
- 4つのリンクカラムと大きなイタリックセリフのキッカーワードを持つフッター。
- すべてのセクションにスクロールリビールモーション(IntersectionObserver、
prefers-reduced-motionを尊重)。 - 1280 / 1080 / 880 / 560 のブレークポイントで完全にレスポンシブ。
ワークフロー契約
以下の4つのステップを順番に実行します。エージェントは各ステップを完了させてから次に進み、コピーをでっち上げるよりもユーザーに焦点を絞った質問をすることを推奨します。
1. ブランド情報の収集
AskQuestion(またはUIの同等機能)を使用して、ブランドブリーフを分割して収集します。schema.ts 全体をユーザーにダンプしないでください。ユーザーの回答を、型に合った inputs.json にマッピングします。
8つの質問グループ(順番通り):
| グループ | スキーマフィールド | 最小回答数 | 備考 |
|---|---|---|---|
| 1 | brand.{name,mark,tagline,description,location} | 5 | Mark = 単一グリフ(Ø, ▲, ★…) |
| 2 | brand.{license,version,year,primary_url,contact_email} | 4 | URLは必須; ライセンスはデフォルトApache-2.0 |
| 3 | nav[] (最大5) | 3 | オプションのカウントバッジ |
| 4 | hero.{label,headline,lead,primary,secondary,stats} | すべて | HeadlineはMixedText(sans+em+dot) |
| 5 | about + capabilities.cards[4] | すべて | 4枚のカード × {num,tag,title,body} |
| 6 | labs.cards[5] + method.steps[4] | すべて | 両方のグリッドは固定アリティ |
| 7 | work.cards[2] + testimonial | すべて | 5つのパートナーグリフはインラインSVGパスデータ |
| 8 | cta + footer.{columns[4],mega} | すべて | Mega kickerは見出しと同様にMixedText |
完全な動作例(Open Design自身)については inputs.example.json を開いてください。
2. 画像戦略の決定
| 戦略 | 選択すべきタイミング | コスト / レイテンシ |
|---|---|---|
placeholder | 最初のパス。デモ。社内スライド。まだ画像予算がない場合。 | $0, <1秒 |
generate | 最終納品。ブランドがオリジナルのコラージュを希望する場合。 | ~$0.40, ~6分 |
bring-your-own | ユーザーがアートディレクション済みPNGを持っている場合。assets_pathに配置。 | $0, 0秒 |
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ファイル1つを書き込みます。ページには以下が含まれます:
- インライン化された完全なAtelier Zeroスタイルシート。
- すべてのセクションマークアップに、段階的なスクロールモーションのための
data-reveal属性が付与されています。 - インラインIntersectionObserverスクリプト(
apps/landing-page/app/_components/reveal-root.tsxを反映)。 - インラインヘッドルームナビスクリプト(
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/ツリー全体を1つのコマンドで出力するコンポーザーがバンドルされる可能性があります。それまでは、フォークして編集する方法がサポートされているパスです。
納品前のセルフチェック
完了とマークする前に、エージェントは必ず以下を確認する必要があります:
-
<out>/index.htmlがブラウザでコンソールエラーなく開く。 - すべての16個の画像スロットが読み込まれる(DevToolsのネットワークタブで404がないこと)。
- 見出しのイタリック強調スパンがPlayfair(サンセリフではない)でレンダリングされる。
- 珊瑚色の終端ドットがすべての display なh1/h2の末尾に表示される。
- 上から下までスクロールし、すべてのセクションが一度アニメーションする。
- 880pxと560pxにリサイズしても、横スクロールや重なりがない。
-
prefers-reduced-motion: reduce(DevTools → Rendering)でトランジションがきれいに無効化される。 - Lighthouse: コントラストAA、font-display swap、ヒーローでのレイアウトシフトなし(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にコピーし、視覚的なパリティを1対1に保ってください。
関連情報
design-systems/atelier-zero/DESIGN.md— トークン仕様。apps/landing-page/— デプロイ可能なAstro静的サイトの対応物。skills/open-design-landing-deck/— このデザインシステムを再利用するスライドスキル。
