---
title: "研究、計劃和迭代"
description: "說明 Copilot cloud agent 如何先研究儲存庫、生成計劃、在 branch 上迭代程式碼，再建立 pull request。"
verifiedAt: "2026-05-06"
---

Cloud agent 的高質量用法不是“直接讓它開 PR”，而是先研究、計劃、在 branch 上迭代，等 diff 可接受後再建立 PR。GitHub 官方頁面明確說明，這些能力**只在 GitHub.com 上的 Copilot cloud agent 中可用**——某些第三方整合只能直接建立 PR。

> [!TIP]
> **閱讀目標**：讀完本章，你應該能把 cloud agent 任務拆成 research、plan、iterate、PR 四段，而不是一次性丟給它。

## 1. 四段流程

- **Research**：讓 Copilot 先讀儲存庫、回答問題、確認相關檔案。
- **Plan**：讓 Copilot 給 implementation plan，並列出開放問題。
- **Iterate**：在 branch 上看 diff，補充約束，讓它繼續改。
- **PR**：準備好後再建立 pull request，並進入普通 review。

```mermaid
flowchart TD
    Prompt["任務 prompt"] --> Research["Deep research"]
    Research --> Plan["Implementation plan"]
    Plan --> ReviewPlan{"計劃可接受?"}
    ReviewPlan -->|否| Clarify["補充要求"]
    Clarify --> Research
    ReviewPlan -->|是| Branch["在 branch 上修改"]
    Branch --> Diff["審 diff"]
    Diff --> Iterate{"需要繼續改?"}
    Iterate -->|是| Follow["follow-up prompt"]
    Follow --> Branch
    Iterate -->|否| PR["Create pull request"]

    style Research fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Diff fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style PR fill:#dcfce7,stroke:#16a34a,stroke-width:2px
```

## 2. Research 階段怎麼問

適合先問：

```text
研究这个仓库：
找出登录错误是在哪些文件里处理的。
现阶段不要改代码。
列出相关文件和对应的测试。
```

Research 階段不要急著讓它實現。目標是確認它讀到的檔案和你預期一致。

## 3. Plan 階段怎麼看

一個可執行計劃應包含：

- 目標和非目標。
- 相關檔案。
- 實施步驟。
- 風險。
- 測試命令。
- 需要你回答的問題。

計劃不合格時，不要直接讓它“繼續”。用 follow-up prompt 補充約束，例如“不要改 schema”“只處理 web app”“保留舊 API”。

## 4. Iterate 階段怎麼控範圍

迭代階段要關注 branch diff：

- 是否改了 prompt 裡禁止的檔案。
- 是否新增依賴或 workflow。
- 是否刪除了測試。
- 是否把問題擴充套件成無關重構。
- 是否有明顯未執行測試的跡象。

如果需要改進，使用具體的 follow-up prompt：

```text
保留当前的实现思路。
撤销刚才对配置文件的改动。
补一个回归测试覆盖这条 bug。
不要动 .github/workflows。
```

## 5. Visual context

官方頁面說明可以提供視覺上下文，例如 screenshot 或 UI mockup。適合 UI bug、空狀態、錯誤提示、佈局差異。

使用時仍然要脫敏：

- 遮住賬號、token、客戶名稱。
- 不上傳內部 URL 或生產資料。
- 截圖只保留完成任務所需區域。

<details>
<summary>深讀：為什麼先 branch 迭代比直接 PR 更適合不確定任務</summary>

直接 PR 適合清晰 issue。對於需要探索的任務，先在 branch 上研究和迭代，可以避免讓 reviewer 面對一個方向錯誤的大 PR。

Cloud agent 的價值不只是寫程式碼，還包括把方案和 diff 提前暴露，讓你在 PR 前就能修正方向。
</details>

## 本章自檢

完成本章後，用這 4 個問題檢查：

1. Research 階段是否列出了相關檔案和測試？
2. Plan 是否有可執行步驟和開放問題？
3. Branch diff 是否只改了允許範圍？
4. 建立 PR 前是否已經審過主要 diff 和測試結果？

透過標準：PR 建立前，方向、範圍和驗證都已經被審過一輪。

## 官方來源

- [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) —— 官方研究、計劃和迭代頁。
- [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) —— 官方啟動任務頁。
- [Responsible use of GitHub Copilot cloud agent](https://docs.github.com/en/copilot/responsible-use/copilot-cloud-agent) —— 官方 responsible use 頁面。

## 接下來去哪

<Cards>
  <Card title="審查輸出" description="PR 建立後，繼續學習 review、Actions 和 @copilot 迭代。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/review-output" />
  <Card title="安全、治理與計費" description="把 cloud agent 放進組織策略和賬單邊界。" href="/zh-Hant/docs/github-copilot/official/08-security-governance" />
</Cards>
