用途
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。