Before ordering Codex

Codexに頼んでよい作業・頼まない方がよい作業

Codexは小さく切り出した作業ほど安全に使いやすくなります。一方で、本番影響が大きいもの、認証やDBに関わるもの、削除や一括変更は人間の判断を先に置く必要があります。

このページは非公式の実務ガイドです。重要な判断は人間が行い、最新情報やサービス仕様は提供元の情報も確認してください。
decision.md
before_order:
  scope: small
  allowed: clear
  forbidden: clear
  stop_conditions: required
verify:
  human_review: true

このページで分かること

Codexに頼みやすい小さなHTML修正、CSS調整、内部リンク確認と、慎重に扱うべき本番影響・認証情報・DB・cronなどの判断を整理します。

判断の基準

「Codexに頼むか、自分でやるか」の判定は、作業の難しさではなく依頼として成立させられるかで決まります。次の5つが書けるなら頼めます。書けないなら、まだ頼む段階ではありません。

基準書ける状態の例書けない時のサイン
小さく戻せる作業かバックアップから1〜2ファイル戻せば復旧できる戻し方を自分で説明できない→まず範囲を狭める
対象が明確か「このURLのこのセクション」と特定できる「サイト全体をいい感じに」→調査依頼から始める
触らないものを指定できるか「SEOタグ・ads.txt・共通CSSは変更禁止」と書ける何が危険か分からない→安全な小修正で経験を積む
確認方法があるか「作業後に〇〇のURLを開いて△△を確認」と決まっている確認手順が浮かばない作業は、結果の良否も判定できない
停止条件が書けるか「□□になったら止めて報告」と書ける想定外の展開を挙げられない→作業の理解が浅い可能性

興味深いのは、この5つを書き出す作業自体に価値があることです。書いているうちに「実は自分でやった方が早い」「そもそもやる必要がない」と気づくことも多く、依頼文づくりは作業の整理そのものになっています。

Codexに頼んでよい例

  • 誤字修正や表現の軽い補強
  • HTMLの小さな構造整理
  • CSSの余白やカード表示の微調整
  • 内部リンクの確認と未作成URLの除外
  • SEOタグが変わっていないかの確認

注意が必要な例

  • DBやcronに関わる作業
  • 認証情報や秘密情報に触れる可能性がある作業
  • 共通部品や全ページ一括置換
  • 公開判断や申請判断
  • 原因が分からないままの追加修正

やってはいけないこと

  • 何でもまとめて任せる
  • 重要ファイルを触ってよいと曖昧に伝える
  • 公開後確認を省略する
  • 報告書を読まずに次へ進む

Codexに渡す指示文例

この作業をCodexに頼んでよいか判断してください。対象、変更範囲、触らないもの、本番影響、停止条件、作業後確認に分けて、頼むべき作業と人間が判断すべき作業を整理してください。

自分でやった方が速い場合

頼めることでも、説明する手間の方が大きい場合があります。次のような作業は、自分で直接やる方が結果的に速く終わります。

作業頼むと自分でやると
1文字の修正対象の説明に時間がかかる数秒で終わる
自分にしか分からない判断前提の共有だけで長くなる迷わず決められる
実際に見ないと分からない確認状況を言葉で伝えるのが難しい開けばすぐ分かる
試行錯誤しながら決める作業やり取りの往復が増える手を動かしながら決められる

判断の目安は「指示を書く時間と、自分でやる時間のどちらが短いか」です。指示文を書くのに5分かかる作業が、自分でやれば1分で終わるなら、頼む意味はありません。

ただし、同じ作業が繰り返し発生する場合は例外です。一度テンプレートを作れば、2回目以降は指示を書く時間がほぼゼロになります。単発なら自分で、繰り返すなら仕組みにする、という切り分けが実務的です。

停止条件

  • 本番影響が大きい
  • 認証情報が必要になる
  • DBやcronの変更が必要になる
  • 失敗時の戻し方が不明
  • 人間の公開判断が必要

次に読むページ