啟動任務

啟動 cloud agent 任務時，prompt 要像 issue 規範（issue spec），而不是隨口聊天。官方頁面的核心分工是：assign issue 會直接建立 PR；從 prompt 啟動預設在 branch 上工作，方便你先 review、補提示、迭代，再決定是否建立 PR。

閱讀目標：讀完本章，你應該能選擇 issue assignment、Agents prompt、seed repository 或 IDE 入口，並寫出可執行的任務說明。

1. 啟動入口

官方文件列出幾種常見入口：

Assign issue to Copilot：把 issue 指派給 Copilot；它會工作並在完成後請求 review。
Agents tab / agents panel：選擇 repository，輸入 prompt，預設先在 branch 上工作。
github.com/copilot/agents：集中檢視和啟動 agent sessions。
Copilot Chat /task：從 GitHub.com Chat 或 dashboard prompt box 啟動。
Seed new repository：建立新儲存庫時讓 Copilot scaffold starter code，並開啟 draft PR。
IDE / GitHub Chat 建立 PR：某些入口可以請求 Copilot 開 PR；在 IDE 裡通常需要 @github participant。

flowchart TD
    Start["啟動任務"] --> Issue["Assign issue"]
    Start --> Prompt["Agents prompt"]
    Start --> Seed["Seed repository"]
    Start --> Chat["Chat / IDE"]
    Issue --> DirectPR["直接 PR"]
    Prompt --> Branch["預設 branch 迭代"]
    Seed --> DraftPR["Draft PR"]
    Chat --> PR["請求建立 PR"]
    Branch --> Review["review diff / follow-up prompt"]
    Review --> CreatePR["準備好後建立 PR"]

    style Branch fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style DirectPR fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style CreatePR fill:#dcfce7,stroke:#16a34a,stroke-width:2px

2. Issue assignment 的注意點

Assign issue 適合已有明確 issue 的任務。官方頁面說明，Copilot 會在 assignment 時接收 issue title、description 和已有 comments。

關鍵邊界：

Assignment 之後新增到 issue 的 comments，Copilot 不會自動看到。
後續資訊應該放到 Copilot 建立的 pull request 裡。
可以在 Optional prompt 裡補充編碼模式、要改的檔案、測試要求。
可以選擇 target repository、base branch、agent 或 custom agent。

3. Prompt 啟動的注意點

從 Agents prompt 啟動預設先在 branch 工作。適合你想先看 diff、繼續 prompt 迭代，然後再建立 PR 的場景。

一個合格 prompt 至少包含：

目标：
实现友好的错误提示

范围：
只改登录错误处理

不要改：
认证协议和数据库 schema

验证：
运行 auth 测试
说明未覆盖风险

如果你希望一開始就建立 PR，要在 prompt 裡明確說明。

4. 視覺輸入

官方啟動任務頁說明，從 prompt 啟動時可以新增視覺輸入，例如 screenshot 或 UI mockup；支援 image/png、image/jpeg、image/gif、image/webp。

適合：

UI 文案和佈局修復。
錯誤狀態截圖。
設計稿與當前頁面差異。

不適合：

貼上含賬號、客戶資料、token 或內部地址的截圖。

5. 模型和第三方 agent

官方頁面說明，Copilot Pro 或 Pro+ 使用者可以選擇 cloud agent 使用的模型；也可以在任務入口選擇 custom agent。第三方 coding agents 在 GitHub Copilot Pro+ 和 Copilot Enterprise plans 中可用。

團隊不要把這些選項寫死為永久狀態。模型、plan 和第三方 agent 可用性都屬於高頻變化事實，教程裡要標核驗日期。

深讀：為什麼 issue 和 prompt 的預設結果不同

Issue assignment 更像“把已有工單交給 Copilot 做成 PR”；Agents prompt 更像“先開一個可迭代的雲端工作分支”。前者快，後者更適合先研究和調整。

如果任務還沒完全定義清楚，優先用 prompt + branch 迭代；如果 issue 已經寫清楚驗收標準，可以直接 assign。

本章自檢

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

這個任務應該直接 PR，還是先 branch 迭代？
Prompt 是否寫了目標、範圍、不可觸碰內容和驗證方式？
如果從 issue 啟動，後續上下文是否會寫到 PR 裡？
是否包含敏感截圖、金鑰或不能給 cloud agent 的上下文？

透過標準：任務啟動後，reviewer 能從 issue、prompt 或 PR 裡覆盤 Copilot 被要求做什麼。

官方來源

Kick off a task with Copilot agents on GitHub —— 官方啟動任務頁。
Troubleshooting GitHub Copilot cloud agent —— 官方排障頁，說明 IDE 入口和 @github participant 邊界。
Creating custom agents for Copilot cloud agent —— 官方 custom agents 入口。

1. 啟動入口

2. Issue assignment 的注意點

3. Prompt 啟動的注意點

4. 視覺輸入

5. 模型和第三方 agent

本章自檢

官方來源

接下來去哪

研究、計劃和迭代

審查輸出

本頁目錄