SuperAPI AI 工具集

git-developer-performance

编程与开发

查看项目

更新于 11-06 09:11

技能介绍

用途:当用户需要基于 Git 提交生成开发者 KPI/绩效、生产力、贡献价值、努力点估算、人天估算、质量影响或质量工作报告时使用本技能。其目标是从本地 Git 历史规划并生成开发者绩效质量工作报告,使报告中的每个努力点、人天和价值主张都基于实际检查过的 diff,而非提交次数。

主要能力:脚本收集证据,AI 阅读变更并综合贡献价值。输出包含团队证据报告、按贡献者划分的分析计划、每位贡献者的提交/变更包、AI 撰写的价值综合与证据附录,以及贡献者、提交等源证据和确定性聚合数据。

使用方式:运行命令 node .claude/skills/git-developer-performance/scripts/git-developer-performance.cjs [options]。选项包括 --branch(默认 develop 后 main)、--days(默认 60)、--since、--until、--out(默认 reports/developer-performance)、--identity-map、--json。工作流为:设定目标并规划(每位贡献者一个待办任务);收集数据包(遍历完整合并历史);按贡献者分析(阅读直接提交与合并/管理提交);估算(自下而上小时数→likely_days→派生 EP);合理性检查后综合,写出 quality-work-summary.md 与 evidence-proof.md;最后验证(运行测试、重跑命令、确认输出路径在 .claude 之外)。

适用场景:需要从本地 Git 历史生成开发者贡献与质量报告、努力点与人天估算的团队或项目。

限制:仅使用本地 Git 历史,禁止查询外部服务;贡献者按身份映射/邮箱/高置信别名合并,而非原始显示名;共享功能分支的实现努力点归直接提交作者,不归合并作者;估算前需先扣除生成代码、文档、锁文件等非实现性变更;必须分别报告无 AI 与 AI 辅助两种人天,不得只给一个模糊数字;KPI 值为基于证据的估算,绝非完整 HR 评估;报告质量受本地 Git 数据质量限制。