---
title: "Cloud Agent"
description: "按 GitHub 官方文件梳理 Copilot cloud agent 的啟動、研究計劃、迭代、PR 審查和 Actions 安全邊界。"
verifiedAt: "2026-05-06"
---

Copilot cloud agent（雲端代理，曾用名 Copilot coding agent）是 GitHub 上的非同步開發代理。它可以在自己的臨時開發環境裡研究儲存庫、建立計劃、改分支、跑測試，最後把結果交給你 review。

這組頁面只處理雲端 agent 的完整鏈路：什麼時候交給它、怎麼啟動、先 branch 迭代還是直接 PR、如何審查輸出、哪些安全邊界不能省。

> [!TIP]
> **閱讀目標**：讀完本組索引，你應該能把 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` 請求修改。

```mermaid
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
```

## 2. 本組頁面

<Cards>
  <Card title="Cloud Agent 是什麼" description="理解 cloud agent 的能力、臨時開發環境、適合任務和可用限制。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/about-cloud-agent" />
  <Card title="啟動任務" description="從 issue、Agents tab、prompt、repository seed、IDE 或 GitHub Chat 啟動雲端任務。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/kick-off-a-task" />
  <Card title="研究、計劃和迭代" description="先研究和計劃，再在 branch 上審 diff、補充約束、建立 PR。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/research-plan-iterate" />
  <Card title="審查輸出" description="按普通 PR 標準審查 Copilot 改動、Actions、merge conflict 和反饋。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/review-output" />
</Cards>

## 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 變更。
- 規定 `@copilot` follow-up 只由有 write access 的成員發起。

<details>
<summary>深讀：Cloud agent 不是免 review 的外包開發者</summary>

Cloud agent 能在後臺做事，節省等待時間，但它仍然是透過 prompt、儲存庫上下文和自動工具完成任務。它輸出的是候選分支和 PR，不是最終結論。

商業級用法是把它當作額外開發資源，同時保留和人類貢獻一樣的審查、測試、批准和回復流程。
</details>

## 本組自檢

讀完整組後，用這 4 個問題檢查：

1. 當前任務適合直接 PR，還是應該先 branch 研究和迭代？
2. Copilot 能看到的 issue、prompt、comments 和儲存庫上下文是否足夠？
3. PR 裡 GitHub Actions 是否需要人工批准執行？
4. Review 失敗時，是用 `@copilot` 繼續迭代，還是人工接管分支？

透過標準：cloud agent 輸出進入普通工程審查流程，而不是繞過 review。

## 官方來源

- [About GitHub Copilot cloud agent](https://docs.github.com/en/copilot/concepts/agents/cloud-agent/about-cloud-agent) —— 官方概念頁。
- [Use Copilot agents](https://docs.github.com/en/copilot/how-tos/copilot-on-github/use-copilot-agents) —— 官方 agents 操作入口。
- [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) —— 官方啟動任務頁。
- [Review output from Copilot](https://docs.github.com/en/copilot/how-tos/copilot-on-github/use-copilot-agents/review-copilot-output) —— 官方審查輸出頁。

## 接下來去哪

<Cards>
  <Card title="Cloud Agent 是什麼" description="先理解 cloud agent 的執行環境和適用場景。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/about-cloud-agent" />
  <Card title="啟動任務" description="再學習從 issue 和 prompt 啟動任務的區別。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/kick-off-a-task" />
</Cards>
