使用 GitHub Copilot 代码审查

即使组织成员没有 Copilot 许可证，只要企业管理员或组织所有者启用，也可以使用 Copilot 代码审查。请参阅 没有 Copilot 许可证的组织成员的 Copilot 代码审查。

使用 Copilot 代码审查

本说明解释如何在 GitHub 网站上使用 Copilot 代码审查。若需查看其他流行编码环境的说明，请点击页面顶部相应的标签。

1. 在 GitHub.com 上，创建一个拉取请求（pull request），或转到已有的拉取请求。

2. 打开 Reviewers 菜单，然后选择 Copilot。

   

3. 等待 Copilot 审查你的拉取请求。通常不到 30 秒。

4. 向下滚动并阅读 Copilot 的评论。

   

   Copilot 始终留下 “Comment（评论）” 类型的审查，而不是 “Approve（批准）” 或 “Request changes（请求更改）”。这意味着 Copilot 的审查不计入拉取请求的必需批准，也不会阻止合并更改。更多详情，请参阅 使用必需审查批准拉取请求。

5. Copilot 的审查评论行为与人为审查评论相同。你可以对其添加回应、发表评论、解决或隐藏它们。

   你对 Copilot 审查评论添加的任何评论对人可见，但对 Copilot 不可见，且 Copilot 不会回复。

使用 Copilot 提供的建议更改

在可能的情况下，Copilot 的反馈会包括建议的更改，你只需点击几下即可应用。

如果你对更改满意，可以接受单个 Copilot 建议并提交，或一次接受一组建议并在一次提交中完成。更多信息，请参阅 在拉取请求中合并反馈。

你还可以调用 Copilot 云代理来实现建议的更改。为此，你必须

• 选择加入 Copilot 代码审查工具的公开预览并启用 Copilot 云代理。
• 在 GitHub Copilot 代码审查的评论上，点击 Implement suggestion。这会在拉取请求上创建一个草稿评论，你可以在其中指示 Copilot 处理特定反馈。Copilot 将基于这些建议在你的分支上创建一个新的拉取请求。

对 Copilot 的审查提供反馈

你可以在每条评论中直接对 Copilot 的评论提供反馈。我们会利用这些信息来改进产品和 Copilot 建议的质量。

1. 在 Copilot 的拉取请求审查评论上，点击点赞 (👍) 或点讽 (👎) 按钮。

   

2. 如果您点击反对按钮，系统会要求您提供更多信息。您可以选择负面反馈的原因并在点击 提交反馈 前留下评论（此步骤为可选）。

   

请求 Copilot 重新审查

当你向已被 Copilot 审查的拉取请求推送更改时，Copilot 不会自动重新审查这些更改。

要请求 Copilot 重新审查，请点击在 Reviewers（审阅者）菜单中 Copilot 名称旁的按钮。更多信息，请参阅 请求拉取请求审查。

启用自动审查

默认情况下，你需要像请求人工审查一样手动请求 Copilot 对每个拉取请求进行审查。然而，你可以设置 Copilot 自动审查所有拉取请求。请参阅 通过 GitHub Copilot 配置自动代码审查。

使用自定义指令定制 Copilot 的审查

你可以通过向仓库添加自定义指令来定制 Copilot 代码审查。

仓库自定义指令可以是整个仓库范围的，也可以是特定路径的。你可以在仓库的 .github/copilot-instructions.md 文件中指定全局自定义指令。该文件可用于存放你希望 Copilot 在审查仓库中任意位置代码时考虑的信息。

你也可以编写仅在审查匹配指定路径的文件时使用的指令。将这些指令写入一个或多个 .github/instructions/**/*.instructions.md 文件中。

更多信息，请参阅 为 GitHub Copilot 添加仓库自定义指令。

示例

以下是一个 .github/copilot-instructions.md 文件的示例，包含三条指令，这些指令将应用于仓库中所有 Copilot 代码审查。

When performing a code review, respond in Spanish.

When performing a code review, apply the checks in the `/security/security-checklist.md` file.

When performing a code review, focus on readability and avoid nested ternary operators.

When performing a code review, respond in Spanish.

When performing a code review, apply the checks in the `/security/security-checklist.md` file.

When performing a code review, focus on readability and avoid nested ternary operators.