Codex practical hub

Codex実務の読み順まとめ

Codexに頼む前、作業中、作業後、トラブル時で読むページを分けると、迷いにくく安全に進められます。

このページは非公式の実務ガイドです。重要な判断は人間が行い、最新情報は提供元の情報も確認してください。

workflow.md

before:
  - choose_template
during:
  - stop_if_risky
after:
  - verify_with_checklist

Codexに頼む前

まずCodexの基本と、ChatGPTで整理してから渡す流れを確認します。

作業内容に合う指示文を選び、触ってよいものと触らないものを分けて渡します。

公開前後、SEOタグ、内部リンク、画像、cron、GitHub、AdSenseを用途別に確認します。

404、500、CSS崩れ、報告書とのズレなどは、症状別に確認して戻す判断をします。

実際の作業を一般化した実践ログで、確認や判断の流れを学びます。

Codexを実務で使い始めた人がつまずく箇所には、はっきりした傾向があります。多くの人が同じ順番で同じ壁に当たるため、先に知っておくと備えができます。

時期	つまずくこと	解決の方向
使い始め	頼み方が曖昧で、意図と違うものが出てくる	対象ファイルと完了条件を書く習慣をつける
少し慣れた頃	作業は進むが、確認が追いつかず「本当に直ったか」が不明になる	作業後の確認項目を固定し、毎回同じ手順で見る
本格運用の入口	複数作業が並行して、どれが終わったか分からなくなる	状態管理（完了・保留・停止）を導入する
継続運用	過去の作業を思い出せず、同じ調査を繰り返す	作業記録を残し、翌日確認を習慣にする

共通しているのは、作業そのものより「確認」と「記録」で行き詰まるという点です。AIに任せられるのは手を動かす部分で、確認と記録の設計は人間側に残ります。ここを最初から意識しておくと、慣れてきた時期の混乱を避けられます。

頼む前・作業中・作業後・トラブル時という区切りは、1回の作業で1周します。どこかを飛ばすと、飛ばした分が後で問題として戻ってきます。

時間がない時に飛ばされやすいのは3番目の確認ですが、ここを飛ばすと「終わったつもり」の作業が積み上がります。作業を1本減らしてでも、確認までを1周させる方が結果的に前に進みます。

5つのセクションを全部読む必要はありません。今どの段階にいるかで、優先して開くページを絞ります。