↑

系统化问题定位v1.0.0

systematic-debugging3 KB

当用户报告软件故障、测试失败或性能退化时,用可复现证据逐层定位根因,再给出带风险说明的最小修复建议与验证方案。只指导分析,不直接改动系统。

0 0 0 0 更新于 2026-10-28 19:06

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 面向软件故障排查场景,帮助用户从杂乱的症状报告中抽丝剥茧,建立可复现的问题边界,再沿组件边界逐段收集证据。它会引导你区分「已确认事实」与「尚未验证假设」,提出可证伪的根因候选,最终输出影响范围可控的修复建议——包含风险、回滚方式和明确的验证步骤。全程只分析不操刀,避免在证据不足时给出看似确定的修复方案。

技能包含

  • SKILL.md(本文件):技能主说明,含六步分析流程、输出格式与约束
  • THIRD-PARTY-NOTICES.md:第三方声明

核心能力

  • 现象结构化:把用户描述的故障转化为「观察/推测分离、时间/范围/环境齐全」的标准化记录
  • 最小复现设计:优先用最少步骤复现问题;无法复现时,明确列出还缺什么证据,不凭空补齐
  • 边界逐段排查:跨组件场景下,沿输入→输出→配置→错误信息逐段核对,定位问题最早出现点
  • 可证伪根因分析:提出少量候选原因,给出各自的证据、反证和最小区分检查,避免同时改动多个变量
  • 受控修复建议:只处理有证据支持的根因,说明影响范围、风险、回滚方式;无证据时仅给下一步诊断
  • 分级验证框架:区分建议、模拟验证、本机验证、集成验证和线上验证,明确未覆盖范围

应用场景

用户怎么说本技能做什么
"线上服务偶发 502,重启就好了"引导记录发生时间、频率、影响范围,设计对照实验区分「重启治愈」与「流量/依赖波动」,定位最早异常组件
"这个接口响应从 200ms 变成 5s"要求提供基线数据、变更时间、依赖链路耗时,逐段核对网络/数据库/缓存/代码变更,排除相关性假象
"测试在 CI 里随机失败,本地跑没问题"收集 CI 环境版本、并发配置、种子数据差异,建立最小复现条件,区分环境差异与竞态条件
"报错看起来是连接超时,是不是要加连接池?"不直接认同熟悉错误,要求提供超时发生位置、连接数监控、服务端日志,确认是池不足、网络抖动还是服务端慢
"用户说数据丢了,紧急恢复要多久?"先确认「丢数据」是观察还是推测,收集操作时间线、备份状态、日志完整性,再评估恢复方案风险,不直接建议删库重建