OpenAIクックブックは最近、「GPT-5.1-Codex-Max Prompting Guide」をリリースし、エージェントと開発者ツールのシナリオにおけるモデルのプロンプト設計パラダイムを体系的に整理しています。 この文書はCodex-Maxを「インテリジェントなアサナコーディング」モデルとして位置づけ、細かいシステムプロンプトやツール慣習を用いて多段階の修正、デバッグ、実際のコードベースでのリファクタリング、そしてResponses APIとの深い統合を導くことを強調しています。
ガイドは推奨されるシステムプロンプト構造を詳しく説明しており、モデルに対して「厳密なエンジニア」的な考え方で正確性と安定性を優先すること、広範な試み/キャッチ、サイレント失敗、任意の型アサーションの回避、そして修正前に論理修正の完全な文脈読み取りとバッチ編集を推奨することが含まれます。 ドキュメントでは編集上の制約も明確にしています。例えば、単一ファイルの更新にはapply_patchを使用すること、要求されていない変更はロールバックしないこと、危険なgitコマンドの使用を控えること、予期しないファイル変更があった場合はすぐに停止してユーザーに確認すること。
ツールの使用に関しては、ガイダンスではファイルや検索結果をmulti_tool_use.parallelで並列に読み込み、シリアル呼び出しを減らし、apply_patch、shell_command、update_planなどのツールの標準定義の例を示すことを推奨しています。 また、長い会話や長いリンクタスクで重要な情報を保持するための/responses/コンパクトコンテキスト圧縮メカニズムも説明しています。 また、Codexシリーズは「推論サマリー」を活用してユーザーにMidjourneyの計画を示していることを強調しています。これは独立したモデルによって部分的に生成され、プロンプトの手動介入なしに行われます。 全体として、このガイドはGPT-5.1-Codex-MaxをベースにしたIDEプラグインやコードエージェントを構築するための比較的完全なエンジニアリング実践テンプレートを提供しています。
よくある質問
Q: このプロンプティングガイドは誰向けのですか?
A: 主に開発者やチーム向けに、IDE、CLI、または自作のエージェントに統合してシステムプロンプトやツールプロトコルを設計したい場合です。
Q: なぜガイドはapply_patchの使用を強調しているのですか?
A: モデルはこの差分フォーマット向けに特別に訓練されているため、適用可能なパッチをより一貫して生成でき、誤ってコードの削除やフォーマットの混乱のリスクを減らします。
Q: multi_tool_use.parallelの役割は何ですか?
A: 複数のファイルの読み込み、検索、その他の操作を並行してパッケージ化・実行するために使われ、往復回数を減らし、複雑なタスクの効率と安定性を向上させます。
Q: /responses/compact context 圧縮はいつ使われますか?
A: 会話やツールコール履歴がコンテキストの上限に近い場合、このエンドポイントを通じて圧縮版を生成でき、長期間のタスクを重要な情報を失うことなく継続できるようにします。
Q: ガイドにおけるシェル使用のセキュリティ要件は何ですか?
A: 作業内容、タイムアウト、権限のエスカレーションが必要かどうかを明確にするために、制限されたshell_commandツールでコマンドを実行することが推奨されており、危険なgitやシステムを破壊する操作を直接使用することは厳しく禁止されています。
