コードレビューに「実画面」を足したい
GitHub CopilotやCopilot Workspaceでフロントエンドを生成すると、変更はプルリクエストの差分として現れます。レビュアーはコードの差分を読めますが、その変更が画面でどう見えるかまではコードからは想像しづらいことがあります。
ローカルにチェックアウトしてビルドして確認する手もありますが、レビュアー全員にそれを求めるのは負担です。デザインや文言の確認だけしたい非エンジニアの関係者には、なおさら難しくなります。
そこで、生成したHTMLを実際に開けるURLにしてPRに添えると、コードと画面の両方を見ながらレビューしてもらえます。
対象のHTMLをまとめる
Copilotが生成したHTMLを、ブラウザで開ける形にまとめます。単一ページならHTMLファイル、複数アセットがあるならCSS・JS・画像を含めてZIPにします。ビルド工程がある場合はビルド後の静的な出力を対象にします。
相対パスでアセットを参照していれば、まとめてアップロードしたときにそのまま表示できます。書き出し後に一度開いてリンク切れを確認しておくと、共有後の手戻りを防げます。
AI生成HTMLを共有する前の安全チェック
GitHub Copilot/Copilot Workspaceで作ったHTMLを共有では、AIツールの画面上で完成して見えても、共有用HTMLとして安全とは限りません。外部script、form送信先、APIキーらしき文字列、画像パス、ダミーデータではない個人情報を分けて確認します。
ツールの書き出し形式や共有機能は時期・プラン・作り方で変わります。この記事では特定機能の有無を断定せず、静的HTMLやZIPとして取り出せた成果物を安全に見せる前提で進めます。安全チェックが終わったら、HTMLまたはZIPをアップロードし、必要に応じて認証と期限を付けたURLとして共有します。
- 外部送信: form action、fetch、script src、iframeの向き先を確認する
- 秘密情報: APIキー、トークン、社内URL、顧客名が残っていないか検索する
- 表示再現: 画像・CSS・フォントが公開URLでも読み込めるか見る
- 共有設定: 相手、期限、認証方式、差し替え時の連絡方法を決める
ギガサイト便で一時URLを発行する手順
ギガサイト便は、HTMLやZIPをドロップするだけで認証付き一時URLを発行します。Copilotで作ったHTMLをそのまま渡せます。
手順は次のとおりです。
- Copilot/Copilot Workspaceで生成したHTML(またはビルド済みZIP)を用意する
- ギガサイト便のトップにドロップして共有URLを発行する
- カスタムスラッグでURL末尾をPR番号や機能名に整える
- 認証方式と公開期限を設定する
- 発行したURLをプルリクエストの説明に貼る
PRの更新に合わせてURLを差し替える
コードレビューでは、指摘を受けてコミットを重ねるたびに画面も変わります。そのたびに新しいURLを貼り替えると、PRのコメント欄にリンクが乱立してしまいます。
ギガサイト便は同じURLのままファイルを差し替えられるので、修正後のHTMLに置き換えれば、PRに貼ったURLを変えずに最新版を見せられます。レビュアーは同じリンクを開き直すだけで済みます。
誰がいつ見たかのアクセスログにも対応しているので、レビュー依頼した相手が画面を確認したかの目安にもなります。
公開範囲とリポジトリの機密に配慮する
生成したHTMLには、未公開の文言やダミーデータ、社内向けの情報が含まれることがあります。一時公開ページには noindex が付いて検索結果には出にくいですが、noindex はアクセス制御ではありません。
社内のレビュアーに限定するなら会社ドメイン認証、社外の協力者に見せるならパスワードやメール認証が向きます。アクセスを絞ることで、確認用HTMLが意図せず広まるのを防げます。
ギガサイト便は確認・レビュー・一時共有に向く位置づけです。マージして本番に出す段階では独自ドメインでの運用に移し、レビュー中の画面確認はギガサイト便で回す、という使い分けが自然です。
よくある質問
プルリクエストに実画面のリンクを添えられますか?
はい。生成したHTMLをギガサイト便にのせて発行したURLを、PRの説明やコメントに貼れます。レビュアーはコードの差分と実際の画面の両方を見ながらレビューできます。
レビュアーにビルド環境を用意してもらう必要はありますか?
ありません。ビルド後の静的な出力を共有すれば、レビュアーはURLを開くだけで画面を確認できます。非エンジニアの関係者にも見てもらいやすくなります。
コミットを重ねるたびにリンクを貼り直す必要はありますか?
不要です。同じURLのままファイルを差し替えられるので、修正後のHTMLに置き換えれば、PRに貼ったURLを変えずに最新版を見せられます。
社内情報を含むHTMLを安全に見せるには?
会社ドメイン認証で社内に限定したり、社外にはパスワード・メール認証を使ったりして、見せる範囲を絞れます。公開期限も設定し、noindex だけに頼らず認証を併用するのが安全です。
AIツールで作ったHTMLはそのまま共有しても安全ですか?
そのまま共有せず、外部送信先、フォーム、APIキー、社内URL、画像パスを確認してからURL化します。ツールの共有機能や書き出し仕様は変わるため、最新画面も確認してください。