このマニュアルで分かること
Codexトラブル対応マニュアルです。404、500、CSS崩れ、SEOタグ変更、sitemap.xml / robots.txt、cron、アップロード場所ミス、報告書との不一致を整理します。
使うタイミング
Codex作業後に表示や設定、報告内容に違和感がある時に使います。
全体の流れ
- 症状を切り分ける
- 公開URLで確認する
- 変更ファイルを見る
- 触っていないファイルを確認する
- 停止条件に該当するか判断する
- 戻す範囲を決める
- 再確認指示を出す
チェックリスト
- 症状が具体的に分かれている
- 公開URLで確認した
- 変更ファイルを見た
- 戻す対象を決めた
- 大きな追加修正を重ねていない
- 人間が最終判断する
Codexに頼む時の指示例
Codex作業でトラブルが起きています。症状、公開URL、変更ファイル、触っていないファイル、停止条件、戻す候補、再確認すべき項目を整理して報告してください。原因不明のまま追加修正しないでください。トラブル対応は「復旧」と「原因究明」を分ける
不具合が起きた時に慌ててしまう原因は、復旧と原因究明を同時にやろうとするからです。この2つは目的が違うため、順番に進める方が結果的に速く終わります。
| 復旧 | 原因究明 | |
|---|---|---|
| 目的 | 今すぐ正常な状態に戻す | なぜ起きたかを理解し、再発を防ぐ |
| 手段 | 直前の変更を戻す、バックアップから復元する | 差分を読む、ログを追う、条件を絞る |
| 優先度 | 公開中のサイトが壊れているなら最優先 | 復旧後に落ち着いて行う |
| 失敗しやすい点 | 原因を探しながら直そうとして時間を失う | 復旧を急ぐあまり、証拠を消してしまう |
復旧を優先する場合でも、戻す前の状態を控えておくと原因究明の材料が残ります。壊れたファイルを別名で保存してから正常版に差し替えれば、復旧と証拠保全を両立できます。原因が分からないまま復旧しただけだと、同じ操作でまた同じ不具合を起こします。
停止条件
- 500が出ている
- 重要ファイル破損の可能性がある
- 原因が不明
- 既存ページが消えた
- 報告書と実際が違う