用途:这是调试技能族中需要运行时观察时的默认入口,属于方法论层,回答何时从静态分析升级到运行时观察,以及如何收集、分析和依据运行时证据行动。它由 PDCA 宿主通过 frontmatter 依赖引用(前置检查后调用),把工具选择委托给 browser-debug-toolkit,把领域分析委托给 hybrid-debug。
适用信号:静态分析后根因置信度低;基于静态分析的修复已应用但问题依旧;调用链、参数、日志看似正常但运行时行为错误(指向平台/宿主拦截);需要加日志或断点观察;需要对比修复前后行为来验证修复。
主要能力:给出七阶段证据收集生命周期——升级决策、埋点设计(2–5 个针对假设的埋点,格式如 console.log('[DEBUG-auth-check]', { userId, hasToken: !!token, timestamp: Date.now() }))、复现指导(最小可复现、环境、非确定性说明)、证据分析(运行时观察>日志>代码推断>猜测的证据层级)、置信度门控、逃生舱(git bisect、网络检索、升级到 hybrid-debug 或 essence-diagnosis)、修复验证(前后对比、回归检查、Heisenbug 意识、清理埋点)。还列出常见误诊陷阱表与反模式。
使用方式与限制:AI 设计埋点并提供复现指导,但除非用户明确授权,用户需自行添加日志并运行复现,不得未经确认运行复现步骤。修复就绪门控要求三条同时满足:能用运行时证据填出根因句、已证伪至少一个替代假设、知道如何验证修复。低置信度时不得进入修复。详细框架条目与埋点模板见 reference.md。具体收费、价格、平台支持等信息暂未提供。