GitHub Copilot Agent 模式实战指南与避坑建议

前置设置
要发挥 Agent 模式的潜力,环境配置是第一步:
- 编辑器:建议使用 VSCode Insider 版本。
- 插件:安装 GitHub Copilot(预览版)。
- 模型选择:推荐 Claude 3.7 Sonnet(预览版),该模型在代码编写上表现优异,同时兼顾推理能力。当然,其他模型在速度或多模态识别上也有各自优势,可根据需求切换。
- 工作模式:务必在设置中开启 Agent 模式。
操作流程
进入 "Copilot Edits" 选项卡后,按以下逻辑构建上下文:
- 添加附件:根据场景勾选 "Codebase"、"Get Errors" 或 "Terminal Last Commands",让 Agent 获取项目状态。
- 工作集 (Working Set):默认包含当前打开文件,也可手动指定 "Open Editors" 或其他关键文件。
- 指令 (Instructions):输入明确的提示词,告诉 Agent 需要特别注意的规则。
- 发送:点击 "Send" 开始交互,观察其响应质量。
核心技巧
在实际使用中,有几个关键点能显著提升效率:
- 利用 Lint 反馈:VSCode 的语言插件会生成 Error 或 Warning,Agent 能自动读取这些提示并修正代码,无需手动粘贴报错信息。
- 控制会话主题:随着对话深入,修改范围容易发散。建议每次会话聚焦一个明确目标,达成后结束当前会话再启动新任务。
- 智能文件关联:"Add Files" 中的 "Related Files" 选项可辅助推荐相关文件,减少遗漏。
- Token 管理:注意控制单文件行数,避免 Token 消耗过快。大文件不仅消耗快,还容易导致注意力分散。
- 测试驱动开发:建议先生成基础代码,再编写测试用例。Agent 能根据测试结果进行自我校验和调试,比单纯依赖人工 Review 更高效。
配置约束示例
为限制修改范围,可在 settings.json 中添加如下配置,仅允许修改特定目录:
{
"github.copilot.chat.codeGeneration.instructions": [
{
"text": "只需修改 ./script/ 目录下的文件,不修改其他目录下的文件。"
},
{
"text":


