任务限制与仓库兼容性
理解单仓库、单分支、运行时限和仓库规则对云端代理的影响。
This page has not been translated into English yet. The original Chinese version is shown below.
cloud agent 适合范围明确、可以独立验收的任务。开始前确认它能访问正确仓库，并把工作拆成能够在单次运行中完成的部分。
执行范围
| 项目 | 官方限制 |
|---|---|
| 修改仓库 | 一次任务仅修改开始时指定的仓库，不能跨多个仓库同时实施 |
| 工作分支 | 一次只能在一个分支上工作 |
| 创建 PR | 每个任务可以创建一个 PR |
| 默认 GitHub MCP 上下文 | 限当前工作仓库的 Issue、历史 PR 等；更广访问需要仓库 MCP 配置 |
| 仓库托管位置 | 必须托管在 GitHub，不能直接对其他代码托管平台的仓库执行 |
扩展读取其他仓库上下文，不等于允许一次任务向多个仓库提交更改。
会话时间限制
当前 GitHub.com 概览明确规定：每个 cloud agent 会话最长 59 分钟，不能延长或绕过。复杂任务需要拆分，单次只保留清晰的实现和验收目标。
官方排障页仍把卡住后的超时概括为“一小时”；本文采用当前概览的明确 59 分钟上限，并保留这一措辞差异。它也不是CLI 云端沙箱生命周期的通用值。
概览说明可通过 copilot-setup-steps.yml 的 timeout-minutes 配置更短超时。该文件的完整结构和允许字段见开发环境配置，不能通过增大此值突破上限。
仓库规则冲突
不兼容的 ruleset 或 branch protection 可能阻止代理工作，例如仅允许特定提交作者的规则。若规则由 rulesets 配置，仓库管理员可以按 GitHub 的规则管理方式把 Copilot 加为 bypass actor。
这是一项仓库权限配置，应由管理员按实际规则决定；普通用户无法通过修改提示词绕过保护规则。
Managed User 个人仓库
Copilot cloud agent 不支持 Enterprise Managed User 所拥有的个人仓库，因为这些仓库不能使用相应的 GitHub-hosted runners。应使用组织拥有的仓库，而不是反复重试相同个人仓库任务。