Skip to content

GitHub Copilot 可以在创建或更新 PR 时自动分析代码变更,生成结构化的 PR 描述摘要,节省开发者手写 PR Description 的时间,帮助 Reviewer 快速了解改动背景。

GitHub Copilot 自动生成 PR 摘要:告别手动写 Pull Request 描述

功能简介

写 PR 描述往往是个麻烦事——改动都在代码里,用文字重新描述一遍既费时又容易遗漏要点。Copilot 的 PR 摘要功能会自动分析你的代码变更,生成结构化的 PR 描述,包括:

  • 变更目的和背景
  • 主要修改的模块和逻辑
  • 测试情况说明(如果有相关变更)

使用步骤

  1. 在 GitHub 上创建 Pull Request(或打开已有的 PR)
  2. 在 PR 描述输入框评论框中点击
  3. 找到文本框顶部的 Copilot 图标
  4. 点击 → 选择「Summary
  5. Copilot 开始分析 PR 的代码 diff,生成摘要内容
  6. 审查生成的摘要,根据需要补充业务背景或特殊说明
  7. 提交 PR 或发布评论

最佳使用技巧

从空白描述开始

重要:Copilot 生成摘要时不会考虑现有的描述内容,建议在空白描述框中触发。如果描述框已有内容,生成的摘要会覆盖已有内容,不是追加。

生成后补充上下文

自动生成的摘要擅长描述"改了什么",但不知道"为什么改"。建议在摘要基础上手动补充:

  • 这个改动背后的业务需求
  • 有哪些权衡或已知的局限
  • 需要 Reviewer 重点关注的地方

用于 PR 评论

PR 摘要功能不仅限于 PR 描述,在评论框中同样可以触发,适合用来总结某个阶段的改动(比如按 Reviewer 建议修改后的说明)。

和代码审查的配合

Copilot 可以同时参与两个角色:

  • 作者角色:帮你生成 PR 描述
  • Reviewer 角色:以评审者身份留下代码建议

两者可以并行使用:先用摘要功能写好 PR 描述,再把 Copilot 加为 Reviewer 让它做代码审查。

详见代码审查指南

常见问题

Q: 生成的摘要准确吗?需要审查吗?

A: 需要审查。Copilot 基于代码 diff 生成,能准确描述技术层面的变更,但对业务逻辑的解读可能不够准确,生产环境的 PR 描述建议人工校对后再发布。

Q: 这个功能在哪些套餐可用?

A: PR 摘要功能在 Copilot Pro 及以上套餐可用,不包含在 Free 版本中。从 2026 年 6 月 1 日起,每次生成摘要会消耗 GitHub Actions 分钟数。

Q: 可以在 GitHub Mobile 上触发 PR 摘要吗?

A: 目前 PR 摘要功能主要在 GitHub Web 端支持,移动端的功能支持以官方最新文档为准。