今回やった作業
一覧ページにguideを追加する際、同じPHPやControllerで個別ページも表示していないか確認し、一覧guideが個別ページへ混入しないようにした作業を一般化します。
一覧ページ用の説明は、個別ページでは不自然になることがあります。そこで、実ファイル、ルーティング条件、guide読み込み条件、公開HTMLを確認し、対象ページだけに表示されるかを見ました。
作業前の状態
一覧ページに説明guideを追加したい状態でした。ただし、一覧ページと個別ページが同じindex.phpやControllerを通っている可能性がありました。条件分岐を誤ると、一覧用guideが個別ページにも出る危険がありました。
代表個別ページで非表示確認が必要でした。1ページだけ見て問題ないと判断すると、別の個別ページに混入している可能性を見逃します。
作業前に問題だったこと
一覧ページ用の説明は、個別ページでは不自然になることがあります。たとえば、「この一覧では」と書いたguideが個別ページに出ると、読者はページの役割を誤解します。
共通ファイルにguideを追加すると、1ページだけのつもりが複数ページに出る可能性があります。そのため、URL構造やルーティング、条件分岐を確認し、対象ページだけに表示する必要があります。
Codexに任せたこと
Codexには、実ファイル確認、一覧と個別の分岐確認、guide読み込み条件確認、代表個別ページの確認、公開HTML grep確認、対象ページでの表示確認、対象外ページでの非表示確認、canonicalとrobots維持確認を任せます。
公開HTML grep確認では、guide文言の一部を対象にして、一覧ページには存在し、個別ページには存在しないことを確認します。ファイル上の条件だけでなく、公開出力を見るのが大切です。
人間が判断したこと
人間が判断したのは、一覧guideを個別ページへ混入させないことです。同じPHPを通る場合は条件分岐を厳密に見ます。代表個別ページを2〜3本確認し、個別ページには個別ページ用の説明が必要であることも整理します。
guideを共通部品へ入れる場合は便利ですが、影響範囲が広がります。対象外ページに混ざるくらいなら、表示条件を狭くするか、専用partsとして分ける方が安全です。
実際に使った指示文の考え方
指示文では、一覧ページにguideを追加する場合、同じPHPやControllerで個別ページも出していないか確認してください、と最初に書きます。一覧ページだけにguideが表示され、個別ページには表示されない条件分岐にしてください、と表示条件を明確にします。
代表個別ページを2〜3本確認し、公開HTMLでguide文言が出ていないことを確認してください、と書くことで、報告が具体的になります。対象ページでは表示、対象外ページでは非表示であることを報告させます。
うまくいった点
一覧guideの表示対象を限定できたことで、個別ページに不自然な説明が混ざるリスクを下げられました。公開HTMLで確認したことで、条件分岐が実際に効いているかを確認できました。
代表個別ページを複数見ることで、1ページだけの確認より安全になりました。Codex作業では、対象外ページの確認も同じくらい重要です。
詰まった点・危なかった点
同じファイルで一覧と個別を出している構成では、条件分岐を見誤るとguideが広範囲に出ます。共通部品に入れると便利な反面、対象外ページへ混入しやすくなります。
また、ローカルファイルだけ見ても、実際のURLでどの分岐が通るか分からないことがあります。公開HTMLでguide文言が出ているか、出ていないかを確認する必要があります。
作業後に確認したこと
作業後には、一覧ページにguideが表示されていること、個別ページにguideが非表示であること、代表個別ページを確認したこと、ルーティング条件を確認したこと、公開HTMLでgrep確認したことを確認します。
canonicalとrobotsが維持されていること、対象外ページに混入していないこと、共通表示が壊れていないことも報告に残します。
次から使える指示文テンプレート
次回同じ作業をCodexに頼む時は、作業範囲と停止条件を明確にして依頼します。
一覧ページにguideを追加する場合、同じPHPやControllerで個別ページも出していないか確認してください。
一覧ページだけにguideが表示され、個別ページには表示されない条件分岐にしてください。
代表個別ページを2〜3本確認し、公開HTMLでguide文言が出ていないことを確認してください。
対象ページではguideが表示され、対象外ページでは非表示であることを報告してください。
DB、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグは触らないでください。確認チェックリスト
作業後は、以下の項目を確認します。確認した内容を報告書に残すことで、次の作業へ安全につなげられます。
- 一覧ページにguideが表示
- 個別ページにguideが非表示
- 代表個別ページを確認
- ルーティング条件を確認
- 公開HTMLでgrep確認
- canonical / robots維持
- 対象外ページに混入していない
- 共通表示が壊れていない
関連する使い方ガイド
この作業は、公開前チェック、canonical、sitemap、robots、公開HTML確認、作業報告とつながります。関連ページも合わせて確認すると、Codexへの指示がより具体的になります。
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、秘密情報は掲載していません。特定サイトの公式手順ではなく、公開中サイトでSEO構造やguide表示条件を安全に確認するための実務上の考え方として整理しています。