03 · Copilot 的入口地图

第一次学 Copilot 最容易乱，是因为入口太多。你以为自己在学一个插件，实际会碰到 GitHub 网站、VS Code、JetBrains、Windows Terminal、GitHub CLI、Mobile、Cloud Agent、企业后台和 SDK。先画入口地图，后面每个功能才有位置。

1. 入口决定上下文

flowchart TD
  Task["开发任务"] --> Where{"任务发生在哪里"}
  Where -->|仓库 / PR / Issue| GitHub["GitHub.com"]
  Where -->|本地代码编辑| IDE["VS Code / IDE Chat"]
  Where -->|命令行问题| Terminal["Windows Terminal / Copilot CLI"]
  Where -->|异步分支任务| Cloud["Cloud Agent"]
  Where -->|移动端跟进| Mobile["GitHub Mobile"]
  GitHub --> GHContext["PR / Issue / Files / Alerts"]
  IDE --> IDEContext["Workspace / Selection / Diff / Terminal"]
  Terminal --> ShellContext["Shell command / Git / Local repo"]
  Cloud --> PRContext["Branch / Commits / Checks / PR"]
  Mobile --> LightContext["Chat / Notifications / Lightweight review"]

入口不是 UI 偏好，而是上下文边界。GitHub.com 看得到 GitHub 对象；IDE 看得到本地文件和编辑状态；Terminal 看得到命令；Cloud Agent 看得到远端仓库和分支。

2. GitHub.com：围绕协作对象提问

GitHub.com 入口适合围绕这些对象工作：

• repository。
• file。
• issue。
• pull request。
• discussion。
• commit。
• security alert。
• organization dashboard。

适合问题：

• “这个 PR 改了什么？”
• “这个 issue 的核心需求是什么？”
• “这个 security alert 影响哪些文件？”
• “这段仓库代码的入口在哪里？”

验收方式：

• 回到 PR diff。
• 看 checks。
• 看 review comments。
• 看 issue 里的讨论和 acceptance criteria。
• 看 security alert 状态。

不适合：询问本地未提交 diff、只存在你电脑里的日志、未上传的截图、终端当前状态。

3. VS Code / IDE：围绕本地代码改动

VS Code 官方文档当前把 Copilot 描述成能完成“规划 → 实现 → 验证”（plan / implement / verify）的跨文件改动闭环。IDE 入口适合本地真实编码闭环。

适合任务：

• 解释当前文件。
• 生成或修改函数。
• 用 inline suggestions 做局部补全。
• 用 inline chat 做小范围编辑。
• 用 Agent mode 处理跨文件低到中风险任务。
• review code edits。
• 结合 terminal 跑验证。

IDE 入口的优势是本地上下文丰富：当前文件、选区、workspace、diff、terminal、MCP、custom instructions 都能参与。

风险边界：

• Agent mode 可能改多个文件。
• terminal command 需要人工批准。
• MCP 可能接触外部系统。
• 生成结果必须回到 diff 和测试验收。

4. Windows Terminal：解释命令，不替你冒险

Windows Terminal Canary 中的 Copilot 适合解释和建议命令。

适合：

• “这个命令是什么意思？”
• “如何列出占用某端口的进程？”
• “这个 Git 报错怎么处理？”
• “这段 shell 输出表示什么？”

不适合：

• 生产环境直接执行不懂的命令。
• 删除、部署、迁移、上传、密钥处理。
• 把 Copilot 建议当成无需审查的 shell 自动化。

终端入口的验收是 command output 和 exit code。执行前先判断副作用。

5. Copilot CLI：终端里的 Agent 任务

Copilot CLI 是更 agentic（代理式）的终端入口。官方功能页说明它可以在终端里委派任务——给项目加功能、修 bug，然后帮你创建 pull request；任务也可以从终端开始，再在 GitHub.com 或 GitHub Mobile 上接着同一个会话（session）往下做。

适合：

• 在本地 repo 里修一个明确 bug。
• 给小功能开分支和 PR。
• 在 terminal 中继续一个任务。
• 结合 hooks 和权限做受控执行。

上线边界：

• 运行前看 Git status。
• 明确允许改哪些路径。
• 高风险命令必须人工确认。
• 创建 PR 后仍走 review 和 CI。

6. Cloud Agent：异步分支和 PR 工作流

官方功能页把 Copilot cloud agent 描述为：研究仓库 → 制定实现计划 → 在分支里改代码。你可以 review diff、迭代修改，最后再创建 pull request。

适合：

• 明确 issue 的异步实现。
• 中等规模 refactor。
• 补测试或文档。
• 在分支里交付可 review 结果。

不适合：

• 本机未提交现场。
• 依赖本地登录态。
• 生产后台或私有桌面应用。
• 不能写清验收标准的模糊任务。

Cloud Agent 的验收不是自然语言总结，而是 branch、commits、diff、checks、PR review 和必要的产出物（artifacts，例如构建包 / 测试报告）。

7. GitHub Mobile：延续上下文，不做复杂合并

Mobile 适合轻量查看和延续对话：

• 跟进 issue。
• 看通知。
• 问简单上下文。
• 继续 Cloud Agent session。
• 粗看 PR 状态。

不适合：

• 审大 diff。
• 处理复杂 merge conflict。
• 批准高风险代码变更。
• 检查完整测试输出。

移动端是协作补充，不是主要 code review 工具。

8. 入口选择表

9. 团队上线时怎么写规则

团队 SOP 不应该只写“使用 Copilot”。应该写：

1. 哪些入口允许使用。
2. 哪些入口只能只读。
3. 哪些入口可以改代码。
4. 哪些入口可以运行命令。
5. 哪些入口可以调用 MCP。
6. 哪些任务必须回到 PR review。
7. 哪些高风险路径禁用 Agent 或 Cloud Agent。

这样开发者才知道什么时候用哪个入口，而不是把所有问题都丢进同一个 Chat 面板。

官方来源

• What is GitHub Copilot?：官方列出 IDE、Mobile、Windows Terminal、GitHub CLI 和 GitHub website 等入口。
• GitHub Copilot features：官方说明 Copilot CLI、Cloud Agent、IDE Agent mode、Chat 和管理员功能。
• GitHub Copilot Chat：官方 Chat 跨环境入口。
• GitHub Copilot in VS Code：VS Code 官方 agent、edit、review 和 project verification 入口。

接下来去哪