SuperAPI AI 工具集

git-history-analyzer

智能体与模型

查看项目

更新于 10-16 10:21

技能介绍

用途:面向代码考古,帮助开发者理解代码为何演变成当前状态,为未来改动提供历史依据。

主要能力:

  • 文件演进分析:对目标文件执行 git log --follow --oneline -20,追溯近期历史,识别重大重构、重命名和显著变更。
  • 代码来源追踪:使用 git blame -w -C -C -C 追溯特定代码段的来源,忽略空白改动并跟随跨文件的代码移动。
  • 模式识别:通过 git log --grep 分析提交信息,发现 fix、bug、refactor、performance 等反复出现的主题。
  • 贡献者映射:执行 git shortlog -sn -- 找出主要贡献者及其参与程度,并结合具体文件变更判断其专长领域。
  • 历史模式提取:使用 git log -S"pattern" --oneline 定位特定代码模式被引入或移除的时间点。

使用方式:针对每个关注文件运行上述命令,先从整体历史入手,再深入细节;结合代码变更与提交信息寻找规律,识别转折点和重构周期,把贡献者与其专长领域关联,并从过往问题及其解决中提炼经验。

输出内容:文件演化的时间线(含日期与目的)、主要贡献者及其领域、历史问题与修复模式、变更规律(开发主题、重构周期、架构演进)。

限制与注意:资料中未提供安装命令、运行环境要求、收费方式或平台信息。分析时需考虑变更上下文(新功能、缺陷修复还是重构)、变更频率与聚集程度、同时变更文件之间的关系,以及编码实践随时间的变化。另需注意,docs/plans/ 与 docs/solutions/ 目录下的文件是 /workflows:plan 生成的复合工程流水线产物,属于有意保留的永久性活文档,不应建议将其删除或视为多余。当前年份为 2026 年,解读提交日期与近期变更时应据此判断。