静的サイトの公開
目標
完成した静的ウェブサイトの公開またはデプロイ準備を行います。
このスキルは、site/、dist/、out/、public/、docs/ などのデプロイ可能なHTML/CSS/JS出力を対象とします。フレームワークプロジェクトが静的出力フォルダを生成した後であれば、それも公開できます。ただし、単なる静的サイトをデプロイするためだけに、フレームワークプロジェクトに変換してはいけません。
デフォルトの姿勢:
- フレームワーク固有のデプロイよりも、シンプルな静的ホスティングを優先します。
- ユーザーが今後も編集を続けるサイトには、Gitベースのデプロイを優先します。
- 迅速な単発公開の場合にのみ、直接アップロードを優先します。
- ユーザーが明示的に要求しない限り、リモートリポジトリの作成、コードのプッシュ、DNSの変更、ドメインの追加、有料アカウントへのデプロイは行いません。
契約
入力:
site/、dist/、out/、public/、docs/、またはリポジトリルートなどの静的デプロイルート。- 優先プラットフォームまたはターゲット: GitHub Pages、Cloudflare Pages、Netlify、Vercel、カスタムドメイン、ガイダンスのみ、またはライブデプロイ。
- 現在のGit/リポジトリの状態、プラットフォームアカウントへのアクセス、CLI/ブラウザログイン、およびデプロイに関する制約。
出力:
- 具体的なデプロイ設定: プラットフォーム、ブランチ、ビルドコマンド、ベースディレクトリ、公開/出力ディレクトリ、および必要に応じた設定ファイル。
- オプションのプラットフォーム固有設定: GitHub Pagesワークフロー、
netlify.toml、vercel.json、.nojekyll、CNAME。 - ライブURLと、デプロイが実際に実行された場合のデプロイ後検証。
- 認証情報やアカウントアクセスがない場合の手動ダッシュボード手順。
境界:
- サイトのビルドや再デザインは行いません。欠陥は適切な子スキルにルーティングします。
- 明示的に許可されていない限り、プッシュ、リポジトリ/プロジェクトの作成、アップロード、ドメインのバインド、DNSの変更、有料リソースの使用は行いません。
- ユーザーがサーバールートのみの動作を明示的に承諾しない限り、壊れたローカル/静的パスの互換性の回避策としてデプロイを使用しないでください。
成功ゲート:
review-static-siteが合格しているか、未解決のリスクが明示されていること。- デプロイルートに
index.htmlが含まれており、プラットフォームが正しいフォルダを公開すること。 - デプロイ後、オンラインURLでホームページ、アセット、ナビゲーション、代表的なサブページが読み込まれること。
ゲートが失敗した場合:
- デプロイ前に、パス、アセット、エンコーディング、またはページタイプのブロッカーを修正します。
- コンテンツ/デザイン/インポートの問題を
personalize-site、edit-site-part、add-blog-posts、make-personal-site、またはcopy-website-styleにルーティングします。 review-static-siteを再実行し、デプロイ設定を再試行または更新します。
参考文献
選択したプラットフォームまたは問題に必要な参照のみを読み込みます:
- パス戦略と直接開く互換性:
references/path-strategy.md。 - Cloudflare Pages Git連携と直接アップロード:
references/cloudflare-pages.md。 - GitHub Pages ブランチソースとActionsワークフロー:
references/github-pages.md。 - Netlify ダッシュボードと
netlify.toml:references/netlify.md。 - Vercel ダッシュボードと
vercel.json:references/vercel.md。
公式ドキュメント:
- GitHub Pages 公開ソース: https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site
- GitHub Pages カスタムワークフロー: https://docs.github.com/en/pages/getting-started-with-github-pages/using-custom-workflows-with-github-pages
- Cloudflare Pages 静的HTML: https://developers.cloudflare.com/pages/framework-guides/deploy-anything/
- Cloudflare Pages Git連携: https://developers.cloudflare.com/pages/get-started/git-integration/
- Cloudflare Pages 直接アップロード: https://developers.cloudflare.com/pages/get-started/direct-upload/
- Netlify デプロイ作成: https://docs.netlify.com/deploy/create-deploys/
- Netlify ビルド設定: https://docs.netlify.com/build/configure-builds/overview/
- Vercel デプロイ: https://vercel.com/docs/deployments
- Vercel プロジェクト設定: https://vercel.com/docs/project-configuration
デプロイモード
まず、ユーザーが実際に何を望んでいるかを判断します:
- ガイダンスのみ: プラットフォームの選択と正確な設定を説明します。有用でない限り、ファイルは編集しません。
- リポジトリの準備: 必要な設定ファイルを追加し、ホスティングダッシュボードで何をクリックすべきかをユーザーに伝えます。
- 今すぐデプロイ: ユーザーが明示的に要求し、必要なCLI/auth/sessionが存在する場合にのみ、リモートアクションを実行します。
- ライブURLの確認: デプロイされたURLをブラウザで開き、ローカルサイトと比較して確認します。
認証情報、アカウントアクセス、ブラウザログイン、またはCLI認証がない場合は、回避策を考案する代わりに、正確なダッシュボード手順を提供します。
ワークフロー
- 静的出力フォルダとユーザーの希望プラットフォーム(ある場合)を特定します。
- 公開前に
review-static-siteを呼び出すか、使用を提案します。 - デプロイルートに
index.htmlが含まれていることを確認します。 - アセットパスを検査し、不注意によるルート絶対サイトローカルパスを公開前に変換します。パスの動作が不明な場合は、
references/path-strategy.mdを読み込みます。 - 最もシンプルなマッチングプラットフォームとデプロイモードを選択します。
- 選択したプラットフォームの参照を読み込み、そのプラットフォームに必要な設定ファイルのみを追加します。
- Git経由でデプロイする場合は、Gitステータスを確認し、無関係またはプライベートなファイルが含まれないようにします。
- ユーザーがリモートアクションを承認した場合は、合意した内容を正確にプッシュまたはデプロイします。
- 公開後、ライブURLを開き、ブラウザでデプロイされたサイトを確認します。
事前チェックリスト
デプロイ設定を記述したり、ユーザーに設定を伝えたりする前に、以下のチェックを実行します:
- デプロイルート:
index.htmlを直接含むフォルダを選択します。 - エントリページ:
index.htmlがデプロイルートのトップレベルに存在する必要があります。 - 直接開くプレビュー: ユーザーが明示的にサーバーのみの動作を承諾しない限り、ルート
index.htmlは、ファイルシステムから直接開いたときにCSS、JS、画像、およびナビゲーションを保持する必要があります。 - ローカルHTTP:
python -m http.serverでデプロイルートを提供し、http://127.0.0.1:<port>/で動作することを確認します。 - 静的監査: リンク、UTF-8の可読性、プレースホルダーの残骸、ブラウザレンダリング、プライバシーの残骸、モバイルレイアウトについて、
review-static-siteを実行または推奨します。 - アセットパス:
href、src、srcset、CSSurl(...)、フォント、ファビコン、カバー画像、RSS、サイトマップ、マニフェストリンクを検査します。 - プライベートデータ: トークン、ローカルファイルシステムパス、ドラフトノート、ソースサイトのアイデンティティ、個人の機密情報が公開されていないことを確認します。
- 出力の完全性: サブページ、投稿、画像、ベンダーフォント、KaTeX/数式アセット、コピーされたメディアがデプロイルート内にあることを確認します。
これらをブロッカーとして扱います:
- デプロイルートに
index.htmlがない。 - ローカルCSS、JS、画像、フォント、RSS、サイトマップ、またはベンダーアセットパスが壊れている。
- ソースファイルに文字化けや読めないエンコーディングが含まれている。
- 生成された個人サイトに、置き換えられるべきコピー元のアイデンティティがまだ含まれている。
- 生成されたプレーンな静的サイトに、
/assets/...、/posts/...、/data/...、/images/...などの不注意によるルート絶対サイトローカルパスが残っている。 - ルート絶対パスが
127.0.0.1から提供されているため、サイトはローカルHTTPでのみ機能するが、直接ファイルを開いたりサブパスデプロイしたりするとCSS/JS/画像が失われる。 - プライバシーに関わるファイルや機密情報がデプロイされる。
- プラットフォームが間違ったフォルダをデプロイする。
プラットフォームの選択
プレーンな静的個人サイトには、以下のデフォルトランキングを使用します:
- Cloudflare Pages Git統合: 生成された
site/フォルダと将来の更新に最適なデフォルト。 - GitHub Pages with GitHub Actions: ユーザーがすべてをGitHub内で完結させたい場合に最適。
- Netlify: フレンドリーなプレビューとダッシュボード設定を備えたシンプルな静的ホスティング。
- Vercel: ユーザーがすでにVercelを使用しているか、後でNext.jsに移行する可能性がある場合に適していますが、プレーンHTMLのデフォルトではありません。
決定ルール:
- ユーザーが最も手間をかけずに済ませたい場合、かつGitHubリポジトリがある場合: Cloudflare Pages Git統合。
references/cloudflare-pages.mdを読み込みます。 - ユーザーがGitHubのみのホスティングを希望する場合: GitHub Pages。
references/github-pages.mdを読み込みます。 - デプロイファイルがリポジトリルートまたは
/docsにある場合: GitHub Pages ブランチソースは許容されます。 - デプロイファイルが
site/、dist/、out/、またはその他のカスタムフォルダにある場合: GitHub PagesにはGitHub Actionsを優先します。 - ユーザーが今日手動でアップロードしたい場合: Cloudflare Direct Upload または Netlify の手動デプロイ。
- ユーザーがすでにVercelアカウント/プロジェクトを持っている場合: 明示的な出力ディレクトリ設定でVercelを使用します。
フレームワークの静的出力
サイトがプレーンなHTML/CSS/JSでない場合:
package.json、フレームワーク設定、既存のスクリプトを検査します。- プロジェクトの既存のビルドコマンドを使用します。npmワークフローを考案しないでください。
- ソースフォルダではなく、最終的な静的出力フォルダを公開します。
- 一般的な出力には、フレームワークに応じて
dist、out、build、.output/public、publicなどがあります。 - Next.js静的エクスポートの場合、
out/を最終出力として扱う前に、プロジェクトが実際に静的エクスポート用に設定されていることを確認します。 - Vue/Vite/Astroスタイルのプロジェクトの場合、ビルド成功後に設定された出力ディレクトリを公開します。
ユーザーがプレーンな静的公開を要求し、フレームワークファイルが存在しない場合は、npmを導入しないでください。
設定ファイルポリシー
選択したプラットフォームに一致する設定ファイルのみを追加します:
- GitHub Pages Actions:
.github/workflows/pages.yml。 - GitHub Pages カスタムドメイン: デプロイルートの
CNAME。ユーザーがドメインを提供した場合のみ。 - GitHub Pages Jekyllバイパス: 有用な場合、デプロイルートの
.nojekyll。 - Netlify: ダッシュボード設定で十分でない場合、またはユーザーがGitで設定を管理したい場合にのみ
netlify.toml。 - Vercel: Vercelが明示的な出力設定を必要とする場合にのみ
vercel.json。 - Cloudflare Pages: 通常、プレーンな静的サイトにはダッシュボード設定で十分です。
すべてのプラットフォームに一度にデプロイ設定を追加しないでください。
Gitとリモートの安全性
リモートアクションの前に、何が起こるかを述べ、ユーザーがそれを要求したことを確認します:
- GitHubリポジトリを作成する。
- リモートを追加する。
- ファイルをステージングまたはコミットする。
- リモートブランチにコミットをプッシュする。
- GitHub Pagesを有効にする。
- Cloudflare、Netlify、またはVercelプロジェクトを作成する。
- ホスティングプロバイダーにファイルをアップロードする。
- 環境変数を追加する。
- カスタムドメインを追加するか、DNSレコードを変更する。
ステージングまたはプッシュの前に:
git status --shortを実行します。- 生成されたサイトファイルと、無関係なユーザーの変更を区別します。
- 無関係な変更をステージングしないでください。
- プライベートノート、認証情報、ローカルパス、機密情報を含むスクリーンショット、または一時ファイルを公開しないでください。
機密情報、トークン、プライベートノート、またはローカルファイルシステムパスを静的サイトやデプロイ設定に入れないでください。
デプロイ後の検証
プラットフォームがライブURLを報告した後:
- 実際に利用可能なインタラクティブブラウザツールを使用して、デプロイされたURLを開きます。「利用可能」とは、現在のターンの呼び出し可能なツールリストに公開されていることを意味します。Codexでは、これがターンにルーティングされた場合のBrowser/アプリ内ブラウザプラグインである可能性があります。
- ホームページが404、空白ページ、またはディレクトリリストではないことを確認します。
- CSS、JavaScript、画像、フォント、ファビコン、RSS、サイトマップ、ベンダーアセットがデプロイされたドメインから読み込まれることを確認します。
- プライマリナビゲーションと、ページタイプごとに少なくとも1つの代表的なサブページをクリックします。
- デスクトップとモバイルの幅をテストします。
- ブラウザコンソールで、欠落しているアセットやJavaScriptエラーを確認します。
- メタデータ、タイトル、説明、Open Graph画像、正規URL、RSS、サイトマップ、ロボットファイルが存在する場合は確認します。
- GitHubプロジェクトPagesを使用している場合は、特にサブページと、リポジトリサブパス下のアセットURLを確認します。
- カスタムドメインを使用している場合は、HTTPSとapexと
wwwの間のリダイレクトを確認します(設定されている場合)。
インタラクティブブラウザツールが呼び出せない場合は、ライブブラウザ検証が行われたふりをしないでください。ライブの視覚的な検証が重要な場合は、ブラウザツールを有効にするか呼び出すようにユーザーに依頼してください。Codexの場合、それは @browser を明示的に言及するリクエストを送信することを意味する場合があります。ユーザーが再ルーティングしない場合、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、HTTPチェック、または静的チェックにフォールバックし、その制限を明記します。
インタラクティブブラウザツールが実際に呼び出し可能な場合は、Playwrightやスクリーンショットのみのライブ検証をデフォルトにしないでください。Playwrightはフォールバックとしてのみ、またはユーザーがスクリプト化されたデプロイチェックを明示的に要求した場合にのみ使用します。
デプロイされたサイトがローカルプレビューと異なる場合は、デザインコードを変更する前に、デプロイログ、出力ディレクトリ、アセットパス戦略を検査します。
出力
最終的なユーザー向けレポートは簡潔に保ちます:
- 選択したプラットフォームとその理由。
- 公開または準備された静的フォルダ。
- デプロイモード: ガイダンス、準備された設定、Git統合、直接アップロード、またはライブデプロイ。
- 使用された設定: ブランチ、ビルドコマンド、ベースディレクトリ、公開/出力ディレクトリ。
- 変更された設定ファイル(ある場合)。
- 選択したプラットフォームの公式ガイドURL。
- ライブURL(デプロイが行われた場合)。
- 実行された検証と残っている手動ステップ。
ガイダンスのみが要求された場合は、サイトがデプロイされたふりをしないでください。具体的なプラットフォーム設定と公式ガイドリンクを提供します。