官方教程中文版Cloud Agent
Cloud Agent
按 GitHub 官方文档梳理 Copilot cloud agent 的启动、研究计划、迭代、PR 审查和 Actions 安全边界。
Copilot cloud agent（云端代理，曾用名 Copilot coding agent）是 GitHub 上的异步开发代理。它可以在自己的临时开发环境里研究仓库、创建计划、改分支、跑测试，最后把结果交给你 review。
这组页面只处理云端 agent 的完整链路：什么时候交给它、怎么启动、先 branch 迭代还是直接 PR、如何审查输出、哪些安全边界不能省。
阅读目标：读完本组索引，你应该能把 cloud agent 任务纳入 branch、PR、review、Actions 和回滚流程。
1. 工作流地图
- About：理解 cloud agent 能做什么、在哪里运行、可用范围和适合任务。
- Kick off：从 issue、Agents tab、prompt、repository seed 或 IDE 入口启动任务。
- Research / Plan / Iterate：先让 Copilot 研究和计划，再在 branch 上迭代，最后决定是否 PR。
- Review output：PR 进入普通 review 流程，必要时用
@copilot请求修改。
flowchart TD
Task["任务"] --> Entry{"启动入口"}
Entry --> Issue["Assign issue"]
Entry --> Prompt["Agents prompt"]
Entry --> Repo["Seed repository"]
Issue --> PR["直接创建 PR"]
Prompt --> Branch["默认先在 branch 工作"]
Repo --> Draft["Draft PR"]
Branch --> Iterate["研究 / 计划 / 迭代"]
Iterate --> PR
PR --> Review["人工 review"]
Review --> Merge{"可合并?"}
Merge -->|否| Copilot["@copilot 请求修改"]
Copilot --> Review
Merge -->|是| Done["Merge"]
style Branch fill:#dbeafe,stroke:#2563eb,stroke-width:2px
style Review fill:#fef3c7,stroke:#d97706,stroke-width:2px
style Done fill:#dcfce7,stroke:#16a34a,stroke-width:2px2. 本组页面
Cloud Agent 是什么
理解 cloud agent 的能力、临时开发环境、适合任务和可用限制。
启动任务
从 issue、Agents tab、prompt、repository seed、IDE 或 GitHub Chat 启动云端任务。
研究、计划和迭代
先研究和计划，再在 branch 上审 diff、补充约束、创建 PR。
审查输出
按普通 PR 标准审查 Copilot 改动、Actions、merge conflict 和反馈。
3. 适合的任务
适合 cloud agent：
- backlog 里长期没人做的 “nice to have” 改进。
- 小到中型 bug 修复。
- 文档更新、测试覆盖率提升、技术债清理。
- 需要 PR review 的异步任务。
- 先研究仓库并给计划的复杂问题。
不适合：
- 需要你实时盯住每个编辑动作的微小改动。
- 生产部署、删数据、改云资源。
- 没有验收标准的“你自己看着办”。
- 需要未授权私有系统、密钥或线下上下文的任务。
4. 团队上线清单
- 确认仓库启用了 cloud agent，且不是 managed user account 场景。
- 明确哪些任务允许从 issue assign 给 Copilot。
- 规定 prompt 必须包含目标、非目标、测试、不可触碰范围。
- 规定是否允许自动运行 GitHub Actions。
- 规定 reviewer 必须看 diff、session logs 和 workflow file 变更。
- 规定
@copilotfollow-up 只由有 write access 的成员发起。
深读：Cloud agent 不是免 review 的外包开发者
Cloud agent 能在后台做事，节省等待时间，但它仍然是通过 prompt、仓库上下文和自动工具完成任务。它输出的是候选分支和 PR，不是最终结论。
商业级用法是把它当作额外开发资源，同时保留和人类贡献一样的审查、测试、批准和回滚流程。
本组自检
读完整组后，用这 4 个问题检查：
- 当前任务适合直接 PR，还是应该先 branch 研究和迭代？
- Copilot 能看到的 issue、prompt、comments 和仓库上下文是否足够？
- PR 里 GitHub Actions 是否需要人工批准运行？
- Review 失败时，是用
@copilot继续迭代，还是人工接管分支？
通过标准：cloud agent 输出进入普通工程审查流程，而不是绕过 review。
官方来源
- About GitHub Copilot cloud agent —— 官方概念页。
- Use Copilot agents —— 官方 agents 操作入口。
- Kick off a task with Copilot agents on GitHub —— 官方启动任务页。
- Review output from Copilot —— 官方审查输出页。