Codexで変更箇所を探す

画面の文章を直したいのに、どのファイルに書かれているか分からない。そんなときは、Codexにファイル名だけでなく、画面の文言や参照関係から探してもらえます。

この記事では、候補を見つける、編集する正本を確かめる、影響を調べる、という順番を説明します。プロジェクト全体の構成理解よりも、一つの変更箇所を探す場面に絞っています。

手がかりを一つ渡す

検索の手がかりには、画面に出ている文章、ファイル名の一部、関数名、エラーメッセージなどがあります。覚えているものをそのまま伝えます。

案内ページに表示される「イベントのご案内」という見出しを変更したいです。
まだ編集せず、この文字列がどのファイルにあるか調べてください。
一致した場所のうち、編集する正本はどれかを根拠付きで説明してください。
生成物やバックアップにも一致した場合は、分けて示してください。

この例の文章は練習用ページの index.html にあります。ZIPを展開したコピーで、実際に検索する練習ができます。

各段階で確認してから、次の操作へ進みます。

図解Codexで変更箇所を探す：進める順番

具体的な依頼と、結果の確かめ方は本文にあります。

検索で見つかった場所を、すぐにすべて置換しないのがポイントです。正本と影響範囲を確認してから、変更を依頼します。

ファイル名の検索と、ファイルの中身の検索は別です。たとえば styles.css を探すことと、「参加方法」という文章を探すことでは、調べる対象が違います。

同じ文言が本文、テスト、README、出力ファイルにある場合があります。まず目的の画面を作っているファイルに絞ります。

一致した場所を、本文の正本・テスト・説明書・生成物に分けてください。
今回は画面の見出しだけを変更したいです。
生成物を直接編集する必要があるか、生成元を変更するべきか確認してください。

検索結果の分類はファイル名だけで決めず、プロジェクトの構成やビルド設定と照合します。生成物だけを書き換えると、次のビルドで元に戻ることがあります。

画面では一続きの文章でも、ソースでは複数の部品や変数から作られている場合があります。完全一致しないときは、特徴のある短い一部分を探します。

完全一致しない場合は「イベント」など特徴的な部分でも調べてください。
外部データや翻訳ファイルから表示している可能性も確認してください。
見つからなければ、検索した範囲と次に必要な手がかりを示してください。

検索範囲の外、無視されるファイル、別のプロジェクトを開いている可能性もあります。「見つからなかった」と「存在しない」を区別します。

関数名や見出しIDを変える場合は、それを呼ぶ場所やリンクする場所も関係します。一箇所だけ直すと参照が切れることがあるため、次のように依頼できます。

この名前を使っている場所も調べてください。
表示文言だけの変更で済むか、参照先にも影響するかを分けてください。
必要な差分を確認してから、関連する範囲だけ変更してください。

画面に見える文章と、内部の識別名を分けられる場合は、表示だけを変えて参照を保てます。判断に迷う場合は変更前の計画へ対象と影響をまとめます。

変更するファイルが特定できたら、目的の文言が実際に変わったかを画面で確かめます。さらに差分を確認し、同じ文字列の無関係な箇所まで変わっていないかを見ます。

検索結果の一覧は、動作確認の代わりにはなりません。表示やテストを実行できない場合は、その点を未確認として残します。この記事の依頼は、Codexがアクセスできるプロジェクト内の範囲を対象にしています。