リポジトリ静的ランディング は何をしますか?
リポジトリに配置された場所から内容を引き出した静的ランディングページ(docs/index.html + docs/style.css + docs/main.js)を生成します。リポジトリに実際に存在しない機能、プロバイダ、コマンドを一覧にしないでください。
コンテンツの信頼できる情報源
書き始める前に、以下を読んでください:
README.*— 概要、機能、技術スタック、インストール/クイックスタートコマンドLICENSE*— ライセンス名、バージョン、URLCHANGELOG.*— 変更履歴の要約package.json、composer.json、requirements.txtなど:名前、説明、依存関係(テクノロジースタックバッジの基礎)AGENTS.md、CLAUDE.md、config.toml、GEMINI.mdなど:プロジェクトの目的、およびプロジェクトにサポートされているプロバイダ/設定の表がある場合、それら- 既存の
docs/index.html(存在する場合):明示的に再デザインを依頼されない限り、そのセクション構造を再利用し、最初から再構築するのではなく、その場でコンテンツを編集します
必要な要素
-
ライト/ダークテーマ —
prefers-color-scheme: darkメディアクエリで CSS カスタムプロパティ(--bg、--text、--accentなど)をオーバーライドします。依頼がない限り、JS によるテーマ切り替えは追加しないでください。 -
OGP + Twitter/X カード —
og:title、og:description、og:url、og:image、og:type、og:site_name、twitter:card、twitter:title、twitter:description、twitter:image。og:image/twitter:imageはリポジトリに実際に存在するアセット(例:social-preview.png)を指すようにします。存在しない場合は、最初にmake-social-previewスキルで生成します。 -
JSON-LD スキーマ —
<script type="application/ld+json">ブロック(アプリ/ツールの場合はSoftwareApplication、それ以外はプロジェクトに適した任意の@type)。OGP の説明と一貫性を保ちます。 -
ファビコン — プロジェクトに適した Twemoji SVG を
<link rel="icon">で参照します。 -
multilanguagejsによる多言語対応(CDN、ビルド不要):<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>翻訳するすべての要素を
<template type="language-group">でラップし、その中に言語ごとに1つの子要素を配置します。各子要素にはlanguage="xx"属性(langではない)を付けます:<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>各
template[type=language-group]には、サポートする言語ごとに厳密に1つの要素が含まれている必要があります。multilanguagejsはテンプレートごとに最初に一致する[language=X]を取得するため、重複があるとコンテンツが静かに失われます。main.jsで初期化します:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // 読み込み時、および <select> 切り替えの change イベント時<title>と<meta name="description">は[language]テンプレートのスコープ外です(ライブラリは一致する要素のtextContentのみを更新し、<meta>タグの翻訳はテキストではなくcontent属性にあります)。main.jsに言語ごとの小さな{ title, description }辞書を持たせ、ml.setLanguage()と一緒にこれら2つのタグを手動で更新します。navigator.languageから訪問者の言語を検出し、選択された言語をlocalStorageに保存し、読み込み時にそれを再適用してからブラウザ検出にフォールバックします。必須言語セット(アプリ自体がサポートするものに関係なく、常に): 英語(
en)、日本語(ja)、中国語(zh)、スペイン語(es)、ロシア語(ru)、ドイツ語(de) — 少なくとも6言語。これは、src/locales/*.jsonやアプリ独自のi18n.ts/i18n.jsがそれらの一部のみをカバーしている場合でも適用されます(例:en/jaのみのアプリでも、ランディングページは6言語で作成します)。リクエストに応じて、これらの6言語に他の言語を追加しても構いません。 -
クリップボードにコピーするボタン —
<code>ブロックで表示されるすべてのインストール/実行コマンドに、インライン SVG アイコン(絵文字は不可)を備えたコピーボタンと、navigator.clipboard.writeText()によるチェックマーク確認状態を付けます。一貫したレイアウトのために、<code>とそのボタンを.code-rowフレックスコンテナでラップします。 -
レスポンシブ対応 — モバイルファースト。明示的にスクロールを意図したコンテナ(例:広い比較表)以外では、狭いビューポートで水平スクロールを発生させないでください。
-
ビルド手順不要 — アプリ自体がどのバンドラ(Vite など)を使用していても、HTML ファイルを開くか静的フォルダをそのまま提供するだけでページが動作するようにします。
main.jsは読み取り可能なソースのままにします。<script src="main.js">でページに直接読み込みます。 -
セマンティック構造 — これらをセマンティックに構成します:ヒーロー(見出し、リードテキスト、CTA、プライマリ実行コマンド)、スクリーンショット(既存のリポジトリ/GitHub アセット URL があれば再利用)、機能グリッド、クイックスタート/インストールコマンド、テクノロジースタックバッジ、フッター。
-
既存の CSS を再利用 — 並行した別個のスタイリングシステムを作成するのではなく、リポジトリの
docs/style.cssに既に存在する CSS カスタムプロパティとクラス名を再利用します。 -
デザインシステムを尊重 — 既存の AI エージェントランタイム環境のデザインシステムを尊重します。新しい CSS を追加するときは、既存のカスタムプロパティとクラス名を再利用し、リポジトリのデザインシステムと一貫性のある命名規則、デザイン、レイアウト、トーン、マナーに従います。
ワークフロー
- 上記のコンテンツソースを読みます。
docs/が存在しない場合は作成します。docs/index.htmlがすでに存在する場合は、その場で編集します — 明示的に再デザインを依頼されない限り、丸ごと置き換えず、セクション構造を維持してコンテンツを更新します。- セクションをセマンティックに構成します:ヒーロー(見出し、リードテキスト、CTA、プライマリ実行コマンド)、スクリーンショット(既存のリポジトリ/GitHub アセット URL があれば再利用)、機能グリッド、比較/設定表(プロジェクトに比較する価値のある複数のプロバイダ/モード/バックエンドがある場合)、クイックスタート/インストールコマンド、テクノロジースタックバッジ、フッター。
- 並行した別個のスタイリングシステムを作成するのではなく、リポジトリの
docs/style.cssに既に存在する CSS カスタムプロパティとクラス名を再利用します。 docs/main.jsを更新します。- 終了前に確認:インタラクティブなアイコンに絵文字は使用されていない(SVG のみ)。すべての
template[type=language-group]がサポートする言語ごとに厳密に1つの子要素を持ち、重複や欠落がない。OGP/JSON-LD がリポジトリに実際に存在するファイル/URL を指している。