将 GitHub Issue 分配给 Copilot，或在 Chat 中发 /task 指令，Cloud Agent 会独立完成开发并提 PR 等待你审查。本页整理所有触发 Cloud Agent 创建 PR 的入口和操作步骤。

使用 GitHub Copilot Cloud Agent 创建 PR：从 Issue 到代码的自动化流程

方式一：从 GitHub Issues 分配

这是最自然的触发方式——把 Issue 像分配给同事一样分配给 Copilot：

1. 打开任意 Issue
2. 在右侧 Assignees 面板点击齿轮图标
3. 搜索 Copilot 并选择
4. （可选）在 Issue 评论区给出更详细的实现要求

Copilot 会在 Issue 上留 👀 表情表示已接收任务，随后开始工作。

也可以通过 GitHub Mobile 的 Issue 详情页做同样的操作。

通过 API 分配（自动化场景）

# 使用 GitHub CLI
gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  /repos/OWNER/REPO/issues/ISSUE_NUMBER/assignees \
  --input - <<< '{
    "assignees": ["copilot-swe-agent[bot]"]
  }'

也可以在 JSON body 中传入 agent_assignment 参数，指定基分支或自定义指令。

方式二：从 GitHub.com Chat

1. 在 GitHub.com 上打开 Copilot Chat
2. 输入 /task 加上任务描述：

   /task 为用户列表添加分页功能，每页 20 条，支持跳转到指定页

3. 选择目标仓库和基分支（默认使用主分支）
4. 提交后 Cloud Agent 开始工作

方式三：从 VS Code

1. 打开 Copilot Chat 面板
2. 描述任务后，点击「委托给 Cloud Agent」按钮
3. 选择仓库和分支，确认后 Cloud Agent 在云端开始执行

方式四：从 JetBrains / Eclipse / Visual Studio

在 Copilot Chat 面板中找到 Cloud Agent 图标或按钮，输入任务描述并选择仓库配置后提交。

方式五：GitHub CLI

gh agent-task create --repo OWNER/REPO --prompt "修复登录页面的表单校验 Bug"

可选参数：

• --base-branch：指定基分支
• --model：指定使用的 AI 模型

方式六：GitHub Mobile

1. 打开 GitHub Mobile 应用
2. 点击 Copilot 图标
3. 输入任务描述
4. 选择仓库后确认

任务进行中：如何 steer

任务开始后，Cloud Agent 会在 PR 的 session 日志中记录所有操作（类似 AI 的"内心独白"）。

如何引导正在进行的任务：

• 在 PR 评论区 @copilot 加上新的要求
• 例如：@copilot 这个函数的命名改一下，用更描述性的名字

停止任务：

• 在 session 日志页面点击「Stop session」
• 或在 Issue/PR 中取消 Copilot 的分配

查看 PR 和提交

Cloud Agent 提交的每个 commit message 包含 session 日志链接，可以追溯 AI 的每一步决策。

commit 的 author 是 Copilot，co-author 是触发任务的人类用户，Git 记录透明可追溯。

常见问题

Q: 分配给 Copilot 后没有任何反应，怎么回事？

A: 等待 1~2 分钟刷新页面。如果 Issue 上没有出现 👀 反应，检查：1）你的仓库是否有 Cloud Agent 权限（查仓库设置 → Copilot）；2）你的 Copilot 套餐是否支持 Cloud Agent（Free 不支持）。

Q: Cloud Agent 提的 PR 质量很差，能重新做吗？

A: 关闭 PR，重新分配 Issue 会触发新的 session。或者在 PR 评论中详细说明哪里不对，@copilot 重新修改。

Q: 可以给 Cloud Agent 提供额外的项目背景吗？

A: 可以。在 Issue 评论中详细描述需求和约束，或者在 .github/copilot-instructions.md 中写入项目规范，Cloud Agent 会自动读取。