技能介绍

排查历史版本中的性能与功能回归

在大型仓库中排查问题时，最令人头疼的往往是定位到底是哪一次提交引入了 Bug。传统的人工 git bisect 排查需要开发者不断地切换分支、手动执行编译并核对结果，这个过程极其耗时且容易出错。特别是在处理复杂环境依赖时，历史版本的代码可能因为缺乏依赖或环境不一致而无法编译，导致排查过程被迫中断。

自动化代理的工作方式

该技能通过结合自定义测试脚本与 git bisect run 接口，将上述流程完全自动化，核心能力包括：

一键式脚本驱动：允许通过简单的 make 或 make test 命令直接作为二分查找的判定条件，无需人工干预编译和测试步骤。
健壮的跳过机制：利用 || exit 125 机制，当遇到编译失败或测试无法执行的历史节点时，Git 会自动跳过该提交，继续向下查找，确保流程不中断。
Docker 容器化执行：支持使用 Docker 运行测试环境，从而保证无论是一周前还是两年前的代码，都在完全一致的可复现环境中进行验证，避免“在我的机器上能跑”的尴尬。

适用边界与注意点

在使用该技能时，需要注意以下工程细节：

语义化标签：如果你希望使用 old 和 new 这种更符合直觉的词汇，必须运行 git bisect terms 进行全局配置，否则 Git 默认只识别 good 和 bad。
工作区清洁度：该工作流不会自动处理工作区中未保存的更改，建议在开始排查前确保当前工作目录是干净的。
底稿依赖：为了保证 git bisect run 能够正确工作，你需要确保在不同的二分节点上，构建脚本（如 Makefile）能够正确识别当前源码状态。