ハウツー

AIにZIP構成を整理させる方法

AIが生成したHTMLやCSS、画像ファイルは、作業のたびにフォルダ構成がバラバラになりがちだ。ギガサイト便でZIPを公開しようとしたときに「index.htmlが見つからない」「CSSが適用されていない」というエラーになる原因のほとんどはZIP構成の乱れだ。AIを使ってZIP構成を整理する具体的な方法を解説する。

準備するもの

まずAIが生成したファイルを全部一つのフォルダに集める。この段階では構成の整理は不要で、全ファイルが揃っているかだけを確認する。「index.html」「style.css」「images/」フォルダ等、最低限必要なファイルのリストをAIに質問して洗い出すと、不足しているファイルに気づきやすい。

AIにZIP構成を依頼するには、現在のフォルダ構成をテキストで書き出してAIへ渡す。Macの場合はターミナルで`find . -type f`を実行すると全ファイルのパスが一覧表示される。このテキストをコピーしてClaude等のAIに「この構成でギガサイト便に上げるための正しいZIPを作るには、どうフォルダを整理すればよいか教えてください」と質問する。

AIに渡すコンテキストとして「ZIPのルートにindex.htmlを置き、相対パスでCSS・画像を参照する構成にしたい」という目的も一緒に伝える。目的を伝えないとAIが汎用的なアドバイスを返すだけで、具体的な移動手順を教えてくれないことがある。

  • 相手がログインなしで開ける状態か確認する
  • PCとスマホで最低1回ずつ表示を確認する
  • 内部情報・個人情報・不要な外部送信が残っていないか見る
  • レビュー期限と修正時の差し替え方を決めておく

実際の手順

AIから「この構成に直してください」という指示が届いたら、ファイルマネージャーまたはターミナルでフォルダを整理する。整理後にWebブラウザのローカルでindex.htmlをダブルクリックして開き、CSS・画像が正常に読み込まれているかを確認する。ローカルで正常ならZIPに圧縮してギガサイト便にアップロードする。

ZIPを作るときはMacの「圧縮」機能を使う場合、フォルダを右クリック→「フォルダを圧縮」を選ぶ。ただしこの方法だとZIP内に`__MACOSX`フォルダが含まれてしまう。これが原因でWebサーバーが混乱するケースがあるため、`zip -r output.zip . -x "*.DS_Store" -x "__MACOSX"` のようなターミナルコマンドでZIPを作る方が安全だ。

失敗しやすい点

最も多い失敗は「ZIPのルート直下にindex.htmlがない」構成だ。AIがフォルダごとZIPすると、ZIPの中に`project/index.html`という形になり、ギガサイト便がindex.htmlを見つけられない。AIに「ZIPを解凍したときにindex.htmlが最上位に来る構成にしてください」と明示して依頼することで防げる。

画像ファイルの相対パスが壊れるパターンも頻発する。AIがHTMLで`../images/logo.png`と書いているのに、実際のZIP内には`images/logo.png`しかない場合などだ。整理後に必ずローカルブラウザで全画像が表示されるかをチェックし、表示されない画像があればパスを修正する。

テンプレ文面

AIへのZIP構成整理依頼プロンプト例:「以下は私のプロジェクトのファイル一覧です。ギガサイト便にZIPをアップロードして公開するため、ZIPを解凍したときにindex.htmlがルートに来る構成に整理してください。フォルダ構成の変更手順と、HTML内のパス修正が必要な箇所を具体的に教えてください。(ここにfindコマンドの出力を貼り付ける)」

整理結果を確認するためのAI確認プロンプト例:「整理後のZIPを解凍したフォルダ構成は以下です。ギガサイト便でHTMLが正常に表示されるか確認してください。問題があれば修正点を教えてください。(整理後のfindコマンド出力を貼り付ける)」

よくある質問

AIにZIP構成を整理させた後、ブラウザでローカル確認したら正常でも、ギガサイト便にアップすると表示が崩れます。原因は何ですか?

絶対パス(`/images/logo.png`等)を使っている場合にローカルでは動いてもサーバーパスが違うため崩れる。HTMLとCSSで使用しているパスをすべて相対パスに変換する必要がある。AIに「すべてのパスを相対パスに変換してください」と依頼すれば一括対応できる。

AIがZIP構成を提案してくれましたが、どれが正解かわかりません。どうやって判断すればよいですか?

AIの提案に従ってファイルを整理し、ローカルのブラウザでindex.htmlを開いてすべてのリソース(CSS・画像・フォント)が正常に読み込まれているかをDevToolsのNetworkタブで確認するのが最も確実。404エラーが出ているリソースがあれば、そのパスを修正する。

毎回AIにZIP構成を整理させるのは手間です。最初からAIに正しい構成でファイルを生成させるにはどうすればよいですか?

AIへの最初のプロンプトに「ギガサイト便にアップロードするため、ZIPのルートにindex.htmlを置き、CSS・画像・フォントはすべて相対パスで参照する構成でコードを生成してください」という制約を含める。最初に制約を与えると整理が不要な構成で出力されることが多い。

関連記事

ハウツー

AIにZIP構成を整理させるときの手順と注意点

AIを活用してHTML/ZIPファイルの構成を整理したいWebデザイナーやAIツール利用者向けに、手順の流れと注意点を詳しく解説。AIとのやり取りで陥りやすいパスのズレや構成ミスを事前に防ぐ実践的な知識が得られる。

5分で読める
ハウツー

AIにZIP構成を整理させるためのチェックリスト

AIにZIPのフォルダ構成整理を依頼する際の確認チェックリストを解説。整理前・整理中・整理後のステップ別に確認すべき項目を整理し、パスミスや構成ミスによる再作業を防ぎたいWebデザイナー・AIツール利用者に向けた実践的な内容。

4分で読める
ハウツー

レビュー用URLをSlackで配る方法

Slackでレビュー用URLを共有したい担当者向けに、準備・送信・無効化の一連の流れを解説。どのチャンネルに何をどう送ればよいか判断できます。

3分で読める
ハウツー

レビュー用URLをTeamsで配る方法

TeamsでレビューURLを共有したい担当者向けに、チャンネル・チャット・会議チャットの使い分けと配布時の設定手順を解説。どの機能を使えばよいか判断できます。

4分で読める
ハウツー

メールで期限付きURLを送る方法

メールで期限付きレビューURLを送りたい担当者向け。件名・パスワードの記載方法から期限管理・再送まで、メール特有のトラブルを防ぐ手順を解説しています。

4分で読める
ハウツー

Notionに共有URLを貼る方法

Notionでレビュー用URLを管理・共有したい担当者向け。埋め込み機能の使い方とページ公開範囲の設定手順を解説し、どの方法を選べばよいか判断できます。

4分で読める
「ハウツー」の記事をもっと見る →