Appearance
Copilot Cloud Agent 支持"研究→规划→迭代"三段式工作流：先让 Copilot 调研代码库回答问题，再请它制定修改计划，确认后才执行。会话不会自动创建 PR，需要在 Prompt 中明确要求。支持在 Prompt 中拖入图片提供视觉上下文。
GitHub Copilot Cloud Agent 研究与规划：先调研再动手的工作流
为什么要先研究再规划
直接让 AI 改代码有一个常见问题：AI 做了一堆改动，你不确定它是否理解了业务逻辑，等你发现方向跑偏时已经改了几十个文件。
Copilot Cloud Agent 的研究-规划-迭代工作流解决了这个问题：
- 研究阶段：先问 Copilot 代码库的现状，让它调研后回答
- 规划阶段：让 Copilot 提出修改方案（只出计划，不出代码）
- 迭代阶段：审查 diff，逐步细化，确认后再合并
第一步：研究阶段——先提问，了解代码库
在 GitHub Agents 面板或 Issue 分配方式启动一个会话，提问而不是下达任务：
这个仓库的认证流程是怎么实现的？请列出关键文件和调用链，不要修改任何代码。项目中目前有哪些地方直接使用了原始 SQL 字符串拼接？列出文件和行号。Copilot 会读取代码库、分析结构，以文本形式回答你的问题。在这个阶段不产生 PR 或代码变更。
第二步：规划阶段——让 Copilot 出方案
研究清楚之后，让 Copilot 制定修改计划：
基于你的调研，请提出一个把认证逻辑迁移到 JWT 的方案。列出要改哪些文件、改什么，不要实际动手修改。你之前发现的 SQL 注入风险，给出修复方案，分优先级列出每个修改点。Copilot 会输出一个结构化的修改计划，你可以评估可行性、提出调整意见，确认后再推进。
第三步：迭代阶段——审查 diff，逐步推进
确认方案后，让 Copilot 执行：
按照刚才的方案，先只修改认证模块（auth/），完成后等我审查再继续。每次 Copilot 推送变更后：
- 在 Agents 面板查看 diff 和会话日志
- 确认无误后，让 Copilot 继续处理下一个模块
- 如果有调整，在日志下方输入补充说明
关于 PR 创建
会话不会自动创建 PR。如果需要 PR，必须在 Prompt 中明确要求：
修改完成后，请创建一个 PR，标题描述这次改动的核心内容。如果只是想调研或制定方案，不需要 PR，不要在 Prompt 中提到"创建 PR"。
提供视觉上下文
Copilot Cloud Agent 支持在 Prompt 中拖入图片：
- UI 截图（"这个错误弹窗的界面是这样的，对应修改 Dialog 组件"）
- 架构图（"参考这张架构图，在对应位置新增缓存层"）
- 设计稿（"按照这个设计稿实现这个表单"）
直接拖拽图片到提示框即可附加，适用于视觉场景。
实用 Prompt 模板
调研型：
请调研这个仓库中 [功能模块] 的现有实现，总结：
1. 涉及的主要文件
2. 关键调用关系
3. 潜在的技术债务或问题
不要修改任何代码。规划型：
基于调研，提出一个 [改进目标] 的方案：
- 需要改动的文件清单
- 每个文件的改动类型（新增/修改/删除）
- 预计影响范围
先不要动手，等我确认方案后再执行。迭代型：
按照方案执行 [具体模块]，完成后停下来，我需要先看看 diff。与直接分配 Issue 的区别
| 工作流 | 适合场景 | 结果 |
|---|---|---|
| 直接分配 Issue | 需求明确、范围清晰 | Copilot 直接编码创建 PR |
| 研究-规划-迭代 | 需求模糊、技术方案待定 | 分阶段推进，人控制节奏 |
需求越不确定，越应该先走研究和规划阶段，避免 Copilot 在错误方向上做大量工作。
常见问题
Q: 研究阶段 Copilot 读取代码库会消耗 Premium Requests 吗？
A: 会。每个会话都消耗额度，包括只问问题不修改代码的研究型会话。
Q: 如果 Copilot 的调研结论有错，怎么纠正？
A: 直接在会话中追加说明："你对 X 的理解有误，实际上 Y 才是正确的"，Copilot 会基于纠正后的理解继续。
Q: 研究阶段可以提问多少次？
A: 没有固定次数上限，但每次追问消耗一个 Premium Request，复杂调研要注意额度。