使用 GitHub Copilot 规划代理

通过在Visual Studio中使用GitHub Copilot计划代理,可以在进行代码更改之前创建并循环访问实现计划。 计划代理使用只读工具浏览代码库,在需要时提出澄清问题,并起草一个计划,可以使用Copilot查看和优化。

与代理模式不同,计划代理不会在计划时编辑文件或运行实现步骤。 对计划感到满意后,可以将其移交给代理模式以执行该计划。

先决条件

何时使用规划代理

当你希望在开始实施之前先就方案达成一致时,计划代理会非常有用。

  • 大功能:在代码更改开始之前,将复杂的工作分解为清晰、可查看的步骤。
  • 不熟悉的代码库:先让 Copilot 检查解决方案,并在它进行任何编辑之前说明可能需要修改的地方。
  • 团队协作:共享保存的 Markdown 计划以供审阅,然后再将其移交以供实现。

启动计划

  1. 打开Copilot 对话助手窗口。

  2. 在代理选取器中,选择“ 计划”。

    模式下拉列表中已选择“计划”的 Copilot 对话助手 屏幕截图。

  3. 输入一段提示,描述你想要构建、重构或排查的内容。

  4. Copilot使用只读工具浏览代码库。 如果任务不明确,它会在起草计划之前提出澄清问题。

查看和优化计划

收集足够的上下文后,Copilot创建一个可在聊天中一起查看的实现计划。

Copilot 对话助手 的屏幕截图,显示了由计划代理创建的实施计划。

在查看草稿时,你可以让 Copilot:

  • 将大型步骤拆分为较小的任务。
  • 添加边缘事例或验证步骤。
  • 重新考虑要更改的文件或组件。
  • 修改实现顺序。

还可以通过在计划视图中选择 “编辑 markdown ”或手动编辑存储库中保存的计划文件,直接编辑计划。

对于简单的请求,Copilot可以立即起草计划,而无需提出后续问题。

使用已保存的计划

默认情况下,Copilot将每个计划另存为 markdown 文件,该文件位于 .copilot/plans/plan-{title}.md。 可以在Tools>Options>GitHub>Copilot>Copilot 对话助手中的计划输出目录下更改保存位置。

此计划文件是任务的真相来源。 您可以:

  • 直接在编辑器中编辑 markdown 文件。
  • 继续通过聊天优化计划。
  • 在实施开始之前与团队成员共享计划。

手动编辑计划文件时,Copilot检测更改并将聊天状态与更新的计划保持同步。

使用代理模式实现计划

准备好从计划移动到执行时,请选择 “实现计划”。

显示 Copilot 对话助手 中代理模式正在执行已保存计划的屏幕截图。

Copilot将计划移交给代理模式,该模式可完成这些步骤并开始进行代码更改。 在你明确选择实施该计划之前,不会发生任何实施方面的更改。

Plan 代理与代理模式下的规划

计划代理代理模式中的规划有关联,但它们并不是同一项功能。

功能 / 特点 最佳使用时间 行为
规划代理 在实现开始之前,你想要在方法上保持一致。 作为一种独立的聊天模式运行,使用只读工具进行探索,将计划文件保存在 .copilot/plans/ 中,并通过 实施计划 进行移交。
在代理模式下规划 你已处于代理模式,代理模式会针对复杂任务自动利用当前会话中的结构化规划。 在该会话期间,在代理模式下运行并跟踪执行计划状态。

有关在代理模式下规划的详细信息,请参阅 在代理模式下规划