---
title: "07 · Cloud Agent 到 PR 的闭环"
description: "解释 Cloud Agent 如何从 prompt 或 issue 出发，研究仓库、建分支、改代码、给出 diff 并进入 PR 审查。"
verifiedAt: "2026-05-06"
---

Cloud Agent 最适合的不是你盯着屏幕等三分钟的小改，而是可以异步推进、最后回到 branch 和 PR 审查的仓库任务。GitHub 官方说明，Copilot cloud agent 能完成"研究仓库 → 制定实现计划（implementation plan）→ 在分支里改代码"这条链路，并在你准备好时创建 pull request。

> [!NOTE]
> **本章目标**：你会把 Cloud Agent 当成 GitHub PR 工作流的一部分使用，而不是当成一个“帮我自动写完”的黑箱。

## 1. PR 闭环

```mermaid
flowchart TD
  Source["Issue / Prompt / Agents tab"] --> Research["Research repository"]
  Research --> Plan["Implementation plan"]
  Plan --> Branch["Agent branch"]
  Branch --> Diff["Diff / commits / test output"]
  Diff --> Iterate{"需要继续改?"}
  Iterate -->|是| FollowUp["Follow-up prompt"]
  FollowUp --> Branch
  Iterate -->|否| PR["Create pull request"]
  PR --> Review["Human review / checks"]
  Review --> Merge{"通过?"}
  Merge -->|是| Ship["Merge"]
  Merge -->|否| More["Comment / request changes"]
  More --> Branch
```

这个闭环里，Cloud Agent 的产物不是“回答”，而是可审查的 branch、commits、diff、checks 和 PR 讨论。

## 2. 两种启动方式

官方启动任务页有一个重要分工：

- **Assign issue to Copilot**（把 issue 直接指派给 Copilot）：适合 issue 已经写清目标、范围和验收标准；Copilot 会基于 issue 标题、描述和已有 comments 工作，并创建 PR 或请求 review。
- **Agents prompt / Agents tab**（在 Agents 标签页里发起 prompt）：适合任务还需要研究和迭代；默认先在 branch 上工作，你可以 review diff、继续追加 prompt，然后再决定是否创建 PR。

一个容易踩的坑：issue assignment 后新增到 issue 的 comments，Copilot 不一定自动看到。后续上下文要写到它创建的 PR 或 session 里。

## 3. Prompt 要像 issue spec

Cloud Agent prompt 不应该是“帮我优化一下”。它至少要包含四件事：

```text
目标：
修复登录错误提示不清楚的问题。

范围：
只处理 Web 登录页和 auth 错误映射。

不要改：
认证协议、数据库 schema、billing、workflow。

验证：
运行 auth 相关测试，说明未覆盖风险。
```

如果任务包含 UI 差异，可以附 screenshot 或 mockup。上传前要遮住账号、客户数据、token、内部 URL 和生产信息。

## 4. Research、Plan、Iterate

Cloud Agent 的高质量用法不是直接 PR，而是先 research、plan、branch iterate，再 PR。

Research 阶段：

- 让它列相关文件、测试、入口和不确定点。
- 明确“不要改代码”。
- 检查它是否读到了正确模块。

Plan 阶段：

- 看目标和非目标是否清楚。
- 看文件范围是否合理。
- 看测试命令是否真实存在。
- 看开放问题是否需要你回答。

Iterate 阶段：

- 审 branch diff。
- 要求撤销无关改动。
- 补测试或收窄范围。
- 准备好后再创建 PR。

## 5. 什么任务适合 Cloud Agent

适合：

- backlog 里的中低风险改进。
- 文档、测试、技术债、错误提示。
- 能通过 branch、CI、PR review 验收的小功能。
- 需要先读仓库再给方案的任务。

不适合：

- 本地未提交现场。
- 必须依赖本机登录态、私密 UI 或本地环境。
- 生产部署、数据迁移、权限调整。
- 没有测试和 review 路径的模糊需求。

Cloud Agent 在 GitHub Actions 驱动的临时开发环境中运行，但临时环境不等于没有风险。它仍然可能改 workflow、依赖、权限配置或业务逻辑。

## 6. 审查清单

PR 出来后，至少检查：

1. 是否符合 issue 或 prompt 的范围。
2. 是否新增依赖、workflow、权限或配置。
3. 是否删除测试或跳过失败。
4. commit 和 diff 是否可理解。
5. checks 是否跑过并通过。
6. Copilot 的说明是否和代码一致。
7. 是否需要人工补充测试或回滚说明。

Cloud Agent 能提高异步吞吐，但不能替代代码负责人。

## 本章自检

你应该能回答：

- 这个任务应该 assign issue 直接 PR，还是先 prompt 到 branch 迭代？
- prompt 是否写清目标、范围、不可触碰内容和验证方式？
- PR 前是否已经审过 branch diff 和测试输出？
- 失败时能否关闭 PR 或人工接管分支？

通过标准：Cloud Agent 的每一步都能被 GitHub 对象追踪，而不是只靠自然语言总结。

## 官方来源

- [About GitHub Copilot cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent)：官方 cloud agent 能力、运行环境和适用边界。
- [Kick off a task with Copilot agents on GitHub](https://docs.github.com/copilot/how-tos/copilot-on-github/use-copilot-agents/kick-off-a-task)：官方任务启动入口、issue assignment 和 prompt 分工。
- [Research, plan, and iterate on code changes with Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/research-plan-iterate)：官方 research、plan、iterate、PR 流程。
- [Responsible use of GitHub Copilot cloud agent](https://docs.github.com/en/copilot/responsible-use/copilot-cloud-agent)：官方 responsible use 和安全边界。

## 接下来去哪

<Cards>
  <Card title="上一篇" description="先确认本地 VS Code Agent Mode 的任务边界。" href="/docs/github-copilot/understanding/06-agent-mode-in-vscode" />
  <Card title="下一篇" description="继续学习终端里的 Copilot CLI 工作流。" href="/docs/github-copilot/understanding/08-copilot-cli-workflow" />
  <Card title="Cloud Agent 官方页" description="回到官方重组页深读启动、研究、计划、迭代和审查。" href="/docs/github-copilot/official/04-cloud-agent" />
</Cards>
