启动任务

启动 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

本章自检

官方来源

接下来去哪

研究、计划和迭代

审查输出

本页目录