Appearance
Copilot CLI 支持多层次的 Agent 使用模式:从普通对话交互,到 Plan 模式协作规划,到 Autopilot 本地自动执行,再到 /delegate 推送到 Cloud Agent 在云端执行。根据任务复杂度和控制需求选择合适的模式。
GitHub Copilot CLI Agent 使用总览:从基础到高级代理模式
五种工作模式对比
| 模式 | 适用场景 | 控制程度 | 执行位置 |
|---|---|---|---|
| 普通对话 | 问问题、查信息、小改动 | 高 | 本地,逐步确认 |
| Plan 模式 | 规划复杂功能 | 高 | 本地,方案先确认 |
| Autopilot | 自动完成多步任务 | 低 | 本地,自动执行 |
| /fleet | 并行多子任务 | 低 | 本地,多代理并行 |
| /delegate | 后台异步任务 | 低 | 云端,生成 PR |
普通对话模式(默认)
启动 Copilot CLI 后直接输入任务描述:
帮我修复 src/auth.ts 中的类型错误Copilot 会在执行每个操作前请求确认(读文件、写文件、执行命令)。适合日常开发中需要逐步确认的场景。
Plan 模式(规划协作)
Shift+Tab # 切换到 Plan 模式在 Plan 模式中,Copilot 不会直接执行操作,而是和你协作制定实施方案。方案确认后再切换回执行模式。
典型流程:
- 按
Shift+Tab进入 Plan 模式 - 描述目标功能
- 与 Copilot 讨论实现方案,调整细节
- 方案确认后退出 Plan 模式,或直接
/fleet implement the plan并行执行
Autopilot 模式(全自动本地执行)
Shift+Tab # 多按几次直到出现 "autopilot"Autopilot 模式下,Copilot 拥有完整权限,不再每步询问确认,自动完成整个任务。
编程方式触发:
bash
copilot --autopilot --yolo --max-autopilot-continues 10 -p "完成 API 集成测试"参数说明:
--autopilot:启用 Autopilot 模式--yolo:预授权所有工具(相当于 --allow-all)--max-autopilot-continues:最多自动继续的轮次-p:直接传入任务提示词
/delegate 模式(委托到 Cloud Agent)
/delegate 完成 API 集成测试并修复所有边缘 case或使用 & 前缀简写:
& 完成 API 集成测试并修复所有边缘 case与 Autopilot 不同:/delegate 把任务推送给 GitHub 的云端 Cloud Agent,Copilot 会在新分支上工作并创建 PR。你可以关掉终端,稍后在 GitHub 上查看进度。
/fleet 模式(并行多代理)
/fleet 为所有 API 接口补充单元测试和文档注释适合可以拆分为多个独立子任务的大型任务,Copilot 自动拆分并并行执行。
添加文件上下文
所有模式中都可以引用具体文件:
@src/auth.ts 帮我优化这个模块的错误处理/cwd /path/to/project # 切换工作目录常见问题
Q: 什么时候该用 /delegate,什么时候用 Autopilot?
A: 任务需要在你的本机环境(本地数据库、本地服务)执行,用 Autopilot;任务可以在独立环境中完成并通过 PR 交付,用 /delegate,这样你的机器可以做别的事。
Q: Autopilot 出错了怎么停止?
A: 按 Esc 中止当前执行。然后用 /undo 回滚到出错前的状态。
Q: /delegate 和 GitHub.com 的 Cloud Agent 有什么关系?
A: /delegate 就是通过 CLI 触发 Cloud Agent。Cloud Agent 在 GitHub 服务器侧运行,创建 PR,你可以在 GitHub Web 或 CLI 的 /tasks 中监控进度。