SuperAPI AI 工具集

git-stats

编程与开发

查看项目

更新于 10-16 09:05

技能介绍

用途

Git 贡献统计用于对当前 Git 仓库的提交历史进行汇总,帮助用户了解团队成员的贡献情况,包括谁提交了多少代码、修改了哪些文件、增删行数以及贡献时间范围等。

主要能力

  • 按作者输出统计结果,每位作者一行。
  • 展示作者名,并自动合并同一人的不同 git 身份,合并基于传递闭包:同 email 不同 name、同 name 不同 email 均可识别合并。
  • 提供 commit 占比条,用于可视化提交占比。
  • 统计 commits 提交次数及百分比。
  • 统计修改过的不同文件数(去重)。
  • 统计增删行数及净变化(Added / Removed / Net)。
  • 统计时间范围,即该作者第一次到最后一次提交的日期。
  • 顶部提供摘要卡片,包含总 commits、贡献者数、总增删、文件数。
  • 底部提供项目总计。

使用方式

运行脚本,脚本路径相对于此 skill 目录:

bash <skill-dir>/scripts/git-stats.sh [range]

参数说明:range 参数控制统计范围,会直接传给 git log。

  • --all(默认):统计所有分支的全部历史。
  • 无参数:统计当前分支全部历史。
  • main..test:统计 test 分支相对于 main 的差异。
  • --since="2026-01-01":从某个日期开始统计。
  • --since="2026-01-01" --until="2026-02-01":统计指定日期范围。
  • HEAD~50..HEAD:统计最近 50 个 commit。

示例:

# 全部历史
bash <skill-dir>/scripts/git-stats.sh --all

# 本月统计
bash <skill-dir>/scripts/git-stats.sh '--since="2026-03-01"'

# 某分支 vs 主分支
bash <skill-dir>/scripts/git-stats.sh 'main..feature-branch'

适用场景

当用户想要了解团队贡献、查看谁提交了多少代码、分析 git 历史统计、查看代码贡献排行时,可使用此技能。

限制与注意事项

  • 大仓库首次运行可能需要几十秒,因为需要遍历所有 commit 的 numstat。
  • 二进制文件的增删行数不计入统计。
  • 合并 commit 如果没有实际 diff,则不计入文件和行数统计。
  • 作者合并使用传递闭包算法,例如 A 用 email1 提交过 name1 和 name2,会自动合并为一人。
  • 兼容 macOS 和 Linux。