用途:在评判现有方案或提出“新”方案前,先追溯其历史脉络,理解当前做法为何形成、曾替代过什么,以及过去失败尝试的具体原因。
主要能力:包含四类追溯技术。决策考古:查找决策记录(docs/decisions/、docs/adr/、.decisions/)、对话历史、git log --all --full-history -- path/to/file 等记录,整理方案采用时间、原因、替代对象和驱动背景。失败尝试分析:针对“试过但不行”的说法,梳理当时约束、具体失败点、根因及如今环境是否变化。复兴检测:识别新方案是否有历史前身(如微服务与SOA、GraphQL与SOAP),区分真正创新与重新包装。范式转变映射:记录从旧范式到新范式的思维变化、得失与教训。
使用方式:当出现“这过于复杂”“为什么不直接……”“这是现代做法”“我们应该换成X”等信号时触发追溯。可搜索决策记录、会话历史、git 历史(如 git log --grep)、issue/PR 讨论和团队记忆。提出变更时按模板记录当前方案沿革、以往尝试与决策理由。
适用场景:技术选型替换、评判旧模式、实施新想法、定义最佳实践,以及重构或架构迁移前。
限制:资料未提供具体安装命令、平台支持或自动化程度;其输出依赖团队是否留存决策记录、对话与提交历史,历史缺失时追溯能力受限。忽略历史仅当上下文根本改变、原有约束消失或原推理被证伪,并应记录越过的理由。