Agent Skills
返回列表
Bug 根因定位与修复助手

Bug 根因定位与修复助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ffcaaae9/bugfix-root-cause-copilot。

技能介绍

解决什么问题

当 stack trace、测试失败、线上回归或功能异常出现时,常见困难不是“看不到错误”,而是证据分散、猜测过多、修复面过大。这个技能把调试过程约束成可执行路径:先确认复现边界,再给出带证据的根因,最后落到最小改动和验证清单,避免把局部修复变成新一轮回归。

技能如何工作

  • 输入要求:优先使用错误信息、复现步骤、相关代码路径和约束;缺关键信息时最多问 3 个聚焦问题,再基于合理假设继续。
  • 定位策略:先排除高概率问题,如空值、类型、边界、状态同步、时序、配置,并要求给出证据链,而不是罗列“可能原因”。
  • 修复边界:优先最小可行改动,明确改动文件/逻辑、为什么不会扩大影响,以及是否需要回滚。
  • 验证闭环:输出手测步骤和最小必要自动化用例,把“修好了”变成可检查的清单。

适用边界

它适合已有较明确报错或异常现象的工程调试,尤其适合需要快速收敛结论的场景;不适合纯性能容量评估、架构重构或没有可观察错误的开放式探索。若证据不足,它会标注假设和待确认项,而不是直接给出破坏性建议。

使用场景

  • 排查线上 API 返回 500 但日志只有一行异常,定位空值或依赖初始化问题。
  • 测试失败提示越界或状态不同步,确认复现条件并给出最小改动修复。
  • 收到功能异常反馈,约束不能改接口,需要输出修复点和手动验证清单。
  • 代码评审前需要说明为何某次修复不会扩散影响,并补充最小测试用例。

适合人员

  • 负责线上事故复盘的后端工程师:快速把零散日志整理成带证据链的根因结论。
  • 需要在约束内改代码的前端工程师:不能改接口或数据结构,给出最小修复和验证。
  • 接手旧模块并处理回归缺陷的全栈工程师:确认时序或状态同步问题,补最小用例。
  • 在发布前验收功能的测试工程师:把失败现象转成手测清单和待确认假设。