官方教程中文版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 —— 官方審查輸出頁。