確認作業の1ポイント
作業前の指示と、作業後の確認を分ける
テンプレート、チェックリスト、報告書、ロールバックは、Codex作業を安全に閉じるための道具です。急いで次へ進む前に確認項目を見直しましょう。
報告書をもらったら、すぐ次に進めていい？
変更ファイル、触っていないファイル、停止条件、公開URL確認を見てから判断しましょう。
今回やった作業
CodexでCSS修正を行う時に、失敗を避けるための確認項目をチェックリスト化します。CSSは小さな変更に見えても、カード、ボタン、余白、スマホ表示、横スクロールへ広く影響することがあります。
今回の5本は、1/8から7/8までで増やしてきたランキング、リンク、CSS、公開確認、表示確認、安全確認の実践ログを、運用として使いやすい形にまとめるためのページです。作業単体ではなく、次の作業で再利用できるテンプレートとして残します。
作業前の状態
作業前は、CSS変更で表示改善をしたい状態でした。しかし過去には、変更後に実画面が悪化したり、キャッシュで反映確認が分かりにくくなったり、PCでは良くてもスマホで読みにくくなるケースがありました。
作業前の段階では、実装、確認、報告、記事化候補が別々に扱われていました。実務では、この4つを分けて書くほどレビューしやすくなり、同じ失敗を繰り返しにくくなります。
作業前に問題だったこと
CSS修正は、原因未特定のまま積み増すと戻しにくくなります。どのファイルを変えたのか、直前変更は何か、バックアップはあるか、キャッシュは残っていないか、PCとスマホでどう見えるかを分けて確認する必要があります。
特にCodex作業では、作業そのものが速いぶん、確認や報告が薄くなると危険です。何を確認したのか、何を確認していないのか、どのファイルを触っていないのかを残さないと、公開中サイトの運用では判断材料が不足します。
Codexに任せたこと
Codexには、変更CSSファイルの確認、バックアップ確認、キャッシュ確認、PC表示確認、スマホ表示確認、公開HTMLのclass確認、悪化時のロールバック案確認、触っていないファイルの確認を任せました。
Codexには、ファイル作成やHTML修正だけでなく、確認項目の整理、公開HTMLの裏取り、内部リンクの確認、触っていない範囲の報告、実践ログ化候補の整理まで任せます。ただし、公開可否や表現の最終判断は人間が行います。
人間が判断したこと
人間が判断したのは、原因未特定のままCSSを積み増さないことです。悪化した場合は直前変更を戻す案を優先し、PCとスマホを別に見ます。CSS変更後は公開HTMLと実画面の両方で確認します。
人間の役割は、作業の目的、公開してよい情報、停止条件、最終確認の基準を決めることです。Codexの報告は重要な材料ですが、公開判断やサイト全体の方向性は人間が確認します。
実際に使った指示文の考え方
指示文では、目的、対象ページ、変更してよいファイル、触らないファイル、禁止事項、停止条件、確認項目、報告書形式を分けます。長い指示文でも、項目が分かれていればレビューしやすくなります。
今回のような運用改善系では、作業結果だけでなく「次に使える形に残す」ことが大切です。チェックリストやテンプレートを記事内に残すことで、似た作業を始める時の迷いを減らせます。
うまくいった点
うまくいった点は、作業の目的と確認項目を分けて扱えたことです。Codexに実装だけを任せるのではなく、確認対象、停止条件、報告形式まで渡したことで、報告書を読み返した時に判断しやすくなりました。
また、公開HTML、実画面、リンク先、触っていないファイルを分けて確認したことで、単なる作業完了ではなく、公開中サイトとして見てもよい状態かを確認できました。
詰まった点・危なかった点
危なかった点は、確認項目が曖昧だと「作業しました」という報告だけで進んでしまうことです。実装済み、調査済み、公開確認済みは別の状態なので、報告書では分けて書かせる必要があります。
特に公開中サイトでは、本文やカードの修正に見えても、SEOタグ、広告タグ、内部リンク、CSS、sitemapへ影響する場合があります。触らないファイルと停止条件を最初に書くことで、作業範囲の広がりを抑えられます。
作業後に確認したこと
作業後は、対象ページのHTTP 200、title、description、canonical、robots、noindexなし、CSS読み込み、関連ページへの内部リンク、スマホ表示を確認します。
さらに、公開HTMLに対象文言やリンクが出ているか、実画面で読めるか、クリック先が想定通りか、触っていないものが報告書に残っているかを確認します。ここまで見て、初めて実務上の完了に近づきます。
次から使える指示文テンプレート
次のような指示文にしておくと、Codexの作業報告を確認しやすくなります。
以下の公開中サイトでCSS修正を行う前に、安全確認をしてください。
変更するCSSファイル、直前変更、バックアップ、影響するページ、PC表示、スマホ表示、横スクロール、ボタン配置、CSSキャッシュの有無を確認してください。
修正後に悪化した場合は、追加CSSを重ねず、直前変更だけ戻す案を出してください。
DB、cron、.htaccess、robots.txt、ads.txt、広告タグは触らないでください。確認チェックリスト
作業後は、次の項目を確認します。チェックリストは作業内容によって増減しますが、公開HTML、実画面、リンク先、触っていない範囲は毎回見たい項目です。
- 変更CSSファイルを確認
- バックアップあり
- 直前変更を特定
- CSSキャッシュを確認
- PC表示確認
- スマホ表示確認
- 横スクロールなし
- ボタン配置確認
- 悪化時の戻し方あり
- DB / cron / .htaccess 変更なし
注意書き
この記事は、実際の作業を一般化してまとめた実践ログ型ガイドです。具体的な案件名、内部情報、サーバーパス、秘密情報は掲載していません。
Codexや関連サービスの仕様は変わる可能性があります。作業対象サイトのルール、最新の公式情報、公開前チェックを確認し、最終判断は人間が行ってください。