使用 GitHub Copilot代码评审 于 GitHub

GitHub Copilot 评审你的拉取请求并建议可随时应用的更改，以便快速获得对每个提交的可执行反馈。

在本文中

Copilot 代码评审 对于没有 Copilot 许可证的组织成员，当企业管理员或组织所有者启用时，也可以使用。 请参阅Copilot 代码评审没有Copilot许可证的组织成员。

请求来自Copilot的评审

  1. 在 GitHub.com 上，创建或打开拉取请求。

  2. 在右侧栏中的“审阅者”下 Copilot，单击“ 请求”。

    Copilot 的截图，显示“审阅者”下方的“Request”按钮。

  3. 等待 Copilot 完成评审。 这通常会在 30 秒内完成。

  4. 阅读Copilot有关拉取请求的评论。

    Copilot 留下的代码评审的屏幕截图。

Copilot 始终保留“批注”评审，而不是“批准”或“请求更改”评审。 其审查不计入所需的批准，也不会阻止合并。

Copilot的审阅评论功能类似于人工审核者的评论。 添加反应、回复、解决或隐藏它们。 您添加的任何答复对其他人可见，但对Copilot不可见。

您还可以通过 Copilot REST API 向 GitHub 请求评审，只需将 copilot-pull-request-reviewer[bot] 作为审阅者提出请求。 有关详细信息，请参阅“用于审查请求的 REST API 终结点”。

处理建议的更改

Copilot的反馈通常包含建议的更改，你只需点击几下即可应用。 接受单个建议或将多个建议分组到一个提交中。 有关详细信息，请参阅“在拉取请求中加入反馈”。

Copilot云代理若要直接实现建议的更改，

  1. 启用 GitHub Copilot代码评审 和 Copilot云代理。
  2. 在来自GitHub Copilot代码评审的审阅评论中，单击“使用 Copilot 修复”。 这将创建一个草稿批注，可在其中指示 Copilot 处理特定反馈。 你可以选择是否由 Copilot 针对你的分支创建新的拉取请求，还是直接提交到同一个拉取请求中。

提供对评论的反馈

评价 Copilot的评论，以帮助改进未来的建议。

  1. 在评论批注 Copilot中，单击大拇指向上（：+1：）或拇指向下（：-1：）按钮。

    显示 Copilot 代码评审 注释的屏幕截图，其中包含拇指向上和拇指向下按钮。

  2. 如果单击拇指向下，可以选择选择原因并留下批注，然后单击“ 提交反馈”。

    对 Copilot 的注释提供负面反馈时，用于提供附加信息的表单截图。

请求重新评审

当你向 Copilot 已审阅过的拉取请求推送新的更改时，除非你已将自动审阅配置为包含新的推送，否则它不会自动重新审阅。

若要手动请求重新评审，请单击Copilot”菜单中“名称”旁边的**** 按钮。 有关详细信息，请参阅“请求拉取请求审查”。

若要在每个推送上自动请求重新评审，请启用自动代码评审，然后在规则集设置中选择“ 审阅新推送 ”。 有关详细信息，请参阅“通过GitHub Copilot配置自动代码评审”。

重新评审时，Copilot 可能会重复以前的注释，即使你已解决或给予低评价这些注释。

启用自动评审

默认情况下，在每个拉取请求上手动请求评审 Copilot 。 若要为所有拉取请求启用自动评审，请参阅 通过GitHub Copilot配置自动代码评审。

使用自定义指令来个性化评论

您可以通过向存储库添加自定义说明来定制 Copilot 代码评审。

存储库自定义说明可以是存储库范围的，也可以是特定于路径的。 您可以在存储库的 .github/copilot-instructions.md 文件中指定整个存储库的自定义指令。 可以使用此文件存储希望 Copilot 在存储库中的任何位置查看代码时考虑的信息。

你也可以编写 Copilot 仅在查看与指定路径匹配的文件中的代码时使用的说明。 在一个或多个 .github/instructions/**/*.instructions.md 文件中编写这些说明。

有关详细信息，请参阅“为GitHub Copilot添加存储库自定义说明”。

注意

评审拉取请求时，Copilot 使用拉取请求基础分支中的自定义指令。 例如，如果你的拉取请求旨在将 my-feature-branch 合并到 main，Copilot 将使用 main 中的自定义指令。

示例

以下是一个 .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.

MCP 服务器和代理技能

注意

Support for agent skills and MCP servers with Copilot 代码评审 is in 公开预览 and subject to change.

Copilot 代码评审 可以使用仓库中配置的代理技能和 MCP 服务器，前提是它们与评审相关。

若要使这些内容可供 Copilot 代码评审 在 GitHub 上使用，请进行如下配置：

  • 您的存储库（位于 ****）中的.github/skills。 如果希望技能以审阅任务为目标，请使用以审阅为中心的技能目录名称，例如 code-review。 有关设置详细信息，请参阅 为 GitHub Copilot 添加代理技能。
  • 仓库 Copilot 设置中的 MCP 服务器 GitHub MCP 服务器和 Playwright MCP 服务器默认处于启用状态。 有关设置详细信息，请参阅 为存储库配置 MCP 服务器。

Copilot 代码评审 在以下情况下更有可能使用此上下文：

  • 智能体技能目录具有以审核为中心的名称和说明，例如 code-review，指示它们用于拉取请求审核。
  • 代理技能或自定义说明明确指示 Copilot 代码评审 使用特定的 MCP 上下文。
  • 拉取请求描述会引用可通过已配置的 MCP 服务器访问的项目，例如问题键或事件 ID。

若要验证用于特定评审的 MCP 上下文 Copilot 代码评审 ，请从拉取请求时间线打开链接评审会话，然后检查会话日志以查看调用了哪些 MCP 服务器和工具。

在存储库设置中，允许 Copilot 在审查拉取请求时使用 MCP 工具默认处于启用状态。 如果您希望 MCP 服务器仅对 Copilot云代理 可用，而不对 Copilot 代码评审 可用，请禁用此设置。 有关分步说明，请参阅 为存储库配置 MCP 服务器。

延伸阅读