Bug侦探:堆栈回溯到修复 PR
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_531be29f/dev-bug-detective。
技能介绍
生产里最难啃的那类 bug
很多故障并不是「看一眼日志就知道」:堆栈缺帧、只在特定机器复现、或者线上偶发且当时没打到关键日志。对工程师来说,真正痛苦的是第三种——你只有一段报错截图、半截 stderr,或同事转发的「又挂了」话术,却要在不试错乱改的前提下给出能合并的修复。
技能在做什么
这套流程把调试收敛成一棵 Bug 根因决策树,而不是「先改一改试试」。
- 输入:接受文本报错、日志片段;截图则通过 Read 读入再分析。
- 堆栈:若有
trace,从崩溃顶层帧往回追,找「异常开始」的那一帧,并结合当时变量值解释为何会走上这条路径。 - 日志:按时间线划分正常期 → 异常期 → 崩溃期,找状态恶化的拐点,并和同时间段其它异常做关联。
- 根因归类:区分 代码 Bug(逻辑/空指针/边界/并发)、配置、数据、外部依赖,对应给出代码 patch、配置修正、数据修复加防御、或容错方案——且修复要是可直接用的代码,不是「检查一下 XX」。
- 交付:写入
output/bug_report_{issue}.md,含原始材料、分类结论、diff 式前后代码,以及影响范围与验证方法。
边界与铁律
必须先定位根因再给修复;信息不够会明确列出「需要补充以下信息」。涉及数据修复时会提醒 先备份数据。它解决的是分析与可落地修复方案,不能替代你本地的复现环境与 Code Review。
使用场景
- 线上告警只有一段 Python traceback,需要在合并前给出可审查的修复 diff 与验证步骤
- 间歇性 500 配有前后 10 分钟应用日志,要找出状态从正常滑向失败的拐点并归类根因
- 截图里的前端或 CLI 报错没有完整堆栈,要先结构化复述错误再判断还缺哪些复现信息
- 判定为脏数据或配置漂移后,既要写数据/配置修正也要补防御性代码避免再次触发
适合人员
- 负责 on-call 的后端工程师,手里常是半截堆栈却要写出能进 PR 的具体改法
- 维护遗留服务的全栈开发,日志杂乱且依赖多,需要把偶发问题收敛成代码/配置/数据/外部四类之一
- 带 junior 排障的 tech lead,希望输出里强制包含根因、影响面与验证方法而不是模糊建议
- 开源维护者收到 issue 片段(日志+截图),要生成可附在回复里的结构化 bug report