研究、計劃和迭代

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

1. 四段流程

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

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 階段怎麼問

適合先問：

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

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

3. Plan 階段怎麼看

一個可執行計劃應包含：

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

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

4. Iterate 階段怎麼控範圍

迭代階段要關注 branch diff：

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

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

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

5. Visual context

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

使用時仍然要脫敏：

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

本章自檢

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

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

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

官方來源

• Research, plan, and iterate on code changes with Copilot cloud agent —— 官方研究、計劃和迭代頁。
• Kick off a task with Copilot agents on GitHub —— 官方啟動任務頁。
• Responsible use of GitHub Copilot cloud agent —— 官方 responsible use 頁面。

接下來去哪