透過使用 Visual Studio 中的 GitHub Copilot 計畫代理程式，你可以在修改程式碼前建立並迭代實施計畫。 計畫代理會使用唯讀工具探索你的程式碼庫，必要時提出澄清問題，並草擬一份計畫，讓你能透過 Copilot 檢視和精煉。
與代理模式不同，規劃代理不會在規劃時編輯檔案或執行執行步驟。 當你對計畫感到滿意時，可以交給代理人模式執行。
先決條件
- 安裝最新版本的 Visual Studio。
- 使用具有 Copilot 存取權的 GitHub 帳戶登入 Visual Studio。
何時使用保險代理人
當你想在開始實施前達成共識時，計畫代理人非常有用。
- 重點功能：將複雜工作拆解成清晰且可審查的步驟，然後再開始程式碼修改。
- 不熟悉的程式碼庫：讓Copilot先檢視解決方案並說明可能的接觸點，再開始編輯。
- 團隊協作：在交給實施前，先分享已儲存的 Markdown 計畫供審閱。
開始方案
打開 Copilot Chat 視窗。
在代理人選擇器中，選擇 「計畫」。
輸入一個提示，描述你想建造、重構或調查的內容。
Copilot 會用唯讀工具探索你的程式碼庫。 如果任務不明確，會在擬定計畫前先提出澄清問題。
檢視並精煉計畫
收集足夠背景後，Copilot 會建立實施計畫，大家可以在聊天中一起檢視。
在你檢視草稿時，可以請 Copilot ：
- 把大步驟拆分成較小的任務。
- 加入邊緣案例或驗證步驟。
- 重新考慮要更換哪些檔案或元件。
- 修訂執行順序。
你也可以在方案檢視中選取 編輯 Markdown 來直接編輯方案，或在儲存庫中手動編輯已儲存的方案檔案。
對於直接的請求，Copilot 可能會立即擬定計畫，且不會追問後續問題。
使用已儲存的方案
預設情況下，Copilot 會將每個計畫儲存為 .copilot/plans/plan-{title}.md 的 markdown 檔案。 你可以在 Tools>Options>GitHub>Copilot>Copilot Chat 的 Plan 輸出目錄 下變更儲存位置。
這個計畫檔案是任務的真實來源。 您可以：
- 直接在編輯器中編輯 markdown 檔案。
- 透過聊天持續完善計畫。
- 在實施前，請與隊友分享計畫。
當你手動編輯計畫檔案時，Copilot 會偵測到變更，並保持聊天狀態與更新方案同步。
以代理模式實作計畫
當你準備好從規劃進入執行階段時，選擇 「實施計畫」。
Copilot 將計畫交給特工模式，特工執行步驟並開始修改程式碼。 在你明確選擇執行該計畫之前，不會有任何實作變更。
計畫代理人與代理人模式下的規劃
Plan Agent 和 Planning in Agent 模式是相關的，但不是同一個功能。
| 特徵 / 功能 | 最適合在下列情況下使用 | 行為 |
|---|---|---|
| 計畫代理人 | 你要在實施開始前就達成共識。 | 以獨立的聊天模式執行，使用唯讀工具進行探索，將計畫檔案儲存在 .copilot/plans/ 中，並透過 實作計畫 交接。 |
| 代理模式下的規劃 | 你已經在執行代理模式，而代理模式會自動利用會話中結構化規劃來處理複雜任務。 | 在代理模式下運行，並在該會話中追蹤執行規劃狀態。 |
關於在代理人模式下規劃的詳細資訊，請參見 代理人模式規劃。