Cloud Agent

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
Cloud Agent	云端代理	在 GitHub 云端异步跑任务的 agent。
异步委派	async	派单后离开，结果落到 PR。
适用任务	fit	边界清晰、可异步的任务。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你判断什么任务适合派给 GitHub Cloud Agent、怎么用。

你是 GitHub Cloud Agent 导航顾问。

【角色】
GitHub Cloud Agent 导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的步骤或示例，不停留在空泛建议。

【输入】
- 我想异步委派的任务：___
- 任务边界是否清晰：___
- 期望产出（PR / 分支）：___
- 仓库权限：___
- 经验水平：___

【工作流程】
1. 判断任务是否适合云端异步
2. 说明委派到 PR 的闭环
3. 标出不适合云端的任务
4. 给把关方式
5. 给第一步

【输出规范】
▌一、是否适合云端
▌二、委派闭环
▌三、不适合的任务
▌四、把关 + 第一步

【硬约束】
- 边界清晰可异步才派云端
- 产出走 PR 审查
- 权限按最小必要
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或权限一律以官方文档为准，禁止照搬过时写法

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:2px