技能说明
适合多原因 Bug、跨模块故障和根因分析,覆盖逻辑、数据、状态、集成、资源、环境六类假设,以及证据分级、可信度判断和修复复验。技能提供调查框架,不会自动替代维护者修改代码或发布变更。
关于此技能
用多个竞争假设、并行取证和根因裁决来排查复杂故障,减少凭直觉锁定错误原因。
核心能力
六类假设框架
从逻辑、数据、状态、集成、资源和环境六个方向系统列出可能原因。
证据分级
区分直接证据、相关证据、口头描述和缺失证据,并以文件位置、日志或测试结果支撑判断。
根因裁决与复验
按可信度、证据数量和因果链比较假设,修复后复现原问题并覆盖相关边界情况。
适用场景
多原因 Bug 排查
当错误可能来自多个模块、配置或并发状态时,建立并行调查路径。
线上故障根因分析
把日志、提交、环境和资源表现放在同一证据框架中,避免只追逐最先出现的症状。
修复后的验证
确认修复确实对应根因,没有引入新问题,并补齐相关测试和边界案例。
使用步骤
- 01
第一步:列出竞争假设
按六类失败模式生成可证伪的假设,写清每个假设需要什么证据。
- 02
第二步:并行取证
分别检查代码、数据、状态、依赖、资源和环境,记录直接证据与相互矛盾的发现。
- 03
第三步:裁决并复验
比较可信度和因果链,选择主因或组合原因,实施修复后重跑复现和相关测试。
常见问题
是不是所有 Bug 都需要并行调查?+
不是。SKILL.md 适用于有多个合理根因、跨模块或初次排查未果的复杂问题;简单错误可以直接定位。
它会自动修改代码吗?+
不会。它主要提供调查和裁决流程;是否修改、如何修改以及如何发布应由维护者根据证据决定。
怎样判断根因可信?+
技能建议优先直接证据和清晰因果链,并标注高、中、低可信度;修复后还要验证原复现案例和相关边界。
安装前检查
把兼容性、来源和安装入口先看清楚,再放进自己的工作流。
兼容平台
Claude Code · Codex · Cursor
来源状态
已提供来源链接
安装方式
命令可直接复制
最近整理
2026/09/03
安装提醒:即使有清晰的来源和安装方式,也建议先阅读 SKILL.md,确认它会访问哪些文件和服务。
安装命令
npx skills add wshobson/agents --skill parallel-debugging -a claude-code -g适用平台与标签
Claude CodeCodexCursorOpenCodeAntigravity CLIGitHub Copilot兼容 Agent Skills#调试#根因分析#竞争假设#证据#故障排查