GitHub Copilot Agent 模式实战指南与避坑经验

前置环境准备

推荐使用 VSCode Insider 版本，并安装 GitHub Copilot（预览版）插件。模型选择上，目前 Claude 3.7 Sonnet（预览版）在代码生成质量上表现优异，其他模型则在推理速度或多模态能力上有各自优势。务必将工作模式切换为 Agent。

操作流程

进入'Copilot Edits'选项卡后，按以下步骤操作：

1. 添加上下文附件：如'Codebase'、'Get Errors'或'Terminal Last Commands'，让 Agent 了解当前项目状态。
2. 设定工作集：默认包含当前打开文件，也可手动指定'Open Editors'或其他关键文件。
3. 输入指令：在'Instructions'中明确需求，提示 Agent 重点关注的内容。
4. 发送执行：点击 Send 开始交互，观察 Agent 的修改逻辑。

实战建议与配置

VSCode 的语言插件会提供 lint 错误提示，Agent 能自动识别并修正这些问题。不过随着对话深入，生成的代码可能会逐渐偏离预期。建议每次会话聚焦单一主题，达成目标后及时结束，避免上下文过长导致注意力分散。

利用'Working Set'下的'Add Files'功能中的'Related Files'选项，可以智能推荐相关文件。另外，注意控制单文件行数，防止 token 消耗过快。最佳实践是先生成基础代码，再编写测试用例，让 Agent 根据测试结果自我校验和调试。

为了限制修改范围，可以在 settings.json 中添加如下配置，仅允许修改特定目录：

{
  "github.copilot.chat.codeGeneration.instructions": [
    {"text": "只需修改 ./script/ 目录下的文件，不修改其他目录下的文件"},
    {"text": "若目标代码文件行数超过 1000 行，建议将新增函数置于新文件中，通过引用调用；如产生的修改导致文件超长，可暂不严格遵守此规则"}
  ],
  "github.copilot.chat.testGeneration.instructions": [
    {"text": "在现有单元测试文件中生成测试用例"}