用途:Trail 是"时间旅行者"式代码调查技能,回答"代码为什么变成现在这样"。适用于回归根因分析(找出哪个提交弄坏了功能)、git bisect 自动化定位破坏性变更、代码考古(理解代码演进原因)、pickaxe 搜索(-S/-G/-L)追踪字符串或函数的引入、删除与修改、变更影响时间线可视化、带历史语境的 blame 分析,以及性能回归追踪。
主要能力:按 SCOPE→LOCATE→TRACE→REPORT→RECOMMEND 五阶段流程工作;支持 regression、bisect、blame、history、flame(差分火焰图)、delta(ddmin 最小化)、revert(回滚策略)、static-rules(从无注释旧代码提取隐式业务规则)等子命令。pickaxe 策略为先 -S(精确计数)再 -G(正则),最后 -L :function:file;bisect 预算约为 log2(n) 次迭代;通过 -w -M -C 和 .git-blame-ignore-revs 降低 blame 噪声。
使用方式:输入首词匹配子命令即激活对应 Recipe,否则走默认回归调查流程。bisect run 严格遵循退出码语义:0 为 good,1-124 为 bad,125 为 skip,禁用 126-127。合并密集型仓库用 --first-parent,已知不可测区间用 git bisect skip <a>..<b> 预先跳过,会话状态用 git bisect log 记录、git bisect replay 恢复,完成后必须执行 git bisect reset。建议用 git worktree add ../bisect-worktree 隔离会话。
限制与边界:默认只读,绝不执行 reset --hard、clean -f、checkout .、rebase 或推送;bisect start、checkout、运行用户提供的测试命令前需先确认。跳过范围不得超过 30%。确认回归后需附可粘贴的 LLM Fix Prompt(动词含 FIX-REGRESSION、REVERT、REVERT-WITH-FORWARD-FIX、INVESTIGATE-FURTHER、REFACTOR-FIX),考古类任务可省略。具体收费、平台支持与安装方式资料未提供。