For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
メインナビゲーション
Theme
Codex

Codex use case

目標に沿った作業

長時間の作業でも一貫して取り組めるよう、Codex に目標を設定します。

Difficulty Advanced
Time horizon Long-running

Codex が複数のターンにわたって作業を続け、終了条件を満たしたことを確認してから作業を終える必要がある場合は、/goal を使います。

Best for

  • 成功条件が明確で、検証を繰り返しながら進める長時間のコーディング作業
  • コード移行、大規模なリファクタリング、デプロイの再試行ループ、実験、ゲーム開発、サイドプロジェクトなど、Codex が決められた範囲で継続して進められる作業
  • 明確な成功基準を設けて長時間の実験を行う必要があるチーム

Contents

    ← All use cases

    目標に沿った作業

    長時間の作業でも一貫して取り組めるよう、Codex に目標を設定します。

    Codex が複数のターンにわたって作業を続け、終了条件を満たしたことを確認してから作業を終える必要がある場合は、/goal を使います。

    Advanced
    Long-running

    Codex が複数のターンにわたって作業を続け、終了条件を満たしたことを確認してから作業を終える必要がある場合は、/goal を使います。

    Advanced
    Long-running

    Best for

    • 成功条件が明確で、検証を繰り返しながら進める長時間のコーディング作業
    • コード移行、大規模なリファクタリング、デプロイの再試行ループ、実験、ゲーム開発、サイドプロジェクトなど、Codex が決められた範囲で継続して進められる作業
    • 明確な成功基準を設けて長時間の実験を行う必要があるチーム

    Starter prompt

    /goal [objective] を達成してください。[verifiable end state] を確認できるまで作業を続けてください。
    /goal [objective] を達成してください。[verifiable end state] を確認できるまで作業を続けてください。

    はじめに

    通常の 1 ターンで作業を終えず、1 つの目標に向けて Codex に作業を続けてもらいたいときは、/goal を使います。達成したいことが明確で、繰り返し結果を検証でき、手順を逐一指示しなくても Codex が進められる作業に適しています。/goal を使うと、追加の指示がなくても Codex は数時間にわたって自律的に作業できます。

    /goal <objective> で目標を設定し、/goal で現在の目標を確認できます。実行を一時停止するには /goal pause、再開するには /goal resume、目標を解除するには /goal clear を使います。

    /goal がスラッシュコマンドの一覧に表示されない場合は、features.goals を config.toml で有効にします。

    [features]
    goals = true

    CLI から codex features enable goals を実行するか、Codex に実行を依頼することもできます。

    目標に適した作業

    目標に適しているのは、1 回のプロンプトでは完結せず、どこまで進めれば完了かを決められる規模の作業です。Codex が達成すべきこと、変更してはいけないもの、進捗の検証方法、停止条件を明確にします。

    たとえば、次のような作業に適しています。

    • 移行先の技術スタック、移行前後の動作が同等かを確認する方法、制約が明確なコード移行
    • チェックポイントごとに Codex がテストを実行できる大規模なリファクタリング
    • 動作するものをもとに Codex が改良を重ねられる実験、ゲーム開発、プロトタイプ制作

    互いに関連のない作業をまとめて 1 つの目標にするのは避けてください。

    作業と検証の進め方

    1. 達成したいことと停止条件を 1 つずつ明示します。
    2. 最初に読む必要があるファイル、ドキュメント、Issue、ログ、計画を Codex に示します。
    3. 進捗を確認するためのコマンドや成果物を指定します。
    4. チェックポイントを設けて作業を進め、進捗を簡潔に記録するよう Codex に指示します。
    5. 実行中は /goal で状況を確認します。
    6. 作業が完了したとき、行き詰まったとき、方針を変えるときは、状況に応じて目標を一時停止、再開、または解除します。

    大切なのは、何をもって「完了」とするかを、作業に入る前に Codex と取り決めておくことです。たとえば移行なら、新しい実装が契約テストに合格し、従来の実装にロールバックできることを完了条件にできます。ゲームやプロトタイプなら、アプリをビルドして起動でき、提示した見本と一致するか、期待どおりに動作することを完了条件にできます。

    目標の設定も Codex に依頼できます。まず何を作りたいかを相談し、その内容をもとに目標を設定して作業を始めるよう Codex に頼んでください。

    Codex による自律的な作業

    目標に沿って安心して作業を任せられるよう、Codex には簡潔な進捗報告を求めます。現在のチェックポイント、検証済みの内容、残っている作業、進行を妨げているものの有無を報告してもらうと、状況を把握しやすくなります。 報告が曖昧になったら、その都度指示を追加するよりも、目標を具体化してください。次にどのチェックポイントに到達すべきか、どのコマンドで到達を確認できるか、どのような場合に一時停止すべきかを Codex に明示します。

    目標を設定すると、途中で様子を確認しなくても、Codex は何時間も自律的に作業できます。停止条件を満たしたと確信した時点で実行を終了するため、/goal は監視する必要のないバックグラウンドタスクとして扱えます。

    目標の例

    移行

    ゲームを新しい技術スタックに移す場合も、モバイルアプリを新しいプラットフォームに移す場合も、コードベースを新しいフレームワークに移す場合も、/goal で移行作業を Codex に任せられます。

    /goal このプロジェクトを [legacy stack or system] から [target stack or system] に移行してください。すべての画面の見た目を移行前と完全に同じに保ち、playwright interactive で表示結果を検証してください。

    プロトタイプ制作

    アプリを一から作る場合も、新しいゲームや機能を開発する場合も、/goal を使えば、完成度の高い初版を Codex に仕上げてもらえます。作りたいものを PLAN.md ファイルに具体的に記述しておくと、Codex はそれを指針に初版を作成できます。

    /goal PLAN.md に沿って実装し、マイルストーンごとにテストを作成して、playwright interactive で結果を検証してください。[include reference screens as needed]

    プロンプトの最適化

    評価スイートがあれば、/goal を使って評価結果に基づきプロンプトを最適化できます。Codex は失敗したケースを調べ、プロンプトを修正し、評価を再実行します。スコアが改善するか、指定した停止条件を満たすまで、この手順を繰り返せます。

    /goal [prompt file or directory] 内のプロンプトを、評価スイートの結果が [target score or pass rate] に達するまで最適化してください。変更のたびに [eval command] を実行し、失敗したケースを調べてください。プロンプトの修正は該当箇所に絞り、必要最小限にとどめてください。目標を達成した場合、またはこれ以上プロンプトを変更するには製品仕様やポリシーに関する指針が必要になった場合は、作業を停止してください。

    Related use cases