Codex Operating System AI Note
Codex運用

Codexには「作って」
ではなく「目的・制約・完了条件」を渡す

Codexに依頼するとき、「このページを作って」「この機能を直して」だけでは不十分である。AIは速く動けるが、何を変えてよく、何を変えてはいけないかを知らなければ、善意で余計な変更をする。だから依頼文の本体は、作業内容ではなく制約である。

Codexに目的、制約、完了条件を渡す設計を整理した図
Framework: 目的、制約、完了条件でCodexを安定させる

Codex依頼はお願いではなく、作業空間の設計である

Codexに「この機能を作って」とだけ伝えると、AIは目的を推測しながら動く。推測が当たれば速いが、外れれば余計なファイルを触り、既存のデザインやルールを崩す。AIの実装力が高いほど、曖昧な指示の被害も大きくなる。

だからCodex依頼では、作業内容より先に作業空間を決める。対象ディレクトリ、編集してよいファイル、触ってはいけないファイル、参照すべきテンプレート、完了条件を並べる。AIを自由にするのではなく、動いてよい範囲を明確にする。

これはAIを縛るためではない。むしろ、迷わず進めるための地図である。制約があるほど、Codexは安全に速く動ける。

Before

作業名だけ渡す

  • 何を作るかだけ言う
  • 制約を書かない
  • 判断まで丸投げする
After

制約で任せる

  • 目的を渡す
  • 制約を明示する
  • 完了条件で確認する

重要なのは、AIに何をさせるかではない。AIが安全に動ける作業空間を、人間がどこまで設計できるかである。

目的、対象、禁止、検収条件を一つのセットで渡す

よいCodex依頼には、最低でも四つの要素が必要である。何のためにやるのか。どこを変更するのか。何をしてはいけないのか。最後に何を満たせば完了なのか。この四点が揃うと、AIの作業はかなり安定する。

特に禁止事項は軽視しない方がよい。共通CSSを変えない、ルールファイルを編集しない、既存記事を触らない、機能追加をしない、などである。AIは改善のつもりで余計な修正をすることがあるため、禁止事項は品質を守るブレーキになる。

完了条件も重要である。表示確認、リンク確認、sitemap更新、差分の範囲、エラーがないこと。ゴールが明確であれば、Codexは作業後の確認まで含めて進めやすい。

従来
  • 成果物だけ見る
  • 流れを残さない
  • 毎回考え直す
これから
  • 作業の流れを作る
  • 任せる範囲を広げる
  • 実装だけを任せる

Codexには判断より、変換と整合性チェックを任せる

Codexが強いのは、決まったルールに沿ってファイルを作り、既存構造に合わせ、リンクやメタ情報を整える作業である。記事MarkdownをHTMLテンプレートへ流し込む。slugに合わせてcanonicalを作る。indexとsitemapを更新する。こうした整合性が求められる作業では非常に頼りになる。

一方で、戦略判断やブランド判断を丸投げすると危ない。この記事を公開すべきか、どの表現が自分らしいか、どのリスクを許容するかは人間が握るべきである。

つまりCodexは、決める存在ではなく形にする存在として使うと強い。人間が判断し、Codexが実装し、人間が差分を見る。この役割分担が安定運用の基本になる。

Step 01
Codex依頼はお願いではなく、作業空間の設計であるCodexに「この機能を作って」とだけ伝えると、AIは目的を推測しながら動く。推測が当たれば速いが、外れれば余計なファイルを触り、既存のデザインやルールを崩す。AIの実装力が高いほど、曖昧な指示の被害も大きくなる。
Step 02
目的、対象、禁止、検収条件を一つのセットで渡すよいCodex依頼には、最低でも四つの要素が必要である。何のためにやるのか。どこを変更するのか。何をしてはいけないのか。最後に何を満たせば完了なのか。この四点が揃うと、AIの作業はかなり安定する。
Step 03
Codexには判断より、変換と整合性チェックを任せるCodexが強いのは、決まったルールに沿ってファイルを作り、既存構造に合わせ、リンクやメタ情報を整える作業である。記事MarkdownをHTMLテンプレートへ流し込む。slugに合わせてcanonicalを作る。indexとsitemapを更新する。こうした整合性が求められる作業では非常に頼りになる。
Step 04
うまくいった依頼文は、次回の初期値にする毎回ゼロからCodex依頼を書くと、指示漏れが起きやすい。うまくいった依頼文は、そのままテンプレートにするべきである。変数として変えるのは、対象ディレクトリ、入力ファイル、出力先、作業タイプ程度でよい。

うまくいった依頼文は、次回の初期値にする

毎回ゼロからCodex依頼を書くと、指示漏れが起きやすい。うまくいった依頼文は、そのままテンプレートにするべきである。変数として変えるのは、対象ディレクトリ、入力ファイル、出力先、作業タイプ程度でよい。

テンプレート化すると、依頼の品質が安定する。AIに伝えるべき前提が固定され、禁止事項も漏れにくくなる。さらに、失敗した点を次回テンプレートに追記すれば、運用そのものが強くなる。

Codex運用の成熟とは、すごい依頼を毎回考えることではない。普通の依頼を、何度でも安定して出せる状態を作ることである。

起点
Codex依頼は制約設計
設計
目的・制約・範囲を渡す
資産
Codexには実装作業を任せる

弱い使い方と強い使い方を分けて考える

Codex依頼を作業指示ではなく制約設計として捉え、目的・編集範囲・禁止事項・完了条件を渡すことで実装品質を安定させる。

Weak Pattern

弱い使い方

  • 作業名だけ渡す
  • 制約を書かない
  • 判断まで丸投げする
Strong Pattern

強い使い方

  • 目的を渡す
  • 禁止事項を渡す
  • 完了条件で止める

Codexを安定させるのは、作業条件の設計である

Codexに任せる前に、目的、対象、禁止事項、完了条件を定義する。判断を丸投げせず、作業空間を人間が設計することで、AIは既存構造を壊さず実装担当として機能する。

Codexには自由ではなく、動ける範囲を渡す。
制約が明確なほど、実装は速く安全になる。

Source Notes
  • Codex依頼は「作業指示」ではなく「制約設計」
  • “作って”ではなく“目的・制約・作業範囲”を渡すと任せやすい
  • Codexには「設計判断」ではなく「実装作業」を任せると強い