GPT-5.5 プロンプトガイドの要点｜旧モデルからの移行で「やり直し」が推奨される理由

GPT-5.5とは、OpenAIが新たにAPI公開した最新世代の汎用言語モデル。

OpenAIがGPT-5.5をAPIで公開しました。同時に出てきたのが、新モデル向けのプロンプティングガイドと移行ガイド。注目すべきはモデル性能の数字ではありません。OpenAI自身が「旧プロンプトをそのまま使うな」と公式に釘を刺している点。これは過去のリリースではあまり見なかったトーンです。

GPT-5.5がAPI公開、OpenAIが示したプロンプト方針

GPT-5.5のAPI提供開始にあわせ、OpenAIは「Using GPT-5.5」と題したプロンプティングガイドを公開しました。中心メッセージはひとつ。「これはgpt-5.2やgpt-5.4のドロップイン置換ではない」というもの。新しいモデルファミリーとして、ゼロからチューニングし直す前提で扱ってほしい、とOpenAIは明言しています。

公式ガイドの冒頭にはこうあります。「GPT-5.5の力を引き出すには、古いプロンプトスタックの全指示を持ち越すのではなく、新しいベースラインから移行を始めよ」。商品契約（product contract）を維持できる最小限のプロンプトから出発し、推論努力（reasoning effort）、冗長度（verbosity）、ツール記述、出力フォーマットを代表例で再調整するべき、という指針。

公開されたガイドと移行ガイドの位置づけ

OpenAIが今回出した文書は2系統です。ひとつは新モデルでの書き方を解説する「Using GPT-5.5」ガイド、もうひとつは旧モデルからの乗り換え手順をまとめた移行ガイド。後者にはプロンプトの書き換え指針まで踏み込んだ記述が含まれています。

実装面で面白いのが、Codexアプリ向けの移行コマンドが用意された点。openai-docs migrate this project to gpt-5.5 をCodexに投げると、コーディングエージェントが移行ガイドの内容を参照しながら、既存コードのプロンプト周辺を書き換えていく、という流れ。OpenAIが自社ツールに「移行作業の自動化」を組み込んできたわけです。

「ドロップイン置換ではない」という公式の警告

ここまで強い言葉でOpenAIが互換性を否定するのは珍しい光景。背景には、過去のGPT系列で「モデルだけ差し替えて品質が落ちた」事例が積み重なってきた経緯があると考えられます。プロンプトはモデルの癖に強く依存します。新世代の挙動が変われば、旧世代用に最適化された指示文は逆に足を引っ張る側に回る、という構造。

この警告を素直に読むなら、「APIのモデル名だけ書き換えて済ませる」運用は今回は通用しないと割り切ったほうが安全。少なくとも代表的なユースケースで挙動を比較し、出力の安定性を確認するプロセスは避けて通れない仕事になります。

旧プロンプトをそのまま使うな、最小構成からチューニングする

OpenAIが提示する「smallest prompt that preserves the product contract（商品契約を保つ最小プロンプト）」という言い回し。これは単なるテクニック以上の意味を持ちます。プロンプトを継ぎ足し続けてきた組織にとって、新モデルへの移行は「過去資産の棚卸し」を強制するイベントになる、ということ。

4つのチューニング軸

公式が挙げているチューニング対象は4つに整理できます。

ひとつ目はreasoning effort。モデルがどれくらい深く考えてから答えを返すかを制御する軸。重いタスクには高めの設定、即応性が要る対話には低めの設定が向きます。ふたつ目はverbosityで、出力の冗長度を司る指標。エンドユーザーに見せる文章の長さに直結する設計判断です。

3つ目はツール記述。エージェント用途では、どんなツールがあって何を担うのかをモデルが正しく理解できる粒度で書き直す必要がある。4つ目が出力フォーマット。JSON、表、自然文、いずれを返すかを代表例で揃えてからプロンプトに反映するのが望ましい、という指針。

これらをひとつずつ代表例ベースで詰め直す作業は、地味ですが効きます。「全部のせ」のプロンプトをそのまま動かしても、reasoning effortやverbosityの新しい既定値とぶつかって意図しない出力に振れる可能性があるからです。

過去資産が負債化する瞬間

新モデルに切り替えるとき、旧プロンプトを捨てるのは精神的なコストが高い作業。試行錯誤の蓄積、動作確認済みのテンプレート、現場のチューニングノウハウ。それらを「いったん全部下ろせ」と言われるのは抵抗があるはず。

ただ、AI活用が伸び悩む組織を観察すると、共通する症状があります。モデルやツールが先行し、データ整備や成功定義が後手になり、結果としてPoCで止まる、という構造。Reddit上の議論でも「失敗の真因はモデルではなく、データやワークフローの問題」という声が複数共有されています。

ここに通底するのは、AIに毎回前提を再説明させる「コンテキスト再構築コスト」を放置している組織が多い、という点。Floatboatのような「永続的なコンテキスト」を売りにするツールが登場しているのも、この問題への対処です。新モデル移行のタイミングは、こうしたコンテキスト設計を含めて棚卸ししないと、せっかくのチューニング機会を逃すことになります。

関連する議論として、AIエージェント運用の落とし穴を整理した記事「AIエージェント失敗の88%はモデルのせいではない｜真因は「コンテキスト設計」にある」も参考になります。

Codexで気づく「進捗を返すプロンプト」の効きどころ

GPT-5.5プロンプティングガイドのなかで、すぐ実装に活かせるテクニックがひとつあります。多段ステップで時間がかかるタスクでは、ツール呼び出しの前にユーザー向けの短い進捗報告を返す、というもの。1〜2文で「リクエストを受け取りました、まず○○から始めます」と伝えるだけで体感が変わる、という指針。

公開ガイドを書いたSimon Willison氏自身が、Codexアプリですでにこの挙動を観察したと述べています。長時間タスクで「モデルがクラッシュしたように見えない」効果が出ている、と。これは見落とされがちな点ですが、エージェント運用ではUXの体感劣化が解約理由のひとつ。沈黙する3分より、進捗を語る3分のほうが信頼を稼げます。

多段ステップで途切れない応答設計

実装としてはシンプルです。プロンプトのシステムメッセージに、「最初のツールコール前に1〜2文で次のステップを宣言せよ」と明示するだけ。重要なのは、進捗メッセージで結論を約束させないこと。「今からこの作業をします」までで止め、最終回答はあくまで処理完了後に返す設計に分けます。

この分離ができていないと、進捗メッセージで先走った結論を言ったあと、最終出力が食い違うリスクが出てきます。プロンプト側で「進捗メッセージは行動宣言のみ、判断や結論は禁止」とガードを入れておくのが安全。

適用してよい場面・避ける場面

進捗メッセージが効くのは、ツール呼び出しが複数発生する場面、あるいは推論時間が長くなりがちなreasoning effortの高い設定。逆に、即答が期待される短文Q&Aや、ストリーミングで自然に出力が流れるユースケースでは、進捗メッセージがノイズになります。すべての応答に同じ仕組みを適用すべきではありません。

このあたりはユースケース別に切り分けが必要。コードレビュー系のエージェントなら冒頭の進捗メッセージは強く効きます。一方で簡単な分類タスクには不要、という判断。

移行で本当に詰まるのはモデルではなくワークフロー

GPT-5.5への移行を「APIモデル名の置き換え作業」と捉えるか、「ワークフロー全体の見直し」と捉えるかで、得られる成果は大きく変わります。エンタープライズでのAIエージェント導入を巡る議論では、「データプラットフォームが整っていないとエージェントは管理不能になる」という指摘が繰り返されています。構造化データ、非構造化データ、エージェント自身が生成するデータが絡み合い、ウェブ状のデータフローになる、という構図。

モデルだけ最新にしても、参照できるデータの粒度・鮮度・整理状況が変わらなければ、出力の質も大きくは変わりません。GPT-5.5への乗り換えで「reasoning effortやverbosityをチューニングする」前に、そもそもどのデータを渡すか、永続的なコンテキストとして何を覚えさせるか、成功の定義は何か、という土台を見直すのが先決という話。

OpenAIが「最小プロンプトから始めよ」と言うのは、皮肉にもこの土台整備の時間を確保するためのアドバイスとも読めます。過去のプロンプト資産を全部持ち込もうとすれば、データやワークフローを見直す余裕は失われる。一度すべて下ろしてから、本当に必要なコンテキストだけ載せ直す——この再構築プロセスが、新モデルの恩恵を引き出す最短ルート。

よくある質問

Q. GPT-5.5への移行で、gpt-5.2やgpt-5.4向けに作った既存プロンプトをそのまま使ってよいですか？

OpenAIの公式ガイドは「ドロップイン置換ではない」と明言しており、旧プロンプトをそのまま流用するアプローチを推奨していません。商品契約を維持できる最小プロンプトから出発し、reasoning effortや出力フォーマットを代表例で再調整するのが推奨ルート。

Q. reasoning effortとverbosityはどう違いますか？

reasoning effortはモデルがどれくらい深く考えてから答えるかを制御する軸で、verbosityは出力テキストの冗長度を制御する軸。前者は処理時間と精度に、後者はユーザーが読む文章量に影響します。両者は独立して設定できます。

Q. Codexの openai-docs migrate this project to gpt-5.5 コマンドは何をしますか？

Codexに組み込まれた openai-docs スキルを通じて、OpenAI公式の移行ガイドの内容を参照しながら、既存プロジェクトのGPT-5.5対応を支援するコマンド。ガイドにはプロンプトの書き換え指針も含まれており、移行作業の出発点として活用できます。

まとめ

GPT-5.5の登場で重要なのは、モデルの性能向上そのものよりも、OpenAIが「過去のプロンプト資産を持ち込むな」と公式に発信した点。新モデルファミリーとして扱い、最小プロンプトから組み直し、進捗を返す応答設計と永続的なコンテキスト整備をセットで進める——この移行プロセスを丁寧にやるかどうかで、6か月後の運用品質に差がつきます。まずは代表的なユースケースを3つほど選び、最小プロンプトでベースラインを引き直すところから着手するのが現実的なスタート。

本記事は AIツール図鑑編集部 が記載時点の情報をもとに執筆。製品アップデートや第三者ベンチマーク・価格・対応ランタイム等の変動で評価が変わる可能性がある。一定期間経過した内容は再検証を推奨する。