用途:在提出任何修复前,先对 Bug、测试失败和异常行为进行根因分析。适用于测试失败、生产或开发环境 Bug、意外行为、性能问题、构建失败和集成问题。即使问题看似简单、时间紧迫或修复方案显而易见,也不应跳过。
主要能力与流程:
- 根因调查:仔细阅读错误信息、堆栈、行号和错误码;确定可稳定复现的步骤,不可复现时先收集更多数据;检查近期变更(git diff、提交、新依赖、配置与环境差异);在多组件系统中于各边界添加诊断日志,定位失败发生的位置;沿调用栈反向追踪异常值来源,从源头而非症状处修复。
- 模式分析:在同一代码库中寻找可工作的相似示例;实现某模式时完整阅读参考实现;列出正常与异常代码之间的所有差异;理解代码所需的组件、设置、配置与环境。
- 假设与测试:一次只提出一个明确假设,说明“我认为 X 是根因,因为 Y”;做最小改动验证,一次只改一个变量;假设错误则重新提出,不叠加修复;承认未知,不假装理解。
- 实施:修复根因而非症状;一次只做一处改动,不顺手重构;运行相关测试验证问题解决且无回归;若 3 次以上修复失败,应停止并考虑架构问题,与用户讨论。
执行模型:主智能体直接运行该技能,因为调试需要同一上下文中的迭代调查;跨独立子系统的多组件问题,可通过 dispatch-parallel-agents 技能按子系统分派调查。
规则:未完成调查不得提出修复;一次只验证一个假设;修复须有调查证据支持;3 次失败后升级讨论;不得用增大超时作为修复;完整阅读错误信息。
限制:资料未提供具体安装命令、平台支持、收费方式或效果数据。