用途:在打开源代码文件之前,先通过 git 历史检查代码库,帮助决定先看哪些文件、可能有哪些风险。适用于接手陌生代码库、开始审查、规划重构,或需要确定检查优先级时。
主要能力:按五类信号执行分析——改动热点(churn)、归属信号(ownership)、bug 聚类(bug clusters)、提交活跃趋势(activity trends)、救火信号(revert/hotfix/回滚)。最后交叉比对结果,排出应先检查的文件、目录、团队与时间段。
使用方式:从 git 历史入手,而非直接读代码。活跃仓库默认取 6 到 12 个月窗口,稳定仓库取 1 年,除非用户另有指定。可按需只加载相关参考文件(references/churn-hotspots.md、ownership-signals.md、bug-clusters.md、activity-trends.md、firefighting-signals.md),做部分工作。默认在当前工作目录生成 git-codebase-preflight-report.md,并在聊天中给出简要总结;用户明确要求不生成文件时仅在聊天中分析;用户要求对当前仓库运行时直接执行命令而非返回通用清单。输出分节:Hotspots、Ownership、Change Shape、Momentum、Firefighting、Next Reads;每个重要信号需附所用命令、白话解读、噪声时的置信度或说明,以及据此建议下一步检查什么。
限制与注意:churn 只是信号不是结论,高 churn 可能只是活跃产品开发而非架构差;作者计数只具方向性,squash-merge 可能隐藏真实贡献者;bug 修复提交过滤是近似的,提交信息质量差会降低信号质量;需将 churn 热点与 bug 聚类交叉比对后,才可判定某文件为高风险;活跃度按月的解读应作为假设而非事实。