［開発者向け］GPT-6 Astra時代のスキル・AGENTS.md見直し方——OpenAIが提案する4つの視点

2026-09-12

はじめに

　OpenAIは2026年9月11日、コーディングエージェント向けの指示ファイルであるスキルやAGENTS.md、タスクプロンプトの見直し方を解説する記事を公開しました。新モデル「GPT-6 Astra」の登場に伴い、従来の指示がどう変わるべきかをまとめた内容です。本稿では、この発表内容をもとに見直しのポイントを紹介します。

参考記事

タイトル: Rethinking skills and prompts for GPT-6 Astra
著者: Eric Provencher
発行元: OpenAI（Developers Blog）
発行日: 2026年9月11日
URL: https://developers.openai.com/blog/rethinking-skills-and-prompts-for-gpt-6-astra

要点

OpenAIは2026年9月11日、コーディングエージェント向け指示の見直し方を解説する記事を公開した。
スキルの説明文は簡潔にし、いつ使うべきかを明確に記述することを推奨している。
AGENTS.mdについては、編集のたびに複数ドキュメントの参照を求めるといった過剰な指示を見直すべきとしている。
GPT-6 Astraは判断力が高いため、従来モデル向けに設定した強い制約表現の見直しを促している。
タスクの完了基準を事前に定義し、途中で止まらないよう明示することを推奨している。

詳細解説

スキル記述を簡潔にし、段階的に開示する

　OpenAIによれば、スキルはワークフローやツールの使い方を示すMarkdown形式の指示であり、名前と説明文がモデルのコンテキストに読み込まれることで、どのスキルを使うべきか判断する材料になります。スキルの数が増えると説明文が長くなりがちで、Codexが自動的に説明文を短縮してしまい、モデルが適切なスキルを選びにくくなると指摘しています。対策として、説明文は「いつ使うか」を明確にしつつできるだけ短くすること、複数のワークフローを持つスキルは詳細を別ファイルに分離し、本体は最小限の道しるべにとどめる「段階的開示」の設計を推奨しています。

　本稿としては、スキルの数が増えるほど説明文同士が競合しやすくなる点は、開発現場でも起こりやすい課題だと考えています。スキルが増え続ける背景をIBMの事例から整理した過去記事も参考になります。複数人でスキルを追加していくプロジェクトでは、定期的な棚卸しが有効だと考えられます。

AGENTS.mdを棚卸しし、過剰な指示を削る

　OpenAIは、AGENTS.mdに書かれた指示は編集のたびに参照されるため、定期的な見直しが必要だとしています。たとえば「編集前に必ずarchitecture.md・database.md・deployment.mdを読む」といった一律の指示は、typo修正のような小さな変更にも過剰な負荷をかけると説明しています。代わりに、各ドキュメントを「どの作業の時に参照するか」を条件付きで示す書き方を推奨しています。また、旧モデルではテスト実行を促す指示が必要だった一方、GPT-6 Astraは自発的にテストを実行するため、同じ指示が不要な作業を増やす可能性があるとも述べています。

　この変化は、モデルの自律性が上がるほど、指示側は「一律の禁止・強制」より「条件付きの案内」に寄せる設計が有効になることを示していると考えられます。

権限・制約の表現を見直す

　OpenAIの発表では、過去のモデルが許可なく作業を進めてしまった経験から、強い制約表現をAGENTS.mdに書き込んだ開発者が多いと指摘しています。GPT-6 Astraはこれまでで最も判断力の高いモデルと位置付けられており、安全だと判断できない作業は自ら実行しないため、従来ほど厳格な言語は必要ないとしています。OpenAIは、モデルを切り替える際にはこうした制約表現も見直すよう促しています。

　制約が強すぎると、本来は続けてよい作業でもモデルが手を止めてしまう可能性があり、モデルの特性に合わせて表現を調整することが有効だと考えられます。

タスクの完了基準を事前に定義する

　OpenAIによれば、GPT-6 Astraは旧モデルより慎重に振る舞う傾向があり、実装の第一段階が終わった時点でレビューを求めて作業を止めることがあるとしています。対策として、作業を依頼する時点で「完了」の基準を明示し、実装・動作確認・修正までを含めて依頼することを推奨しています。レビューのために一度立ち止まることを求める指示があると、モデルはより早い段階で作業を止めやすくなるため、その指示が本当に必要かを確認するようにも述べています。

　タスク完了の基準をあらかじめ言語化しておく発想は、人にタスクを依頼する際の「完了の定義」と近く、エージェントへの指示設計でも同様の考え方が有効だと考えられます。