用途 该文档面向使用 GitHub Copilot 云代理(Copilot cloud agent)的开发者,说明在 Copilot 完成编码任务并请求审查后,如何审查其输出、批准相关工作流运行并给出反馈。核心原则是:Copilot 的拉取请求应当像任何其他贡献一样被彻底审查。
主要能力与使用方式
- 审查 Copilot 的更改:当 Copilot 完成编码任务并请求审查时,需在合并前彻底检查拉取请求。如果仓库要求拉取请求批准,用户对 Copilot 拉取请求的批准不计入所需批准数量,必须由另一位审查者批准后方可合并。若需向 Copilot 请求更改,可在评论中提及 @copilot,或直接向该分支推送提交。
- 管理工作流运行:默认情况下,当 Copilot 向拉取请求推送更改时,GitHub Actions 工作流不会自动运行。工作流可能具有特权并可访问敏感机密,因此需检查拉取请求中的拟议更改,确认可以在该拉取请求分支上运行工作流,尤其要警惕 .github/workflows/ 目录中影响工作流文件的更改。要允许工作流运行,点击拉取请求合并框中的“Approve and run workflows”按钮。可选地,可将 Copilot 云代理配置为允许 GitHub Actions 工作流在无人干预的情况下运行。
- 提供反馈:使用 Copilot 拉取请求和评论上的反馈按钮对输出进行评分。在 Copilot 的拉取请求或评论上,点击点赞或点踩按钮。若点击点踩,可选择原因并留下评论,然后点击“Submit feedback”。反馈有助于提升 Copilot 质量。
适用场景与限制 Copilot 云代理适用于所有付费 Copilot 计划,并可在 GitHub 上存储的所有仓库中使用,但受管用户账户拥有的仓库以及被明确禁用的仓库除外。需要注册 Copilot。该文档还提供延伸阅读,包括使用 GitHub Copilot 处理任务的最佳实践以及 GitHub Copilot 云代理故障排除。