Pull Request 模板

September 9, 2026 · View on GitHub

填写与本次 PR 有关的内容。未使用 AI 时,在 AI 协作记录中写“未使用”;没有人工审查或验证未完成时,如实说明即可。

改了什么

简要描述主要变更。

为什么改

说明这次变更的原因和预期结果。

任务边界

  • 本次允许改动:
  • 不在范围内或刻意未改:

变更类型

  • Bug 修复
  • 新功能
  • 重构
  • 文档
  • 测试
  • 工程维护

AI 协作记录(可选)

  • 工具与模型(已知时):填写工具与模型;未使用时写“未使用”。
  • AI 参与范围:
  • 由 AI 生成、修改或建议的文件或内容:

在此处记录工具参与,不能替代下面的人工审查和验证记录。

人工审查

  • 已由人工审查的文件和审查重点:
    • <path>
  • 尚未完成或未进行的人工审查:

只填写实际完成的审查;如尚未有人审查,明确写“未进行人工审查”。核对确认没有待审查内容后,才填写“无”。

验证记录

命令或检查实际结果覆盖范围或证据
通过 / 失败 / 未运行
  • 未验证项、原因及可能影响:

逐项核对确认没有未验证项后,才填写“无”。

风险与回滚

  • 风险及缓解措施:
  • 回滚方案:

Review 提示

  • 建议优先查看的文件、行为或场景:

提交前自查

  • diff 是否聚焦且可供认真 Review:
  • 测试是否已新增或更新;若不适用,原因:
  • 必要文档是否已更新;若不适用,原因:
  • 是否已核对没有提交 secret 或敏感数据: