你在 vibe coding 的时候，有没有遇到过这样的情况？

让 agent 帮你写一个功能，结果在手动验证时发现了 Bug。你让 agent 去修，却发现它好像怎么修都修不好。有时候，你甚至还得手动复制错误信息或相关代码发给 agent。一来一回，不仅麻烦，也很影响正常的开发进度。

特别是在使用一些能力不算前沿的模型时，遇到这种情况的概率往往会更高。

所以，我写了这样一个 skill：debug-log-first。

它是怎么排查问题的

如果项目中已经有日志、完整报错、堆栈或其他运行证据，它会优先读取这些内容，再根据证据排查问题，而不是一上来就凭猜测修改代码。

如果现有证据不足，它才会在尽量精简、不影响原有功能的前提下，补充最小必要的诊断日志，帮助 agent 定位 Bug，也方便后续维护项目。

它会要求 agent 先确认真实现象、复现原始问题，再沿着日志和数据流寻找最早出现异常的位置。每轮只验证一个可能原因，避免同时修改多个地方，最后连哪个改动真正生效都说不清楚。

前沿模型模型为什么也需要它

对于能力相对有限的模型，这个 skill 可以提供一套更稳定的排查流程，减少盲目猜测和反复修改。

对于能力较强的前沿模型，它同样有价值。模型有时也会因为幻觉、上下文过长或过早下结论，导致排查方向失效。debug-log-first 主要提升的不是模型的能力上限，而是排障结果的质量下限，让模型在复杂问题中也尽量按照证据一步步定位原因。

具体的使用流程和文件都已经放在 GitHub 上，可以通过下面的链接查看：

debug-log-first

既然已经看到文章末尾了，不妨帮我的仓库点个 Star，也可以关注我。后续我会继续给大家分享一些自己长期使用、真正解决过问题的 skills。