Codexで追加した説明文が
公開HTMLに
出ているか確認した
実践ログ

今回やった作業

Codexで説明guideや静的partsを追加したあと、partsファイルの存在確認だけで終わらせず、公開URLのHTMLを取得して、追加した文言が実際に出力されているか確認した作業を一般化します。

partsを作成しても、対象ページからrequireされていなければ公開ページには表示されません。また、条件分岐を誤ると、対象ページに出ない、または対象外ページに混入する可能性があります。

作業前の状態

説明guide用のpartsを作成し、対象ページに表示させる予定でした。ただし、require漏れや条件分岐ミスの可能性があり、ファイルが存在するだけでは公開表示とは言えませんでした。

そのため、公開HTMLにguide内の見出し文言や説明文が出ているかを確認する必要がありました。さらに、対象外ページに同じ文言が出ていないこともセットで見ます。

作業前に問題だったこと

Codexの報告で「partsを作成しました」とあっても、それが公開画面で見えているとは限りません。ファイル作成、require、条件分岐、公開HTML出力、実画面表示はそれぞれ別の確認項目です。

どこか1つでも抜けると、作ったのに表示されない状態になります。逆に、対象外ページに出てしまう場合もあるため、表示確認と非表示確認を分ける必要があります。

Codexに任せたこと

Codexには、partsファイルの存在確認、対象ページからrequireされているかの確認、条件分岐の確認、対象URLのHTTP確認、公開HTML取得、guide内の見出し文言grepを任せます。

あわせて、対象外ページでの非表示確認、canonicalとrobotsの維持確認も行います。ファイルを作ったかではなく、公開HTMLに出ているかまで確認するのが今回の中心です。

人間が判断したこと

人間が判断したのは、parts作成だけで完了にしないこと、公開HTMLに文言が出ていることを確認すること、対象外ページに混入していないことも確認することです。

Codex報告だけで完了判断せず、実画面での見え方は次の確認項目として扱います。まずは出力されているか、次に読める位置に出ているか、という順番です。

実際に使った指示文の考え方

指示文では「guideを追加してください」だけでは不足します。「対象URLをcurl -sで取得し、guide内の見出し文言をgrepしてください」「partsファイルの存在だけでは完了扱いにしないでください」と明記します。

さらに、対象ページでは表示、対象外ページでは非表示、canonicalとrobots維持を報告させることで、出力確認と影響確認の両方を残せます。

うまくいった点

公開HTMLを確認したことで、parts作成と公開表示を分けて判断できました。require漏れや条件分岐ミスがある場合でも、HTML上に文言がない時点で未完了と判断できます。

また、対象外ページの非表示確認も入れることで、guideが広がりすぎる事故を防ぎやすくなりました。

詰まった点・危なかった点

危なかったのは、ファイルがあるだけで表示済みと考えてしまうことです。Codexはファイル作成までは正しく行っていても、読み込み位置や条件分岐が違えば公開HTMLには出ません。

また、公開HTMLに出ていても、画面上で見やすいとは限りません。HTML確認は表示確認の入口であり、必要に応じてスマホ表示やスクリーンショット確認へ進みます。

作業後に確認したこと

作業後には、partsが存在すること、requireされていること、条件分岐を確認したこと、対象URLが200 OKであること、公開HTMLに文言が出ていることを確認します。

対象外ページに出ていないこと、canonicalとrobotsが維持されていること、noindexメタが入っていないことも報告に含めます。

次から使える指示文テンプレート

追加したguideが公開HTMLに出ているか確認してください。
対象URLをcurl -sで取得し、guide内の見出し文言をgrepしてください。
partsファイルの存在だけでは完了扱いにしないでください。
対象ページではguideが表示され、対象外ページでは表示されていないことを確認してください。
requireされていること、条件分岐が意図通りであること、canonicalとrobotsが維持されていることも報告してください。

確認チェックリスト

□ partsが存在する
□ requireされている
□ 条件分岐を確認した
□ 対象URLが200 OK
□ 公開HTMLに文言が出ている
□ 対象外ページに出ていない
□ canonicalが維持されている
□ robotsが維持されている
□ noindexが入っていない

関連する使い方ガイド

今回の確認は、公開HTML確認、対象外ページ確認、内部リンク確認、ランキングページ改善の考え方とつながります。必要に応じて、以下の関連ページも確認してください。

注意書き

この記事は特定の公式手順ではなく、公開中サイトでCodex作業を安全に進めるための実践ログです。実際の案件名、内部情報、サーバー情報、秘密情報は掲載していません。