VS Code Planning Mode: コーディング前に考える
GitHub Copilotを使用しているほとんどの開発者は、次のような経験をしたことがあるでしょう。機能を説明すると、AIがすぐにコードの生成を始め、3つのファイルを生成した後で、間違った問題を解決していることに気づきます。作業を止めて、元に戻し、最初からやり直す——自信に満ちているが方向性の誤った出力に20分を費やしてしまったのです。
解決策は、より良いプロンプトではありません。コーディング前の計画です。
VS Code Planning Modeは、まさにこのために構築されました。これはVS Code内に組み込まれた専用のAI計画ワークフローで、思考と実行を分離します——GitHub Copilotがコードベースを分析し、明確化のための質問をし、1行のコードも変更する前に構造化された実装計画を作成できるようにします。
重要なポイント
- VS Code Planning Modeは、GitHub Copilotがコードベースを分析し、コードを書く前に構造化された計画を作成することで、思考と実行を分離します。
- Planエージェントはファイルを読み取り、コードパスを追跡し、明確化のための質問をします——欠陥のある仮定が欠陥のある実装になる前にそれを捉えます。
- 複数ステップまたは横断的なタスクには計画を使用してください。変数名の変更やタイプミスの修正のような、シンプルで一文で説明できる変更にはスキップしてください。
- 特定のファイルの参照、テストケースの含有、カスタム指示の使用は、すべて計画の品質を大幅に向上させます。
VS Code Planning Modeが実際に行うこと
Planning ModeはVS Codeの広範なエージェントベース開発モデルの一部であり、異なるエージェントが異なる仕事を処理します。Planエージェントは、分析と構造化されたタスクの分解に専念します。コードベースを読み取り、特定のファイルやシンボルを参照し、複数ステップの作業を整理できます——何も触れることなく。
これはブレインストーミングツールではありません。実装前の構造化されたワークフローであり、実装エージェントに引き渡す前にレビューして承認する具体的な計画を作成します。
VS Code Copilotエージェントシステムの最近の改善により、計画がより強力になりました。エージェントは、ターンをまたいで計画コンテキストを維持し、コードベースをより深く探索し、同じセッション内で計画から実装へのシームレスな引き渡しをサポートできます。
実践におけるVS Code AI計画ワークフロー
GitHub Copilot Planning Modeのワークフローは、明確な順序に従います。
1. 高レベルのリクエストを提供する 構築したいものを説明します。制約——使用しているフレームワーク、パターン、触れてはいけないファイル——について具体的に記述してください。
2. AIに探索と質問をさせる Planエージェントは関連ファイルを読み取り、コードパスを追跡し、アプローチを決定する前に明確化のための質問を提示します。これは、仮定が早期に捉えられる場所です。
3. 生成された計画をレビューする 構造化されたステップバイステップの実装計画を受け取ります——どのファイルが変更されるか、どの順序で、なぜか。レビューしてください。編集してください。AIが見逃した制約を追加してください。
4. 実装エージェントに引き渡す 計画が承認されたら、エージェントモードに切り替えて、Copilotに実行させます。アプローチがすでに合意されているため、実行はより速く、より予測可能になります。
Discover how at OpenReplay.com.
Planエージェントを使用するタイミング(およびスキップするタイミング)
すべてのタスクに計画が必要なわけではありません。有用なルール:**正確な変更を1文で説明できる場合は、計画をスキップしてください。**できない場合は、最初に計画してください。
| タスク | 計画を使用? |
|---|---|
| タイプミスの修正または変数名の変更 | いいえ |
| 新しいAPIエンドポイントの追加 | はい |
| 認証の実装 | はい |
| 複数ファイルにわたるリファクタリング | はい |
| 依存関係の更新 | いいえ |
大規模なコードベースの場合、Planエージェントは特に価値があります。VS Codeは、ワークスペース内のファイルやモジュール全体でコンテキストを収集できるため、手動での慎重な調整が必要となる横断的な変更に適しています。
計画ワークフローからより多くを得る
計画の品質を向上させるいくつかのプラクティス:
- プロンプトで特定のファイルを参照する
#<file>または#<symbol>を使用して、AIを関連するコンテキストに導く - 期待される出力やテストケースを含める 計画が仮定ではなく実際の基準に対して検証できるようにする
- カスタム指示を使用する コードだけからは推測できないアーキテクチャと規約についてAIに伝える
- 無関係なタスクには新しいセッションを開始する コンテキストの汚染は時間とともに計画の品質を低下させます
Copilotの動作と指示の設定について詳しくは、公式のVS Code Copilotカスタマイズドキュメントをご覧ください。
結論
AI支援コーディングから最大の成果を得る開発者は、最高のプロンプトを持つ人ではありません。AIをすぐに実行させたい衝動に抵抗する人です。
VS Code Planning Modeは、その規律を実用的にします。意図と実行の間に構造化されたチェックポイントを提供します——アプローチのコントロールを維持し、AIが実装を処理します。
まず考える。それから構築する。
よくある質問
Planning ModeはVS CodeのCopilot Chat体験の一部であり、GitHub Copilotへのアクセスが必要です。利用可能性は、Copilotプランと環境で有効になっている機能によって異なります。
はい。生成された計画は完全に編集可能です。ステップを並べ替えたり、不要な変更を削除したり、AIが見逃した制約を追加したり、実装に引き渡す前にPlanエージェントに特定のセクションを修正するよう依頼したりできます。計画のレビューと調整は、ワークフローの中核部分です。
Planning ModeはGitHub Copilotがサポートする任意の言語で機能し、ほとんどの主流言語をカバーしています。その効果は、Planエージェントがファイルとプロジェクト構造からどれだけ関連するコンテキストを収集できるかに依存します。
Copilot Chatは会話的に応答し、すぐにコードの生成を開始する場合があります。Planning Modeは、分析に焦点を当て、明確化のための質問をし、構造化されたステップバイステップの実装計画を作成する専用のPlanエージェントを使用します。思考フェーズとコーディングフェーズを分離し、方向性の誤った出力を減らします。
Understand every bug
Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.
