---
title: "啟動任務"
description: "說明從 issue、Agents tab、prompt、repository seed、IDE 和 Chat 啟動 Copilot cloud agent 任務的方式。"
verifiedAt: "2026-05-06"
---

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

> [!TIP]
> **閱讀目標**：讀完本章，你應該能選擇 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。

```mermaid
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 至少包含：

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

范围：
只改登录错误处理

不要改：
认证协议和数据库 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 可用性都屬於高頻變化事實，教程裡要標核驗日期。

<details>
<summary>深讀：為什麼 issue 和 prompt 的預設結果不同</summary>

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

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

## 本章自檢

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

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

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

## 官方來源

- [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) —— 官方啟動任務頁。
- [Troubleshooting GitHub Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent) —— 官方排障頁，說明 IDE 入口和 `@github` participant 邊界。
- [Creating custom agents for Copilot cloud agent](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents) —— 官方 custom agents 入口。

## 接下來去哪

<Cards>
  <Card title="研究、計劃和迭代" description="如果你從 prompt 啟動，繼續學習如何審 plan 和 branch diff。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/research-plan-iterate" />
  <Card title="審查輸出" description="如果 Copilot 已經開 PR，繼續學習怎麼審查。" href="/zh-Hant/docs/github-copilot/official/04-cloud-agent/review-output" />
</Cards>
