GPT-6.2 Astraの取説
OpenAIは11月17日、GPT-6.2 AstraとGPT-6.2 Solをリリースしました。どちらもCodexで利用できます。OpenAIによると、Astraは前世代のGPT-6 Astraに比べて、最初に生成するコードが読みやすく、レビューしやすくなったそうです。リリース発表・Codex向け公式ガイド
この記事では、GPT-6.2 Astraに既存アプリの改修を頼むとき、どこまで細かく指示を書くかを考えます。公式ガイドを手掛かりに、同じ通知設定画面を作る依頼文を3通り比べてみましょう。見比べたいのは、既存の画面を見れば省ける指示と、今回の仕様として自分の言葉で伝える必要がある指示です。
① 見本を見ながら、全部書く
メール通知のオン・オフを切り替える画面を作るとします。既存のプロフィール設定画面は、項目を編集してから保存ボタンを押す作りです。新しい通知設定だけは、切り替えた瞬間に保存することが決まっています。
メール通知の設定画面を追加してください。プロフィール設定画面と同じように、左右の余白は16px、見出しは左揃え、説明文は項目名の下に置いてください。設定行には既存の共通部品を使ってください。メール通知のオン・オフは切り替えた時点で保存し、保存ボタンは置かないでください。
この依頼でも仕様は伝わります。気になるのは「左右の余白は16px」です。たとえば見本の16pxがスマホ幅のときだけの値なら、依頼文の方が元のデザインより不正確です。Codexが同じリポジトリの実装を読めるなら、どの画面のどの部分を参考にするのか、直接指定できます。
② 「既存画面に合わせて」まで縮める
メール通知のオン・オフを切り替える画面を追加してください。既存のプロフィール設定画面に合わせてください。
これで余白を書き写す手間は省けます。ただ、この文を受け取った開発者が、プロフィール画面と同じ保存ボタンを付けても不思議ではありません。「合わせて」の範囲には、見た目も操作も入るからです。
今回の「切り替えた時点で保存する」は、新しい画面のために決めた仕様です。見本をいくら丁寧に読んでも出てきません。むしろ、見本に忠実なほど意図から外れます。
③ 合わせる箇所と、今回変わる動作を書く
メール通知のオン・オフを切り替える画面を追加してください。レイアウトと設定行の部品は、既存のプロフィール設定画面に合わせてください。
通知設定はスイッチを切り替えた時点で保存します。保存ボタンは不要です。オンにして画面を開き直すとオンのまま、オフに戻して開き直すとオフのままになるところまで確認してください。
私ならこの依頼を使います。「既存画面に合わせて」を「レイアウトと設定行の部品」に絞ったので、何を引き継ぐかが明確です。最後の一文も残します。スイッチが画面上で動いただけでは、設定が保存されたか分からないからです。
ここで比べたのは、3つの依頼が実装者に渡す情報です。GPT-6.2で実際に何行削れるようになったかを測った結果ではありません。手元のプロジェクトで試すなら、①と③を同じ修正前のコードから別々に依頼し、普段使う画面幅での見た目と、再表示後の設定値を見比べてみてください。短くした依頼で見た目がずれたら、数値を書き戻す前に、参照先を一つに特定できたかを確認すると次の修正を決めやすくなります。
おわりに
公式ガイドは、コードやテスト、ドキュメントから読み取れないプロジェクト固有の取り決めを AGENTS.md に残すよう勧めています。この例なら、自動保存が通知設定だけの仕様なら今回の依頼に書けば足ります。今後追加するすべての設定画面で自動保存にするとチームで決めたら、その時点で共有ルールにする理由ができます。公式ガイドのAGENTS.mdに関する説明
次に「既存画面に合わせて」と書いたら、見本をそのままコピーされたときに困る箇所を一つ探してみてください。今回なら、余白の16pxは見本に任せられても、「保存ボタンは要らない」の一行は削れません。
