SuperAPI AI 工具集

investigate-bug-report

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:把一份 Bug 报告诊断到根因。该技能明确只诊断、不修复,交付物是带证据的根因结论;只有在用户随后要求时才应用修复。

主要步骤与能力:一、锁定报告,从报告中提取观察到的行为、期望行为、触发步骤或输入、相关环境/版本,仅追问缺失且阻塞的信息,标准是能用一句话说出“给定 X 时做 Y,但应为 Z”。二、复现;无法复现时静态追踪,优先真实复现(运行失败命令、最小脚本、收紧现有测试),当需要外部服务或仅生产数据而无法复现时,从报告暗示的入口静态追踪代码路径,并说明诊断基于追踪。三、隔离根因,从症状沿数据回溯到状态或逻辑首次偏离意图之处,区分根因与报错暴露位置,可用 git log/git blame 查看可疑代码的近期变更作为佐证;标准是一个具体位置(file:line)与机制能解释报告中的每个症状,只能解释部分症状的属于巧合发现,需继续追查或明确说明缺口。四、评估影响面,用 Grep 查找命中同一缺陷的其他调用方/输入,并在缺陷会写入状态时指出可能已被污染的数据,标准是每个调用方都被归类为受影响/不受影响。五、提出 1–3 个修复候选方案及取舍(最小补丁与正规重构对比,推荐项在前),并给出本应捕获该问题的回归测试。六、报告:一句话问题陈述、根因与证据(file:line、复现输出或追踪)、影响面、修复候选,未验证内容需标明,并停止,除非用户要求否则不修改代码。

限制与失败模式:无法复现且追踪显示代码符合规格时,应连同证据报告该发现,“按设计工作”或“环境特定”是有效结论;出现多个独立缺陷时分别报告,不合并叙述;追踪遇到不可见代码(外部服务、二进制依赖)时,报告所追踪到的边界以及需要何种插桩来确认。该技能的安装命令、价格与平台等信息暂未提供。