调试与错误恢复
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/debugging-and-error-recovery-lr-5drx。
技能介绍
先停下来,别再写新功能
代码改完测试挂了、构建红了、日志里冒出一条看不懂的堆栈——这些时刻的共同诱惑是:把失败推到一边,继续做手头的功能。本技能针对的就是这种「带病前进」的习惯。错误会叠加:第三步没修的 bug,会让第四到六步的产出全部建立在错误的前提上。
结构化分诊流程
技能的核心是一份按顺序执行的 triage 清单,适用于测试失败、构建错误、运行时缺陷、生产事故和日志报错:
- 先复现:让失败稳定发生。无法复现就无法有把握地修复
- 再定位:对照清单逐步排除假设,而不是猜测
- 修复并验证:确认根因修复后,回归相关用例
针对难以复现的 bug,清单提供分支策略:
时间相关:在日志中补时间戳、人工加入setTimeout延迟、在负载下运行环境相关:对比 Node/浏览器版本、环境变量、数据库是否为空状态相关:检查隐藏状态是否在操作间泄漏
适用边界
这份清单是通用调试框架,不绑定具体语言或框架,也不会替你自动改代码。它的价值在于强制你先收集证据再动手。对于性能问题、安全漏洞等需要专门方法论的领域,建议作为前置步骤,而不是完整方案。
使用场景
- 提交代码后测试套件变红,需要按分诊清单稳定复现失败并找到根因
- CI 构建突然中断,需要在合并前定位编译错误而不是盲目重试
- 生产日志出现运行时异常,需要系统化排查并安全恢复服务
- 收到 bug 报告但本地无法复现,需要按时间、环境、状态分支定位问题
适合人员
- 需要快速定位测试失败和构建错误的后端与前端工程师
- 负责生产事故排查和日志告警响应的 SRE 与运维工程师
- 需要将不稳定的偶发 bug 变成可复现问题的技术负责人
- 负责编写稳定测试和可靠 CI 流程的质量保证工程师