AI活用

Codex CLIで生成した社内ツール風プロトタイプをレビュー用URLにして共有する方法

Codex CLIで社内ツール風のプロトタイプを素早く作れるようになった一方、それを関係者に共有する手段が「ファイルを直接送る」しかなく、レビューの手間がかかっていないだろうか。HTMLファイルをURLとして発行できれば、相手はブラウザで開くだけでよく、インストール作業が一切不要になる。社内ツールのプロトタイプに特有の注意点と共有フローを解説する。

何が共有しづらいのか

社内ツールのプロトタイプはダミーデータであっても実際の社員名や部署名・案件コードが混入しやすい。Codex CLIにプロンプトで「社内の営業管理ツール」などと伝えると、プロンプトに含めたサンプルデータをそのままHTMLに埋め込む。URLで共有する前に、テーブルや入力欄のデフォルト値に本物の固有名詞が入っていないかを必ず確認する。

社内ツールのプロトタイプはPC画面での操作を想定して作られることが多く、スマートフォンでのレイアウト確認が後回しになりがちだ。決裁者がスマホで確認するケースも増えているため、URLを発行したらまず自分のスマホで開き、横スクロールが発生していないか・ボタンのタップ領域が十分かを確認してから共有する。

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

URL化する前の確認点

社内ツール風のUIにはモーダルやタブ切り替えなどのインタラクションが含まれることが多く、JavaScriptエラーが発生しても画面が固まるだけで気づきにくい。ブラウザのコンソールを開いた状態で全機能を一巡し、赤いエラーが出ていないことを確認してからURLを発行する。特にCodex CLIが生成したコードはiframe内のDOM操作でエラーになるケースがある。

HTMLファイルにローカルの絶対パス(`C:\Users\...`や`/Users/...`形式)で画像やCSS・JSが参照されていると、URL発行後に相手のブラウザではリソースが読み込まれずレイアウトが崩れる。`src`属性と`href`属性をすべて検索し、相対パスか外部URLになっているかを確認する。zip形式でまとめてアップロードする方法を使えば、相対パスのリソースも問題なく配信できる。

  • HTML内の外部script・form action・iframeを確認する
  • APIキーやトークンらしき文字列がないか検索する
  • 画像・CSS・JSのパスが公開後も解決できるか見る
  • noindexと認証を混同せず、必要なら両方設定する

認証と期限の決め方

社内ツールのプロトタイプは、競合他社に見られると製品戦略が漏れるリスクがある。「部署内の数名だけに共有する」用途ではメール認証が最も適している。あらかじめ許可するメールアドレスを登録しておくと、登録外の人はURLを知っていてもアクセスできないため、転送リスクを最小化できる。

開発フェーズごとにプロトタイプのURLが増えると、どのバージョンが最新かが不明になる。各フェーズのURLに「要件確認用(2週間)」「デザインレビュー用(1週間)」など目的と期限を添えてドキュメントに記録しておくと、旧バージョンへのアクセスを期限切れで自動停止でき、管理コストが下がる。

  • 誰でも見てよい: URL共有のみでもよいが、検索除外は確認する
  • 特定の相手だけ: パスワードまたはメール認証を使う
  • 会社内だけ: 会社ドメイン認証を検討する
  • 短期レビュー: 期限を設定して古いURLを残さない

共有後のフィードバック回収

社内ツールのレビューでは「実際の業務フローと合っているか」を確認してもらうことが最重要だ。依頼メッセージに「現状の手作業と比較して、どのステップが自動化されていますか?」という具体的な問いを一つ入れるだけで、抽象的な感想ではなく業務に即したフィードバックが得られやすくなる。

複数の部署担当者にレビューを依頼する場合、それぞれに個別のURLを発行せず一つのURLを共有しつつ、Google Formなどで意見を集約する方法が効率的だ。フィードバックのフォームURLをレビュー依頼メッセージに同封し、「URLを見た後はこちらのフォームへ」と誘導することでSlackのスレッドが散らかるのを防げる。

  • 確認してほしい観点を3つ以内に絞る
  • 期限と返信先を明記する
  • 修正後も同じURLで見られるか伝える
  • 最終版と途中版が混ざらないようタイトルを付ける

よくある質問

ダミーデータに本物の社員名が混入していないかを効率的に確認する方法は?

HTMLファイルをテキストエディタで開き、社内ドメインや実際の名前のパターンで検索する。Codex CLIのプロンプト履歴も確認し、入力に含めたサンプルデータが出力に残っていないかをチェックするのが確実だ。

社内の複数部署に同時にレビューを依頼する場合、URLは部署ごとに分けるべきか?

基本的に一つのURLを共有し、フィードバックの収集先(Google FormやNotionコメントなど)を一本化する方が管理しやすい。ただし部署間で見せたくない情報がある場合は個別URLとメール認証の組み合わせを検討する。

プロトタイプのURLを社内Wikiに貼る場合、アクセス制御はどうすればよいか?

Wikiの閲覧権限と一致させるのが基本方針だ。Wikiが社内限定であればパスワードなしのURL共有でも許容される場合があるが、機密度の高い内容ならパスワードかメール認証を別途設定してWikiとURLの二重管理とする。

関連記事

「AI活用」の記事をもっと見る →