GitHub Copilot プランエージェントを使用する

Visual Studioで GitHub Copilot プラン エージェントを使用すると、コードを変更する前に実装計画を作成して反復処理できます。 プラン エージェントは、読み取り専用ツールを使用してコードベースを調査し、必要に応じて明確な質問を行い、Copilotを使用してレビューおよび調整できるプランを下書きします。

エージェント モードとは異なり、プラン エージェントでは、計画中にファイルを編集したり、実装手順を実行したりすることはありません。 プランに満足したら、エージェント モードに渡して実行できます。

前提条件

プラン エージェントを使用するタイミング

プラン エージェントは、実装を開始する前にアプローチに合わせる場合に便利です。

  • 大きな機能: コードの変更が開始される前に、複雑な作業を明確でレビュー可能な手順に分割します。
  • 不慣れなコードベース: Copilot にソリューションを調査させ、編集を行う前に影響箇所として考えられる部分を説明させます。
  • チームコラボレーション: 保存されたマークダウン計画をレビュー用に共有してから、実装のために引き渡します。

プランを開始する

  1. Copilot Chat ウィンドウを開きます。

  2. エージェント ピッカーで、[ プラン] を選択します。

    モード ドロップダウンでプランが選択されているCopilot Chatのスクリーンショット。

  3. ビルド、リファクタリング、または調査する内容を説明するプロンプトを入力します。

  4. Copilot読み取り専用ツールを使用してコードベースを調べる。 タスクがあいまいな場合は、計画の草案を作成する前に、明確な質問を行います。

計画を見直して改善する

十分なコンテキストを収集すると、Copilot はチャットで一緒に確認できる実装計画を作成します。

プラン エージェントによって作成された実装計画が表示された Copilot Chat のスクリーンショット。

下書きを確認するときに、Copilotに次の質問を行うことができます。

  • 大きなステップを小さなタスクに分割します。
  • エッジ ケースまたは検証手順を追加します。
  • 変更するファイルまたはコンポーネントを再検討します。
  • 実装の順序を変更します。

プラン ビューで [マークダウンの編集] を選択するか、リポジトリに保存されているプラン ファイルを手動で編集して、プランを直接編集することもできます。

簡単な要求の場合、Copilotはフォローアップの質問をすることなく、すぐに計画を下書きする可能性があります。

保存されたプランを操作する

既定では、Copilotは各プランをマークダウン ファイルとして .copilot/plans/plan-{title}.md に保存します。 保存場所は、Tools>Options>GitHub>Copilot>Copilot ChatPlan output directory で変更できます。

この計画ファイルは、タスクの信頼のソースです。 次のようにすることができます。

  • エディターでマークダウン ファイルを直接編集します。
  • チャットを使用してプランを調整し続けます。
  • 実装を開始する前に、計画をチームメイトと共有します。

プラン ファイルを手動で編集すると、Copilotによって変更が検出され、チャットの状態が更新されたプランと同期されます。

エージェント モードでプランを実装する

計画から実行に移行する準備ができたら、[ プランの実装] を選択します。

保存されたプランを実装するエージェント モードを示すCopilot Chatのスクリーンショット

Copilotプランをエージェント モードに切り替えます。このモードは、手順を実行してコードの変更を開始します。 計画の実装を明示的に選択するまで、実装の変更は行われません。

プラン エージェントとエージェント モードでのプランニング

エージェント モードでのプラン エージェントと計画は関連していますが、同じ機能ではありません。

特徴 最もよく使用される場合 Behavior
計画エージェント 実装を開始する前に、アプローチに合わせて調整する必要があります。 独立したチャットモードとして実行され、読み取り専用ツールを使用して調査し、プランファイルを .copilot/plans/ に保存し、Implement plan を使用して引き継ぎます。
エージェント モードでの計画 すでにエージェント モードで動作しており、複雑なタスクに対してはセッション内での構造化された計画が自動的に活用されます。 エージェント モード内で実行され、そのセッション中に実行計画の状態を追跡します。

エージェント モード内での計画の詳細については、エージェント モード での計画を参照してください。