用途:这是一套调试纪律规范,强调“反馈回路优先、先根因后修复、修复后扫描影响范围”。核心主张是:没有可复现回路就不提假设,没有根因就不改代码,没有影响范围扫描就不算修完。
主要能力:提供十级“回路构建阶梯”,按回路紧密度排序,从失败的自动化测试、带断言的 curl/HTTP 请求、CLI 快照 diff、无头浏览器脚本、trace 回放、一次性 harness、属性/模糊测试、git bisect run、新旧差分到人工介入,逐级尝试并在首个可用处停止。回路需满足可红、确定性、快速、可无人运行四项完成标准。
使用方式:分四阶段。阶段一收集日志与堆栈、查 git 历史、构建复现信号、做变体扫描与复现最小化;阶段二阅读失败点周边代码、查近期改动、找同类反模式、识别机制;阶段三先写出 3-5 个带置信度的排序假设再测试,达到 80 分以上才进入修复;阶段四按 RED(先失败的回归测试)、GREEN(最小修复)、影响范围扫描、验证、预防建议、清理的顺序执行。
LSP 用法:用转到定义追踪取值来源,用查找引用获取全部调用者,用转到类型定义检查类型是否允许失败值,用悬停查看失败点类型与签名。
适用场景:状态机缺陷、竞态条件、数据损坏、性能退化、集成契约不匹配等,可参考 references/root-cause-playbooks.md 与 references/investigation-hygiene.md。
限制:资料未提供安装命令、平台支持、收费与价格信息。若确实无法构建回路,应返回 BLOCKED 并说明尝试过的每一级及失败原因、以及解除阻塞所需的具体条件,不得进入假设阶段。