用途:当出现 bug、错误、异常、崩溃、结果错误、测试失败(单元/集成/端到端)、间歇性或时序相关失败、性能问题(变慢、内存泄漏、高 CPU)、集成失败(API、数据库、外部服务)时使用。不适用于显而易见的修复、功能请求或架构规划。
主要能力:提供基于证据的系统化调试流程,分为四个阶段:收集证据(完整阅读报错与堆栈、稳定复现、检查近期改动如 git diff 与 git log --since="yesterday"、加日志追踪数据流);隔离变量与模式分析(寻找可工作的相似代码、逐行对比差异、理解依赖与假设);提出并测试假设(一次只验证一个具体假设,做最小改动);实施修复(先写失败测试,再针对根因做单一修复,验证测试通过且无新错误)。
使用方式:会话开始时创建“Collect Evidence”待办并标记进行中,按阶段推进并更新待办;假设被证伪时新增“Iterate”任务并形成新假设;若根因明显可跳到“Verify Fix”,但仍需创建失败测试。连续 3 次修复失败应停止并升级,可能意味着架构问题。
限制:资料未提供具体安装命令、平台支持、收费或价格信息。该技能依赖 outfitter:maintain-tasks 技能进行阶段跟踪;正式事故调查需 RCA 文档时应改用 find-root-causes 技能。禁止在未理解根因前提出修复方案,禁止同时测试多个假设,禁止只修症状。