Parallel Debugging 是一个面向复杂问题调试的技能框架,其核心方法是将“竞争性假设分析”(ACH)与并行代理调查结合起来。它并不提供具体代码,而是给出一套结构化的调试流程,用于在根因不明确、存在多种可能解释时,系统性地收集证据并做出判断。
用途 该技能适用于以下情况:Bug 存在多个看似合理的根本原因;初步调试尝试未能定位问题;问题跨越多个模块或组件;需要带有证据的系统性根因分析;希望避免调试过程中的确认偏差。
主要能力
假设生成框架 技能要求围绕 6 类失败模式生成假设:
- 逻辑错误:条件逻辑错误(运算符错误、遗漏分支)、循环或数组访问中的差一错误、缺少边界情况处理、算法实现错误。
- 数据问题:无效或意外输入数据、类型不匹配或强制转换错误、应为值的地方出现 null/undefined/None、编码或序列化问题、数据截断或溢出。
- 状态问题:并发操作之间的竞态条件、缓存陈旧返回过期数据、初始化或默认值不正确、共享状态的意外变更、状态机转换错误。
- 集成失败:API 契约违背(请求/响应不匹配)、组件间版本不兼容、环境之间配置不匹配、缺失或错误的环境变量、网络超时或连接失败。
- 资源问题:内存泄漏导致逐渐退化、连接池耗尽、文件描述符或句柄泄漏、磁盘空间或配额超限、低效处理导致 CPU 饱和。
- 环境问题:缺少运行时依赖、库或框架版本错误、平台相关行为差异、权限或访问控制问题、时区或区域相关行为。
证据收集标准 证据类型分为:直接证据(强,例如某文件某行代码显示条件应为 x >= 0 而写成了 x > 0)、相关性证据(中,例如错误率在某提交后上升)、证言证据(弱,例如“在我机器上是好的”)、缺失证据(可变,例如代码路径中未发现空值检查)。引用格式要求始终使用 file:line,例如指出校验函数在 src/validators/user.ts:87 只检查 null/undefined 而不检查空字符串,导致空邮箱通过校验。
置信度标准 高(>80%):多个直接证据、清晰因果链、无矛盾证据。中(50-80%):部分直接证据、可信因果链、轻微模糊。低(<50%):多为相关性证据、因果链不完整、存在一些矛盾证据。
结果仲裁协议 所有调查者报告后: 第 1 步:将结果分类为已确认(高置信、强证据、清晰因果链)、可信(中置信、部分证据、合理因果链)、被推翻(证据与假设矛盾)、不确定(证据不足以确认或推翻)。 第 2 步:若有多个已确认假设,按置信度、支持证据数量、因果链强度、是否存在矛盾证据进行排序。 第 3 步:确定根因——若一个假设明显占优则宣布为根因;若多个假设可能性相当,可能是复合问题(多个促成原因);若没有假设被确认,则基于已收集证据生成新假设。 第 4 步:验证修复——在宣布 Bug 修复前,需确认:修复针对已识别的根因;修复未引入新问题;原始复现用例不再失败;相关边界情况已覆盖;相关测试已添加或更新。
使用方式 该技能以方法论和检查清单的形式使用:先按 6 类失败模式并行生成假设,再由不同调查路径分别收集带 file:line 引用的证据并给出置信度,最后按仲裁协议归类、排序并确定根因,再对修复进行四项验证。
适用场景 适合跨模块缺陷、多根因嫌疑的复杂 Bug、需要避免确认偏差的系统性根因分析。
限制 资料未提供该技能的具体实现代码、依赖要求、安装命令、支持的编程语言或运行平台,也未提供收费、价格或效果保证等信息,这些内容暂未提供。