Codex practical hub

Codexトラブル対応の入口

何か壊れた時は、直し続ける前に止めて、症状別に確認します。戻す判断と確認項目を分けて見るのが安全です。

このページは非公式の実務ガイドです。重要な判断は人間が行い、最新情報は提供元の情報も確認してください。
workflow.md
before:
  - choose_template
during:
  - stop_if_risky
after:
  - verify_with_checklist

表示されない・エラーが出る

404や500は、URL、配置、設定、構文、ログを分けて確認します。

見た目やSEOが変わった

CSS崩れやSEOタグ変更は、差分と変更前の状態を確認します。

重要ファイルや公開先の問題

sitemap.xml、robots.txt、アップロード先違いは、既存URLや公開ディレクトリを慎重に見ます。

運用や報告のズレ

cronが動かない、報告書と実際が違う場合は、ログと公開URLを確認します。

症状から原因を絞る早見表

トラブルは、症状ごとに疑うべき箇所がほぼ決まっています。心当たりを探す前に、この対応関係で当たりをつけると調査が短く済みます。

症状まず疑うところ次に疑うところ
特定のページだけ開けないURLの綴り、ファイルの配置場所リンク元のhrefが実在URLか
サイト全体が開けない直前に触った共通ファイル(.htaccess等)サーバー側の障害
見た目だけ崩れたCSSファイルの読み込みパス、キャッシュHTMLのタグの閉じ忘れ
画像だけ出ない画像のパス、大文字小文字の違いアップロード漏れ
検索結果に出なくなったnoindexの混入robots.txtの記述、canonicalの向き先
自動処理が動いていないログの最終更新時刻PATH・作業ディレクトリ・権限

共通するコツは、影響範囲から考えることです。1ページだけの問題ならそのページ固有の要素を、サイト全体の問題なら共通設定を疑います。この切り分けを最初にするだけで、探す範囲が大きく狭まります。

戻す判断

原因が読めない時は、次の修正を重ねず、戻す範囲を決めます。

Codexに頼む前の判断ページ

Codexに作業を依頼する前に、頼んでよい作業、人間が決める作業、止める条件を整理できるようにしました。

codex doctorで状態確認する

Codex CLIが起動しない、認証やネットワークが不安、報告前に状態を整理したい時は、codex doctor で診断結果を確認します。出力を貼る前に、秘密情報やローカルパスを伏せることも忘れないようにします。