用途:这是一套调试方法论,适用于遇到任何技术问题、在提出修复方案之前使用,目标是避免随机修补掩盖真实问题,通过先定位根因再修复,减少新缺陷的产生。
主要能力:核心原则是“没有根因调查就不修复”。流程分为四个阶段。第一阶段根因调查:仔细阅读错误信息与完整堆栈,记录行号、文件路径、错误码;稳定复现问题并明确步骤,无法复现时继续收集数据而非猜测;检查 Git diff、近期提交、新依赖与配置变化等环境差异;在多组件系统(如 CI 到构建到签名、API 到服务到数据库)中,对每个组件边界记录进入与退出的数据,验证环境与配置传递,先运行一次以定位故障组件,再分析原因;可参考 references/root-cause-tracing.md 进行向后追溯,找到坏值来源并在源头修复。第二阶段模式分析:在同一代码库中寻找可工作的相似代码,完整阅读参考实现,列出工作版本与故障版本之间的全部差异,理解依赖、配置与环境假设。第三阶段假设与测试:提出单一假设并说明理由,做最小改动、一次只改一个变量,验证后再继续,若失败则提出新假设而非叠加修复。第四阶段实现:建立失败测试用例,实施单一修复,验证测试通过与无回归。若修复尝试达到 3 次以上仍失败,应停止并质疑架构,因为反复出现新共享状态、耦合或新症状通常意味着架构问题,需与用户讨论。
辅助技术:纵深防御,在入口、业务逻辑、环境守卫、调试埋点等各层做校验,使缺陷在结构上无法发生;基于条件的等待,用等待真实条件替代猜测时序的 sleep,例如使用 wait_for 轮询并设置超时。
限制与说明:该技能文档提供的是调试流程与思维规范,未提供具体编程语言绑定、安装方式或付费信息,相关细节暂未提供。验证方式为运行 python scripts/verify.py。