如何通过GitHub webhook统计特定工作项下各开发者的代码提交次数

方案可行性验证 #

你初步设想的监听PR合并事件的流程是最优方案，实现逻辑简单且数据准确性高，无需额外处理冗余的全量提交数据。

具体疑问解答 #

• webhook事件的提交数据包含情况
  监听pull_request类型的webhook，当事件action为closed且merged字段为true时（即PR被合并），payload中的pull_request对象直接包含commits字段（返回该PR关联的提交总数量），同时提供commits_url可拉取完整的提交列表，每个提交条目都自带author、committer对应的GitHub用户名信息，不需要额外查询其他接口就能拿到统计所需的全部基础数据。
• PR关联提交的范围
  GitHub的PR关联提交仅包含该特性分支从主干（main）分叉创建后、到合并前产生的独有提交，不会包含仓库全量历史提交。即使你在特性分支开发过程中合并过main分支的更新，GitHub也会自动过滤掉重复的主干提交，仅统计该PR实际引入的新提交，统计范围完全符合你的需求。
• Tag推送事件的能力说明
  你的判断基本正确：Tag本身只是指向某一次commit的指针，Tag对应的push webhook payload仅会返回当前Tag绑定的commit hash，不会自动返回和上一个Tag之间的提交差异，你需要额外获取前后两个Tag的commit hash、再通过git命令或GitHub API手动比对才能拿到中间的提交列表，实现成本远高于监听PR合并事件的方案。另外Tag并不会存储仓库创建以来的全量提交记录，它仅为单个commit的别名标记。

优化补充（针对特定工作项关联需求） #

如果需要把提交和特定工作项绑定，可以在团队内约定提交信息规范，要求开发者在commit message或者PR标题中携带工作项编号（例如#工单123），你在统计提交时通过正则匹配对应编号就能快速归类到对应工作项，实现精准统计。

内容的提问来源于stack exchange，提问作者1977