用途:为调试复杂问题提供结构化流程,避免随机猜测,确保先真正理解问题再动手修复。源自 obra/superpowers,资料中未提供平台、收费或安装命令等信息。
主要能力(四阶段流程): 一、复现:修复前先可靠复现问题,记录复现步骤、预期与实际的差异,并标注复现率(总是100%、经常50-90%、有时10-50%、罕见低于10%)。 二、隔离:缩小来源范围,可用问题包括:何时开始出现、最近改动了什么、是否在所有环境都出现、能否用最小代码复现、触发问题的最小改动是什么。 三、理解:寻找根因而非只消除症状,资料提供“5个为什么”逐层追问至根因的方法。 四、修复与验证:确认问题不再复现、相关功能仍正常、未引入新问题、并添加测试防止回归。
使用方式:按检查清单推进。开始前确认能稳定复现、有最小复现案例、理解预期行为;调查中查看近期改动(git log)、日志、必要时加日志、使用调试器或断点;修复后记录根因、验证修复、添加回归测试、检查相似代码。资料给出的常用命令包括:git log --oneline -20、git diff HEAD~5、grep -r "errorPattern" --include="*.ts"、pm2 logs app-name --err --lines 100,使用时保持原样。
适用场景:定位疑难缺陷、回归问题与难以复现的故障。
限制与反模式:避免随机改动、忽略证据、未经证实的假设、未复现就盲目修复、停留在症状层面。资料未说明具体支持的平台、工具集成、价格与安装方式。