使用 GitHub Copilot代码评审 于 GitHub

GitHub Copilot 会评审你的拉取请求并建议可随时应用的更改，以便快速获得有关每项提交的可操作反馈。

在本文中

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

请求 Copilot 进行评审

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

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

    Copilot 的屏幕截图，其中显示“审阅者”下方的“请求”按钮。

  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 一般做法。

使用位于仓库根目录中的 AGENTS.md 文件来提供更多仓库上下文信息，帮助 Copilot 更好地理解你的项目是如何运作的。 例如，可以解释哪些模式是有意的、代码库的哪些部分需要更仔细的审查，以及团队认为良好的体系结构、测试和实现做法。 这有助于使评审更相关，并与团队构建软件的方式保持一致。

使用 .github/instructions/**/*.instructions.md 文件来编写仅在审查匹配文件时适用的针对特定路径的说明。 当存储库的不同部分遵循不同的约定、需要专用检查或需要针对特定语言、框架或子系统定制的评审指南时，这非常有用。

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

注意

审查拉取请求时，Copilot 会从头部分支（包含更改的分支）而不是基础分支读取存储库自定义说明、智能体说明和智能体技能。 例如，在将 my-feature-branch 合并到 main 时，Copilot 会使用 my-feature-branch 中的说明和技能，因此您可以在同一个拉取请求中测试对它们的更改，而无需先将它们合并。

示例

此文件示例 .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 服务器和代理技能

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 服务器和工具。

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

延伸阅读