Codex作業報告を信じすぎないための
確認リスト

今回やった作業

Codexの作業報告を読む時に、どこを確認すればよいかをチェックリスト化します。報告書に「完了」と書かれていても、公開ページに反映されているか、実画面で見えるか、クリック先が正しいかは別に確認する必要があります。

今回の5本は、1/8から7/8までで増やしてきたランキング、リンク、CSS、公開確認、表示確認、安全確認の実践ログを、運用として使いやすい形にまとめるためのページです。作業単体ではなく、次の作業で再利用できるテンプレートとして残します。

作業前の状態

作業前は、Codex報告では作業済みに見えても、実画面で見えにくい箇所やクリック先のズレが残る可能性がありました。公開HTMLで対象文言が出ているか、実画面で読めるか、触っていないファイルが明記されているかを確認する運用が必要でした。

作業前の段階では、実装、確認、報告、記事化候補が別々に扱われていました。実務では、この4つを分けて書くほどレビューしやすくなり、同じ失敗を繰り返しにくくなります。

作業前に問題だったこと

報告書をそのまま信じすぎると、ユーザーに見えていない修正を完了扱いしてしまいます。ファイルを作っただけ、調査しただけ、HTMLにはあるがCSSで見えにくい、リンク先が想定と違う、という状態は実務では完了とは言いにくい状態です。

特にCodex作業では、作業そのものが速いぶん、確認や報告が薄くなると危険です。何を確認したのか、何を確認していないのか、どのファイルを触っていないのかを残さないと、公開中サイトの運用では判断材料が不足します。

Codexに任せたこと

Codexには、公開HTML確認、実画面確認、クリック先確認、HTTP 200確認、canonicalとrobots確認、触っていないファイル確認、未確認事項の整理、報告書形式の固定化を任せました。確認したURLや対象文言も報告書に残します。

Codexには、ファイル作成やHTML修正だけでなく、確認項目の整理、公開HTMLの裏取り、内部リンクの確認、触っていない範囲の報告、実践ログ化候補の整理まで任せます。ただし、公開可否や表現の最終判断は人間が行います。

人間が判断したこと

人間が判断したのは、Codex報告だけで完了にしないことです。実画面を優先し、クリック先が違う場合や公開HTMLに出ていない場合は未完了として扱います。未確認事項がある場合は、未確認と書かせることも重要です。

人間の役割は、作業の目的、公開してよい情報、停止条件、最終確認の基準を決めることです。Codexの報告は重要な材料ですが、公開判断やサイト全体の方向性は人間が確認します。

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

指示文では、目的、対象ページ、変更してよいファイル、触らないファイル、禁止事項、停止条件、確認項目、報告書形式を分けます。長い指示文でも、項目が分かれていればレビューしやすくなります。

今回のような運用改善系では、作業結果だけでなく「次に使える形に残す」ことが大切です。チェックリストやテンプレートを記事内に残すことで、似た作業を始める時の迷いを減らせます。

うまくいった点

うまくいった点は、作業の目的と確認項目を分けて扱えたことです。Codexに実装だけを任せるのではなく、確認対象、停止条件、報告形式まで渡したことで、報告書を読み返した時に判断しやすくなりました。

また、公開HTML、実画面、リンク先、触っていないファイルを分けて確認したことで、単なる作業完了ではなく、公開中サイトとして見てもよい状態かを確認できました。

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

危なかった点は、確認項目が曖昧だと「作業しました」という報告だけで進んでしまうことです。実装済み、調査済み、公開確認済みは別の状態なので、報告書では分けて書かせる必要があります。

特に公開中サイトでは、本文やカードの修正に見えても、SEOタグ、広告タグ、内部リンク、CSS、sitemapへ影響する場合があります。触らないファイルと停止条件を最初に書くことで、作業範囲の広がりを抑えられます。

作業後に確認したこと

作業後は、対象ページのHTTP 200、title、description、canonical、robots、noindexなし、CSS読み込み、関連ページへの内部リンク、スマホ表示を確認します。

さらに、公開HTMLに対象文言やリンクが出ているか、実画面で読めるか、クリック先が想定通りか、触っていないものが報告書に残っているかを確認します。ここまで見て、初めて実務上の完了に近づきます。

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

次のような指示文にしておくと、Codexの作業報告を確認しやすくなります。

Codexの作業報告について、完了扱いにする前に以下を確認してください。

公開HTMLに対象文言やリンクが出ているか、ブラウザ上で見えるか、サムネイル・タイトル・ボタンのクリック先が想定通りか、HTTP 200か、canonicalとrobotsが維持されているかを確認してください。

また、DB、cron、.htaccess、robots.txt、ads.txt、広告タグ、Search Console確認タグを触っていないことも確認してください。

未確認事項がある場合は、完了ではなく未確認として報告してください。

確認チェックリスト

作業後は、次の項目を確認します。チェックリストは作業内容によって増減しますが、公開HTML、実画面、リンク先、触っていない範囲は毎回見たい項目です。

• 公開HTML確認
• 実画面確認
• クリック先確認
• HTTP 200確認
• canonical確認
• robots確認
• noindexなし
• 触っていないファイル確認
• 未確認事項の明記
• 報告と実態のズレ確認

注意書き

この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。

Codexや関連サービスの仕様は変わる可能性があります。作業対象サイトのルール、最新の公式情報、公開前チェックを確認し、最終判断は人間が行ってください。