提交历史考古指南
该指南帮助开发者在追查代码由来时,避免仅凭提交标题或一行差异判断改动范围。它建议先找仓库内已有的文字记录,再按文件路径、差异统计、分支引用和拓扑顺序追查历史。
主要内容
- 对没有正文说明的提交,结合文件统计和实际差异判断范围,不能把标题当作设计理由。
- 子仓库指针的一行更新可能包含多次变更;需要另一个仓库及两端提交才能展开,空输出不能证明没有内容。
- 区分合并与普通提交,沿文件移动继续追溯,并注意作者日期和提交日期的差别。
- 原文给出 Git 与 awk 检查示例,包含采样窗口的成本限制说明;这些是指南内容,本站未执行。
来源与当前状态
观察日期:2026-10-18 UTC。发布者 README 说明,2.0 版以前每个陷阱各自作为独立 Skill,随后合并为分领域 Skill。当前仓库在 engineering-method-footguns 的参考资料中仍完整保留同名声明和指南;这是当前保留参考的全文,未声称找回旧安装路径的历史版本。目录中的原名称与安装身份保留。
固定来源:完整指南;发布者迁移说明。作者为 maxrave-dev。完整原文可从本页英文版查阅,原文中的命令均未运行。
许可
转载指南及本页中文说明采用发布者标明的 GPL-3.0。原文未改写,中文说明为编辑新增;不提供保证。本页英文版的完整指南与许可正文可直接查阅,另保留发布者的完整 GPL 许可。