GPT-6.2 Astraのプロンプトの書き方は、OpenAIが公式ガイド「Codex での GPT-6.2 のプロンプトの書き方」で公開しています。

ガイドは短く、節は 4 つです。対象は Codex での利用で、内容は GPT-6.2 Astra と GPT-6.2 Sol を含む GPT-6.2 のモデルファミリー全体に当てはまると書かれています。

この記事は、ガイドの内容を順に解説し、会社の運用での使用方法を追加します。

結論を先に書きます。

  1. 依頼には、成果物をレビューするときに確認する点を含めます。 手順を細かく指定するのではなく、完成の基準を伝えます
  2. 推論強度は、調査の深さで選択します。 概要は中程度、複数のシステムをまたぐ 1 つの原因は高、複数の原因が影響し合う場合は超高です
  3. AGENTS.md は簡潔に書きます。 コード、テスト、ドキュメントから読み取れない要件と規約、決まった手順だけを記載します

依頼に書く内容は、作業の手順ではなく、レビューで確認する点です。

GPT-6 Astra から変わった点

ガイドの冒頭は、前のモデルとの違いを説明しています。GPT-6 Astra と比べると、GPT-6.2 Astra は初回の出力から、実際に使用したいと思える仕上がりに近いものを返すことが多いとあります。

具体的には次の点です。

  • コードは読みやすく、レビューしやすい
  • 文章は早く要点に入る
  • スライドでは、重要な比較に目が向くように要素が配置される
  • 3D シーンでは、質感やライティングなどの細部がシーンに個性を与える

初回の出力が完成に近いほど、依頼に書く内容は変わります。細かい手順の指定より、完成の基準を伝えるほうが重要になります。

レビューで確認する点を、依頼に含める

ガイドの中心は次の 1 文です。プロジェクトを知っている同僚に頼むように必要なものを説明し、成果物をレビューするときに何を確認するかを Codex に伝えます。

ガイドの例はアイコンです。24 ピクセルのツールバーでもアイコンを見分けられる必要がある場合、その条件を明記します。

条件を書くと、Codex は既存のアイコンからスタイルを読み取り、そのサイズで細部がどこまで判別できるかを判断できると書かれています。

Codexへの依頼の書き方の比較の図。作業だけを書いた依頼は、ツールバーのアイコンを作成、既存のアイコンに合わせる、完成の基準がない。確認する点を含めた依頼は、ツールバーのアイコンを作成、24ピクセルのツールバーでも見分けられること、Codexが既存のアイコンからスタイルを読み取り、そのサイズで判別できる細部を判断する

この書き方は、人への依頼と同じです。プロジェクトを知っている同僚には、ファイルの場所や手順を説明しません。完成したものをどの基準で確認するかを伝えます。

確認する点は、成果物の種類で変わります。当社の整理では、次のような項目が該当します。

  • 画面の部品: 実際に表示されるサイズ、対応する端末
  • 文章: 読者、読者が最初に知りたい内容、長さの上限
  • 調査: 何をもって完了とするか、どこまで調べるか
  • コード: 通過するべきテスト、変更してよい範囲

推論強度は、調査の深さで選択する

ガイドは、必要な回答が数行だけでも、推論強度を上げる価値がある場合を説明しています。推論強度を上げると、モデルが長時間のタスクを最後の確認まで進めやすくなります。

推論強度と同時に伝える内容は 2 つです。何をもって完了とするか、どこまで網羅して調べてほしいかです。

ガイドの例は推奨案です。チームが推奨案を必要としている場合、有力な仮説を詳しく調査し、別の説明と見比べて検証するところまで依頼できます。

強度の選択の目安は、3 段階で示されています。

GPT-6.2の推論強度の選択の図。中程度は短時間で概要を把握する調査。高は疑わしい原因が1つで、複数のシステムをまたいで追跡する調査。超高は複数の原因が互いに影響する可能性があり、それぞれを考慮する必要がある調査

選択の基準は、回答の長さではありません。原因の数と、調査がまたぐシステムの数です。

ガイドの表現は断定ではない点にも注意します。高は「適している場合があります」、超高は「検討してください」と書かれています。自社のタスクで比較して決定します。

サブエージェントは、依頼に 1 文を追加する

タスクに、独立して進められる作業が複数ある場合の書き方です。ガイドは、必要に応じてサブエージェントを使うよう Codex に伝える方法を示しています。

この 1 文によって、並行作業が有効な場面と、タスクの分担の方法を、Codex が判断できるようになります。分担の方法まで人が指定する必要はありません。

同じ種類の作業が繰り返し発生する場合は、毎回の依頼に書きません。該当するスキルか AGENTS.md にその指示を書き、どのような場合に適用するかを明記します。

ガイドの例は調査用のスキルです。独立した問いが複数ある依頼に適用する、と条件を書きます。

ウルトラでは Codex が自分で判断する

ウルトラでは、サブエージェントをいつ使うかを Codex が自分で判断します。ガイドが挙げる用途は、規模が大きく、作業を明確に分割できる場合です。

例は、詳しく調査する価値のある問いが複数あり、調査の範囲が事前に決定していないプロジェクトです。

各エージェントは、それぞれの作業のコンテキストを維持しながら、担当する問いを調査できると書かれています。

参考画像でビジュアルを調整する

目指す見た目がある場合は、言葉より参考画像が有効です。ガイドによると、参考画像は、形の組み合わせ、目立たせたい色、最初に目を向けてほしい箇所を伝えられます。

参考画像の用意の方法は 2 つです。デザインツールから共有するか、GPT Image での作成を Codex に依頼します。

参考画像が目指す見た目を表現できた後の流れは、次のとおりです。

参考画像を使用したビジュアルの調整の流れの図。参考画像を用意し、素材を作成してレンダリングし、参考画像と見比べて調整し、利用者が実際に目にするサイズで確認し、操作できる成果物は想定している操作を実際に試す

確認の条件は 2 つあります。

1 つ目は、利用者が実際に目にするサイズで結果を確認させることです。大きくレンダリングしたときに見えていた細部が、製品に組み込むと見えなくなることがあるためです。

2 つ目は、操作できる成果物の場合です。想定している操作を実際に試すよう依頼します。

この節も、レビューで確認する点を伝えるという冒頭の原則と同じです。確認の条件を依頼に含めると、Codex は自分で確認してから成果物を返します。

編集可能なイラストや 3D モデルの作成には、SVG & 3D Design プラグインが案内されています。この手順で Codex が作業するためのスキルが含まれています。

AGENTS.md は簡潔に書く

AGENTS.md に記載する内容について、ガイドの基準は明確です。コード、テスト、ドキュメントから Codex が読み取れないプロジェクトの要件と規約を記載します。

プロジェクトで決まった作業の手順が必要な場合は、その手順も含めます。日常的な作業の進め方は、Codex の判断に任せます。

記載する 記載しない
コード、テスト、ドキュメントから読み取れない要件と規約 コードやテストを読むと判明する内容
プロジェクトで決まった作業の手順 日常的な作業の進め方
繰り返す作業の指示と、適用する条件 1 回だけの依頼の内容

表の 3 行目は、サブエージェントの節の内容です。右の列は、ガイドの基準を当社が反対側から書いたものです。

作業の環境に合わせた指示

ガイドは、環境ごとの指示の例も示しています。

Codex Cloud では、タスクごとに専用の仮想マシンが割り当てられます。一方、Codex の作業中も自分のコンピューターを使用し続ける場合があります。

その場合は、個人用の ~/.codex/AGENTS.md で、自分の作業を継続できるツールを優先するよう伝えます。

ガイドの例はメールです。メールを探す場合に、利用可能なメールコネクタを使うよう促すと、操作中のアプリにフォーカスを置いたままにできます。

複数のエージェントが 1 台のマシンを共有する場合の指示は、次の 3 点です。

  1. 同時に実行する必要があるビルドやテストの数を各エージェントに検討させ、ほかの作業に使用できる CPU とメモリを可能な範囲で確保する
  2. 負荷の高い処理には、必要に応じてマシンのリソースをすべて使用できるようにする
  3. 作業の終了時に、各エージェントが自分で起動したバックグラウンドジョブを停止し、自分で作成した一時ファイルを不要になった時点で削除する

会社の運用での使用方法

ここからは当社の見解です。

ガイドの 4 つの節には共通点があります。指示の量を増やす方向ではなく、判断をモデルに任せ、人は基準と条件を書く方向です。

会社の運用に置き換えると、作業は 2 つになります。

1 つ目は、依頼のテンプレートの変更です。手順を並べたテンプレートを使用している場合、完了の定義と確認する点の欄を追加します。手順の欄は、決まった手順がある業務にだけ残します。

2 つ目は、AGENTS.md の通読です。コードを読むと判明する内容を説明した行と、理由が不明な行を削除します。

当社は、リポジトリの AGENTS.md に、コードから読み取れない規約を記載しています。繰り返し使用する手順は、適用する条件を付けてスキルに分離しています。ガイドの基準と同じ構成です。

スキルは、下位のモデルでも実行できる手順書として書いています。上位のモデルには判断を任せ、決まった手順は誰が実行しても同じ結果になるように明示します。この 2 つは両立します。

Anthropicが Claude Fable 5.2 向けに公開したガイドも、以前のモデル向けの指示の削除を求めています。

内容は「Claude Fable 5.2のプロンプトの書き方、追加の前に削除する」で解説しています。

まとめ

GPT-6.2 Astra のプロンプトの書き方について、公式ガイドの要点は次のとおりです。

  • プロジェクトを知っている同僚に頼むように説明し、レビューで確認する点を伝える
  • 推論強度は調査の深さで選択する。完了の定義と、調べる範囲を伝える
  • 独立した作業が複数ある場合は、必要に応じてサブエージェントを使うよう伝える
  • 見た目は参考画像で伝え、利用者が実際に目にするサイズで確認させる
  • AGENTS.md には、読み取れない要件と規約、決まった手順だけを記載する

最初の作業は、次の依頼に確認する点を 1 行追加することです。成果物を受け取ったときに自分が最初に見る箇所を、依頼の中に書いてください。