用途:这是一个面向任何技术问题的系统化调试框架,用于 bug、测试失败(单元、集成、浏览器模式)、偶发失败测试(flaky test)、Vue 响应式问题、Dexie/IndexedDB 问题、构建失败和类型错误等场景。核心原则是:尝试修复前必须先找到根因,只治症状视为失败;其“铁律”为未完成第一阶段调查前不得提出修复。
主要能力与流程:框架分四阶段。第一阶段根因调查:仔细阅读完整错误信息与堆栈、稳定复现、检查近期改动(如 git diff HEAD~5 --stat、git log --oneline -10)、在多组件系统中逐层收集证据并追踪数据流。第二阶段模式分析:寻找可用的相似示例、对照参考、找出工作与失败之间的差异。第三阶段假设与验证:形成单一假设并记录,最小化改动逐项测试,未成功则提出新假设而非叠加修复。第四阶段实现:先写失败测试用例,实施单一根因修复,再验证(pnpm test、pnpm type-check、pnpm lint)。若修复连续失败三次应停止,质疑架构并与用户讨论。
使用方式与配套:文中给出复现测试命令,如 pnpm test src/features/workout/tests/specific.test.ts 和 pnpm test --reporter=verbose;数据库隔离用 beforeEach(async () => { await resetDatabase() }) 先行重置;Vue 响应式问题可用 nextTick 后检查 DOM。references/ 下含根因追踪、纵深防御、基于条件的等待等文档,scripts/ 下有 find-polluter.sh 用于定位污染测试。
适用场景与限制:尤其适合时间紧迫、看似“只差一个小修复”、已尝试多次修复或上次修复无效时,提醒回到第一阶段。该框架与 testing-conventions、vue-integration-testing、vitest-mocking、repository-pattern 等技能相关。资料未提供安装命令、收费、价格、支持平台或具体效果数据。