用途:用于处理任何技术问题,包括测试失败、生产缺陷、意外行为、性能问题、构建失败和集成问题。核心原则是必须先找到根因再尝试修复,症状修复视为失败。铁律:未完成第一阶段调查前不得提出修复方案。
主要能力:提供四阶段流程。第一阶段根因调查:仔细阅读错误信息与完整堆栈、稳定复现问题、检查近期变更(git diff、新依赖、配置、环境差异)、在多组件系统中各边界加诊断埋点并追踪数据流。第二阶段模式分析:寻找同类可运行示例、完整对照参考实现、列出工作与故障之间的所有差异、理解依赖与假设。第三阶段假设与验证:提出单一明确假设、做最小改动验证、每次只变一个变量、验证后再继续。第四阶段实施:先写失败测试用例,再实施单一根因修复,验证测试通过且未破坏其他测试。
使用方式:资料未提供具体安装或调用命令。该技能以文档形式组织,目录内附带支撑技术文档 root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md,并关联 solopowers-test-driven-development(用于写失败测试)和 solopowers-verification-before-completion(用于宣称成功前验证)。
适用场景:时间压力大、看似只需“快速一改”、已尝试多次修复、前次修复无效或尚未完全理解问题时尤其适用。
限制与提醒:若三次以上修复均失败,应停止并质疑架构,而非继续第四次修复。若系统化调查确认为环境、时序或外部原因,应记录调查内容、加入重试或超时处理并增加监控日志。资料中给出的实战对比数据(如 15-30 分钟对比 2-3 小时)属原文陈述,未提供独立验证说明。