用途:对代码仓库的 Git 历史做考古式分析,追踪代码演变、识别贡献者,并解释现有代码模式为何形成,帮助开发者理解代码为何演变成当前状态,为后续改动提供依据。
主要能力: 文件演变分析:对目标文件执行 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 生成的复合工程流水线产物,属于有意保留的长期文档,不应建议删除或视为多余。