Agent Skills
返回列表
Bug侦探:堆栈回溯到修复 PR

Bug侦探:堆栈回溯到修复 PR

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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