◆
diagnosing-bugs:疑难 bug 诊断
定位
模型排查 bug 最常见的失败是:没复现就读代码猜原因,改一版不行再猜一版。这个 skill 把顺序固定下来:先有能判对错的信号,再谈假设。内容来自 mattpocock/skills(MIT),装 vft-kit 即可用。
模型自动触发:说「diagnose」「debug this」「排查这个 bug」「为什么报错 / 变慢」「修了两次还没好」都会走它。
六个阶段
- 造反馈回路:一条命令,能在这个 bug 上变红、修好后变绿,快、结果稳定、无人值守可跑。按优先级尝试:失败测试 → curl → CLI 输出比对快照 → 浏览器脚本 → 回放抓到的请求 → 最小 harness → 随机输入循环 →
git bisect run→ 新旧版本对比 → 最后才是人工配合脚本(scripts/hitl-loop.template.sh)。造不出来就停下说明,向你要环境、日志或抓包,不靠猜继续。 - 复现并最小化:确认红的是你描述的那个症状,再逐项删输入、配置、步骤,直到剩下的每一项都不可或缺。
- 列假设:一次列 3–5 个,每个写成「如果是 X,那么改 Y 会让 bug 消失」的可证伪形式,先给你看排序(不阻塞)。
- 插桩:每个探针对应一个假设,一次只改一个变量;调试日志带统一前缀(如
[DEBUG-a4f2]),收尾一条 grep 清干净。性能问题先测基线再二分。 - 修复 + 回归测试:有合适的测试切入点就先写失败测试再修;没有合适切入点本身就是结论,要记下来。
- 清理:原回路不再复现、回归测试通过、调试日志删净、正确的假设写进提交信息。
和上游的差异
- 上游让模型先读
GLOSSARY.md和 ADR;vft-kit 版改成先用 codegraph 查调用链和影响范围。 - 浏览器回路用宿主首选的浏览器工具(有 ego-browser 用它,否则 Playwright)。
踩坑
- 回路里的输出要先脱敏(token、Cookie 写成
<REDACTED>),凭据留在环境变量里。 - 改完 skill 要刷插件缓存并重启会话才生效,见 插件刷新。

留言板
0 条留言对话,从你开始
还没有留言。分享一个想法,或只是打声招呼。