用途:定位所报告故障的根因,并在获得授权时验证修复;否则返回可复现证据、剩余不确定性和缺失的访问权限。适用于缺陷、失败测试、构建失败、性能回退及异常行为。
主要能力:读取相关规格、公共接口、近期变更与已配置检查,区分预期行为与当前代码行为;通过真实失败路径运行症状专属复现器,记录预期与实际差异并最小化复现;定位最早偏离点,对比正常路径与近期代码、配置、依赖或环境变化;提出可证伪假设,一次只测一个变量,用受控干预或独立观察验证预测;保留失败回归测试或可运行复现器,应用最小修复并重跑原场景与配置检查。
使用方式:输入为报告症状、预期行为、受影响环境和可用证据,以及仅诊断或诊断加修复的范围。无明确修复授权时,只诊断并提出修复方案,不实际应用。按调查类型加载参考:跨层失败或来源不明用 references/tracing.md;间歇、时序或并发失败用 references/intermittent-failures.md;性能回退用 references/performance.md;工具、环境或流程摩擦用 friction-log.md。使用项目工具加载凭据,诊断只记录脱敏信号或设置/未设置状态。
限制:直接修复请求仅授权狭窄的本地修复,不授权跟踪器写入、PR、合并、部署、生产插桩或实时数据变更。针对共享、托管或付费系统的实验及破坏性本地重置需调用方明确授权;优先使用隔离夹具并保护共享服务与数据。现有生产读取权限不授权新的生产探测或写入。自动化无法触发故障时,保留复现器并说明验证限制。未解决的根因标记为假设,不得把合理理论称为已验证根因,也不得把未验证修复称为已完成修复。
完成时返回:症状、范围、复现器、支持或否定根因的观察、提出或已应用的修复、失败/通过证据、检查项及剩余不确定性,并说明结果是已诊断、已修复并验证,还是因指定证据受阻。