一、自动PR更新Hook的设计
在代码提交到分支后自动更新PR相关信息，减少手动操作提高效率。自动PR更新Hook是一组围绕着Pull Request生命周期自动化的Hook集合，涵盖了从PR描述生成、标签分类、Reviewers分配到合并前检查的完整流程。
核心价值：将PR管理从手动操作转变为自动化流程，减少开发者的重复劳动，提高代码审查效率，确保PR质量。
Hook触发时机
自动PR更新涉及多个触发时机：
- after:tool/git_push — 代码推送后自动生成/更新PR信息
- before:tool/git_merge — 合并前检查PR状态
整体架构
自动PR更新Hook由三个关键阶段组成：推送时自动生成PR描述和标签、创建时分配Reviewers、合并前进行状态检查。
每个阶段都有独立的Hook配置，可以灵活启用或禁用。
二、PR描述自动生成Hook（after:tool/git_push）
从分支上的所有commit消息汇总生成PR描述。该Hook在代码推送后自动触发，完成以下工作：
- 收集当前分支上所有commit消息
- 按Conventional Commits类型分类组织（feat/fix/docs/chore等）
- 自动列出变更的文件列表
- 关联相关Issue编号（从commit消息中识别 #123 格式）
- 生成结构化的PR描述模板
# 自动生成的PR描述示例
## 变更摘要
- feat: 添加自动PR更新Hook功能
- fix: 修复PR标签分类逻辑
- docs: 更新Hook使用文档
## 变更文件
- src/hooks/pr-update.ts
- src/hooks/pr-label.ts
- docs/pr-automation.md
## 关联Issue
- Closes #123
- Related to #456
最佳实践：建议团队统一采用Conventional Commits规范，这样Hook可以自动将commit按类型分组，生成更清晰的PR描述。
三、PR标签自动分类Hook
根据变更类型自动添加标签，简化PR分类流程。该Hook分析推送的commit和变更文件，自动：
- 根据变更类型添加标签（enhancement/bug/documentation/dependencies）
- 根据影响模块添加模块标签（frontend/backend/api/docs）
- 根据修改文件数量标记PR大小（XS/S/M/L/XL）
- 自动标记Breaking Change（检测到 BREAKING CHANGE 关键字时）
PR Size 判定标准：XS（1-10文件）、S（11-30文件）、M（31-100文件）、L（101-500文件）、XL（500+文件）
标签分类规则配置
可以通过配置文件自定义标签映射规则，例如将`fix:`类型的commit映射为`bug`标签，将`docs/`目录的修改映射为`documentation`标签。
规则支持正则表达式匹配，灵活适应不同团队的需求。
四、Reviewers自动分配Hook
分析被修改文件的Git blame历史，推荐最熟悉该代码的Reviewers。该Hook在PR创建时自动：
- 对每个被修改文件执行Git blame分析
- 统计每个文件的Top Contributors
- 根据历史贡献度计算Reviewer推荐得分
- 结合团队成员当前负载进行均衡分配
- 自动通过GitHub API请求PR Review
最佳实践：建议至少分配2名Reviewer——一名熟悉业务逻辑，一名熟悉技术实现。
# Reviewers分配算法伪代码
function assignReviewers(changedFiles, teamMembers):
scores = {}
for file in changedFiles:
blameData = gitBlame(file)
for author in blameData.authors:
scores[author] += blameData.getWeight(author)
# 考虑当前负载
for member in teamMembers:
scores[member] /= (member.openPRs + 1)
return topN(scores, 2)
五、PR状态检查Hook（before:tool/git_merge）
合并前检查PR是否满足所有合并条件，不符合时阻止合并。该Hook在git merge操作前执行以下检查：
- 检查PR是否获得足够的Approved Reviews
- 检查CI/CD流水线是否全部通过
- 检查是否存在未解决的讨论或评论
- 检查当前分支是否落后于目标分支（需要rebase）
- 检查是否有关联但未关闭的Issue
注意：状态检查Hook应作为安全网，而非唯一的质量控制手段。团队仍应培养代码审查文化，不要完全依赖自动化检查。
自动修复策略
对于部分可自动修复的问题（如分支落后目标分支），Hook可以自动执行rebase操作。
对于需要人工干预的问题（如缺少Review），Hook会阻止合并并给出清晰的错误提示。
所有检查结果都会以评论形式发布在PR上，方便开发者了解失败原因。
核心要点总结：自动PR更新Hook通过before/after机制覆盖了PR的完整生命周期——推送后自动生成描述和标签、创建时自动分配Reviewers、合并前自动检查状态，大幅提升了团队的协作效率。合理配置这些Hook可以减少PR管理中的重复性手动操作，让开发者更专注于代码本身。