◆

diagnosing-bugs:疑难 bug 诊断

2026-11-03 04:000

定位

模型排查 bug 最常见的失败是:没复现就读代码猜原因,改一版不行再猜一版。这个 skill 把顺序固定下来:先有能判对错的信号,再谈假设。内容来自 mattpocock/skills(MIT),装 vft-kit 即可用。

模型自动触发:说「diagnose」「debug this」「排查这个 bug」「为什么报错 / 变慢」「修了两次还没好」都会走它。

六个阶段

  1. 造反馈回路:一条命令,能在这个 bug 上变红、修好后变绿,快、结果稳定、无人值守可跑。按优先级尝试:失败测试 → curl → CLI 输出比对快照 → 浏览器脚本 → 回放抓到的请求 → 最小 harness → 随机输入循环 → git bisect run → 新旧版本对比 → 最后才是人工配合脚本(scripts/hitl-loop.template.sh)。造不出来就停下说明,向你要环境、日志或抓包,不靠猜继续。
  2. 复现并最小化:确认红的是你描述的那个症状,再逐项删输入、配置、步骤,直到剩下的每一项都不可或缺。
  3. 列假设:一次列 3–5 个,每个写成「如果是 X,那么改 Y 会让 bug 消失」的可证伪形式,先给你看排序(不阻塞)。
  4. 插桩:每个探针对应一个假设,一次只改一个变量;调试日志带统一前缀(如 [DEBUG-a4f2]),收尾一条 grep 清干净。性能问题先测基线再二分。
  5. 修复 + 回归测试:有合适的测试切入点就先写失败测试再修;没有合适切入点本身就是结论,要记下来。
  6. 清理:原回路不再复现、回归测试通过、调试日志删净、正确的假设写进提交信息。

和上游的差异

  • 上游让模型先读 GLOSSARY.md 和 ADR;vft-kit 版改成先用 codegraph 查调用链和影响范围。
  • 浏览器回路用宿主首选的浏览器工具(有 ego-browser 用它,否则 Playwright)。

踩坑

  • 回路里的输出要先脱敏(token、Cookie 写成 <REDACTED>),凭据留在环境变量里。
  • 改完 skill 要刷插件缓存并重启会话才生效,见 插件刷新。

留言板

0 条留言
Markdown
0 字
对话记录每个声音,都值得被看见

对话,从你开始

还没有留言。分享一个想法,或只是打声招呼。

PAGE LOAD / LIVEdiagnosing-bugs:疑难 bug 诊断加载中