Microsoft developer platformの2026年5月5日更新で確認すべきポイントは、AspireのVS Code拡張からaspire newを実行したときの処理順序が修正されたことです。結論から言うと、新しい設定項目や公開APIが追加されたわけではありません。影響を受けるのは、VS Code拡張経由でAspireプロジェクトを新規作成し、AIエージェント環境の初期設定プロンプトを使う開発者やチームです。
以前は、テンプレート作成直後に新しいワークスペースを開くOpenEditorが先に実行され、AI agent environmentsの設定確認が表示されない可能性がありました。修正後は、AIエージェント初期化プロンプトが完了してからエディターを開く流れになります。既存プロジェクトでプロンプトを見逃した可能性がある場合は、aspire agent initを手動で実行して設定を確認するのが安全です。(GitHub)
2026年5月5日の更新で何が変わったのか
今回の変更は、MicrosoftのAspireリポジトリにあるPR「Fix aspire new: move OpenEditor after agent init prompt in VS Code extension」に関するものです。PR自体は2026年3月24日にmainへマージされ、2026年5月5日にはPR Documentation Checkによって「ドキュメントPRは不要」と判断されています。理由は、内部的なCLI処理順序の変更であり、新しいAPI、設定項目、コマンド、ユーザー向け機能を追加するものではないためです。(GitHub)
変更の中心は、VS Code拡張からaspire newを実行したときの次の順序です。
| 観点 | 修正前 | 修正後 | 実務上の意味 |
|---|---|---|---|
| テンプレート作成後の動き | すぐにOpenEditorで新規フォルダーを開く | AI agent initのプロンプト完了後にOpenEditorを実行 | プロンプトが途中で消えるリスクを抑えられる |
| VS Codeワークスペース | 新規プロジェクトを開くことで現在のワークスペースが置き換わる | CLIの対話処理が終わってからワークスペースを切り替える | ターミナル切断による処理中断を避けやすい |
| AIエージェント設定 | 「configure AI agent environments」の確認が表示されない場合がある | 確認プロンプトを完了できる | CopilotなどのAI支援環境を初期設定しやすい |
| ドキュメント・API | 変更なし | 変更なし | 手順書の全面改訂ではなく、設定確認が主な対応 |
重要なのは、この修正が「機能追加」ではなく「正常な対話フローを取り戻すバグ修正」である点です。GitHub上の説明では、OpenEditorが先に走ることで、CLIプロセスを実行していたVS Codeターミナルが失われ、AI agent initプロンプトがユーザーに表示されない状態が説明されています。(GitHub)
影響を受けるユーザーと影響が小さいユーザー
この更新の影響は、すべてのMicrosoft developer platform利用者に広く及ぶものではありません。特に関係があるのは、AspireのVS Code拡張を使って新規プロジェクトを作る開発者です。
| 利用状況 | 対応優先度 | 確認すべきこと |
|---|---|---|
| VS Code拡張の「Aspire: New Aspire project」から新規作成している | 高 | CLIと拡張を更新し、AI agent environmentsのプロンプトが表示されるか確認 |
| 2026年3月下旬以前にVS Code拡張経由でAspireプロジェクトを作成した | 高 | .agents/skills/などのAIエージェント設定が作成されているか確認 |
通常の外部ターミナルでaspire newを実行している | 中〜低 | VS Codeワークスペース切り替えによる中断の影響は限定的 |
| AIエージェント機能を使っていない | 低 | ただし将来使う予定があるならaspire agent initを実行しておく |
CIや社内テンプレート生成でaspire newを自動実行している | 中 | 対話プロンプトに依存しない非対話設定にするか確認 |
AspireのVS Code拡張は、コマンドパレットから新規Aspireプロジェクトを作成でき、AppHostの検出やデバッグ、Aspire CLIへのアクセスを支援する拡張機能です。公式ドキュメントでも、VS Code拡張は「Aspire: New Aspire project」からプロジェクト作成できることが説明されています。(Aspire)
なぜAI agent environmentsのプロンプトが重要なのか
aspire newやaspire initで新しいAspireプロジェクトを作ると、AIエージェント環境を構成するかどうかを尋ねられる場合があります。公式ドキュメントでは、このプロンプトでyを選ぶと、Aspire skill fileやMCP server設定など、AIコーディング支援をより使いやすくするワークスペース設定が行われると説明されています。(Aspire)
この設定は、単なる「おまけ」ではありません。GitHub CopilotやMCP対応ツールを使っているチームでは、AIエージェントがAspire CLI、AppHost、リソース状態、ログ、トレースなどを理解するための土台になります。AspireのAI coding agentsドキュメントでも、aspire agent initによって、AIアシスタントが分散アプリケーションを理解・ビルド・デバッグ・監視しやすくなると説明されています。(Aspire)
具体的には、次のようなファイルや設定が関係します。
| 設定対象 | 役割 | 確認ポイント |
|---|---|---|
.agents/skills/aspire/SKILL.md | VS Code、GitHub Copilot、OpenCodeなど向けの標準的なAspireスキル | Standard locationを選んだ場合に存在するか |
.github/skills/aspire/SKILL.md | GitHub Copilot向けのスキル配置 | チームでGitHub Copilotを使う場合に必要か |
.claude/skills/aspire/SKILL.md | Claude Code向けのスキル配置 | Claude Code利用チームのみ確認 |
.opencode/skill/aspire/SKILL.md | OpenCode向けのスキル配置 | OpenCode利用時のみ確認 |
| MCP server設定 | 実行中のAspireアプリの状態・ログ・トレースなどへAIエージェントがアクセスするための接続 | 利用するAIツール側のMCP設定と整合しているか |
失敗しやすいのは、「プロジェクトは作成できたから問題ない」と判断してしまうケースです。今回の不具合では、テンプレート生成自体は成功していても、AIエージェント初期化の対話だけが完了していない可能性があります。
既存プロジェクトで確認すべき設定
過去にVS Code拡張経由でAspireプロジェクトを作成し、AI agent environmentsのプロンプトを見た記憶がない場合は、次の順序で確認してください。
Aspire CLIとVS Code拡張のバージョンを確認する
まず、利用中のAspire CLIが修正を含むバージョンか確認します。GitHub Releasesでは、Aspire 13.2.1の修正一覧に「VS Codeでのaspire newにおいて、ワークスペース切り替えがCLIターミナルを切断し、agent initプロンプト完了前に中断される競合を修正した」という内容が含まれています。(GitHub)
aspire --versionVS Code拡張は、VS CodeのExtensionsビューで「Aspire」を開き、インストール済みバージョンを確認します。古いバージョンを使っている場合は、拡張機能とAspire CLIの両方を更新してから再確認してください。
AIエージェント設定ファイルがあるか確認する
プロジェクトルートで、次のようなファイルやディレクトリがあるか確認します。
.agents/skills/aspire/SKILL.md
.github/skills/aspire/SKILL.md
.claude/skills/aspire/SKILL.md
.opencode/skill/aspire/SKILL.mdすべてが必要なわけではありません。チームで使うAIツールに合わせて必要な場所だけ選びます。公式のaspire agent initリファレンスでは、skill locationsとしてstandard、claudecode、github、opencodeなどが説明されています。(Aspire)
不足している場合はaspire agent initを実行する
プロンプトが表示されなかった可能性がある場合は、プロジェクトルートで次のコマンドを実行します。
aspire agent init実行後、対話形式でスキルの配置先やインストールするスキルを選びます。公式リファレンスでは、aspire agent initはskill filesとMCP server configurationを初期化するコマンドとして説明されています。(Aspire)
複数人のチームで同じ設定を共有したい場合は、生成されたファイルをそのままコミットしてよいか、リポジトリ方針を確認してください。AIツール固有の設定が混ざるため、全員が使わないツールのディレクトリまで無条件に入れると、リポジトリが読みづらくなることがあります。
移行や設定確認での実務ポイント
今回の修正では、移行作業として大きなコード変更は不要です。ただし、開発フローや社内手順書に「VS Code拡張からAspireプロジェクトを作成する」手順がある場合は、確認観点を追加しておくとトラブルを防げます。
| 確認項目 | 推奨アクション | 理由 |
|---|---|---|
| 社内のAspire導入手順 | aspire new後にAI agent environmentsの選択が完了したか確認する手順を追加 | 生成済みプロジェクトでもAI設定だけ抜ける可能性がある |
| チームのAIツール利用方針 | Copilot、Claude Code、OpenCodeなど、対象ツールを決める | 不要なskill locationを増やさないため |
| 既存リポジトリ | aspire agent initを手動実行し、必要ファイルを確認 | 過去にプロンプトが出なかったプロジェクトを補正できる |
| CI・自動生成スクリプト | 対話プロンプトに依存しない設定にする | 自動処理がプロンプト待ちで止まるのを防ぐ |
| VS Code拡張の更新管理 | 開発者ごとに拡張とCLIの更新状況を確認 | CLIだけ更新しても拡張側が古いと再現確認が難しい |
自動化された環境では、対話型のaspire agent initをそのまま使うより、オプション指定を検討します。公式リファレンスには、すべての対応スキルと配置先を選ぶ例として次のコマンドが掲載されています。(Aspire)
aspire agent init --skills all --skill-locations allただし、実務では「all」が常に最適とは限りません。たとえばGitHub Copilotだけを使うチームなら、必要なskill locationを絞った方が管理しやすくなります。全社標準を決める前に、どのAIエージェントを正式利用するかを確認してから設定してください。
今回の更新で「対応不要」と判断してよいケース
次の条件に当てはまる場合、緊急対応の優先度は高くありません。
- AspireプロジェクトをVS Code拡張から新規作成していない
- AIエージェント機能を使っていない
aspire agent initをすでに手動実行済み- 生成済みリポジトリに必要なskill fileとMCP設定が存在する
- チーム内でAspire CLIとVS Code拡張の更新が完了している
一方で、AIエージェントを今後使う予定があるなら、早めに確認しておく価値があります。今回の問題は、アプリケーションのビルドエラーや実行時障害としては見えにくく、「AIがAspireプロジェクトをうまく理解できない」という形で後から気づく可能性があるためです。
テスト時に見落としやすいポイント
修正確認では、単にaspire newでプロジェクトが作れるかだけを見ると不十分です。今回の問題は、テンプレート生成後のワークスペース切り替えと、AIエージェント初期化プロンプトの順序に関係しています。
確認するなら、次の流れが実用的です。
| 手順 | 確認内容 | 正常な状態 |
|---|---|---|
| VS Codeでコマンドパレットを開く | Aspire: New Aspire projectを実行 | テンプレート選択ができる |
| 新規プロジェクトを作成する | 作成後のターミナル表示を見る | AI agent environmentsの確認が表示される |
| プロンプトに回答する | yまたは必要な選択を行う | 対話が最後まで完了する |
| ワークスペースが開く | 新しいプロジェクトフォルダーがVS Codeで開く | プロンプト完了後に切り替わる |
| ファイルを確認する | skill fileや設定が生成されているか見る | 選択した場所に設定ファイルがある |
特に、社内で「新人向けAspireセットアップ手順」や「ハンズオン資料」を作っている場合は、この確認表をそのままチェックリストとして使えます。
ドキュメント更新としての読み方
今回の「Microsoft developer platform documentation update」は、ドキュメント本文に新しい手順が追加されたというより、PR Documentation Checkの観点では「ドキュメント変更不要」とされた更新です。つまり、読者が注目すべきなのは新しいドキュメントページではなく、実際の開発体験でAI agent initプロンプトが正しく完了するかです。(GitHub)
Aspire 13.3のマイルストーンチェンジログにも、この変更はExtensions bug fixesとして記載されており、「VS Code extension now opens the editor after the agent init prompt completes」と整理されています。(GitHub)
ドキュメントが大きく変わっていないからといって、影響がないとは限りません。VS Code拡張を使った新規作成フローは、初心者やチーム導入時に使われやすい入口です。そこでAIエージェント設定が抜けると、後続のCopilot活用、MCP連携、Aspire CLI参照の体験に差が出ます。
次に取るべき行動
まず、VS Code拡張経由でAspireプロジェクトを作成しているかを確認してください。該当する場合は、Aspire CLIとVS Code拡張を更新し、既存プロジェクトでaspire agent initが済んでいるか確認します。
最小限の対応は次の3つです。
aspire --versionでAspire CLIのバージョンを確認する- VS CodeのExtensionsビューでAspire拡張を更新する
- 既存プロジェクトのルートで
aspire agent initを実行し、必要なAIエージェント設定を作成する
今回の修正は大きな移行作業を求めるものではありません。しかし、AIエージェントを前提にAspireを使うチームにとっては、初期設定の抜けを防ぐ重要な変更です。新規プロジェクト作成後に「AI agent environmentsの設定が完了しているか」を確認するだけで、後から原因の分かりにくいAI支援の不調を避けやすくなります。
コメント