用途:为调试提供系统化流程,核心原则是先找到根因再动手修复,症状式修补视为失败。适用于缺陷、测试失败或异常行为原因不明显,或多次修复尝试失败时。
主要能力与流程: 第一阶段根因调查:在尝试任何修复前,完整阅读错误信息与堆栈跟踪,记录行号、文件路径、错误码,不跳过警告;稳定复现问题,若无法复现则收集更多数据而非猜测;检查近期变更,如 git diff、提交、新依赖、配置与环境差异;在多组件系统中(如 CI→构建→签名、API→服务→数据库)先加诊断埋点,记录每个组件边界的数据进出、验证环境与配置传递、检查各层状态,运行一次收集证据后分析并定位失败组件;沿调用链向上追溯坏值来源,在源头修复。 第二阶段模式分析:寻找代码库中可用的相似示例,完整阅读参考实现而非略读,列出所有差异,理解组件、配置、环境与假设等依赖。 第三阶段假设与验证:提出单一具体假设,做最小改动、一次只变一个变量,验证成功则进入第四阶段,失败则提出新假设而非叠加修复;不知道就明说。 第四阶段实现:先创建失败测试用例(可配合 test-driven-development 技能),一次只做一处修改,不做顺带改进,验证修复且其他测试仍通过。
升级机制:若修复尝试达到 3 次以上仍失败,且每次修复暴露新问题、需要大规模重构、共享状态与耦合反复出现,应停止并质疑基本设计,与人类伙伴讨论后再继续。
限制与提醒:资料未提供安装命令、平台支持、收费或价格信息。技能附带参考文件 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md,以及相关技能 test-driven-development、verification-before-completion。