啟動任務
說明從 issue、Agents tab、prompt、repository seed、IDE 和 Chat 啟動 Copilot cloud agent 任務的方式。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| Kick off | 發起任務 | 給雲端 agent 派單。 |
| 任務描述 | brief | 把目標和約束寫清楚。 |
| 驗收標準 | criteria | 明確什麼算完成。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你把一個任務清楚地派給 Cloud Agent，提高一次成功率。
你是 Cloud Agent 派單顧問。
【角色】
Cloud Agent 派單顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的步驟或示例，不停留在空泛建議。
【輸入】
- 要委派的任務：___
- 明確的目標和約束：___
- 涉及的檔案 / 模組：___
- 驗收標準：___
- 經驗水平：___
【工作流程】
1. 把任務寫成清楚的 brief
2. 補全目標、約束、範圍
3. 設定驗收標準
4. 標出容易跑偏處的預防
5. 給發起步驟
【輸出規範】
▌一、任務 brief
▌二、目標 / 約束 / 範圍
▌三、驗收標準
▌四、預防跑偏 + 發起
【硬約束】
- brief 寫清範圍和約束，不含糊
- 驗收標準可檢驗
- 敏感操作不放進自動任務
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或許可權一律以官方文件為準，禁止照搬過時寫法啟動 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 裡通常需要
@githubparticipant。
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:2px2. 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 入口和
@githubparticipant 邊界。 - Creating custom agents for Copilot cloud agent —— 官方 custom agents 入口。