诊断错误

工程开发 社区

技能解读

当前原文的自动摘译,尚未人工审校。

编辑

该技能可以让您显示命令、输出和捕获的工件。首先编辑每个秘密:在其位置写入 <REDACTED>。针对环境变量构建循环,以便凭证保留在环境中,而不是您显示的内容中。捕获的工件带有 auth 标头:仅引用携带信号的行。如果经过编辑的输出不足以诊断错误,请说明并询问用户。

大致按以下顺序构建一个方法

任何接缝处的测试失败都会导致错误:单元、集成、e2e。针对正在运行的开发服务器的 Curl / HTTP 脚本。使用固定输入进行 CLI 调用,将标准输出与已知良好的快照进行比较。无头浏览器脚本(Playwright / Puppeteer)驱动 UI 并在 DOM/控制台/网络上进行断言。重播捕获的跟踪。将真实的网络请求/负载/事件日志保存到磁盘;通过隔离的代码路径重播它。

拉紧环

将循环视为产品。一旦你有了_a_循环,就收紧它:我可以让它更快吗? (缓存设置,跳过无关的init,缩小测试范围。)我可以让信号更清晰吗? (断言特定症状,而不是“没有崩溃”。)我可以使其更具确定性吗? (固定时间、种子 RNG、隔离文件系统、冻结网络。)30 秒的片状循环仅比没有循环好一点; 2 秒的确定性是严格的,具有调试超能力。

不确定性错误

目标不是干净的复制,而是更高的复制率。将触发器循环 100 倍、并行化、增加压力、缩小计时窗口、注入睡眠。 50% 的错误是可调试的; 1% 则不然,因此请继续提高速率,直到可以调试为止。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@mattpocock · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一阶段:建立反馈循环

这就是技巧。其他一切都是机械的。如果您对该错误有严格的通过/失败信号(在_this_错误上变红的信号),您将找到原因;二分法、假设检验和仪器仪表都只会消耗它。如果你没有,再多的盯着代码也救不了你。在这里花费不成比例的努力。要有侵略性。要有创意。拒绝放弃。

02
第 2 阶段:再现 + 最小化

运行循环。当错误出现时,观察它变红。确认:[ ] 循环产生用户描述的故障模式,而不是附近恰好发生的不同故障。错误的错误=错误的修复。 [ ] 故障可以在多次运行中重现(或者,对于非确定性错误,可以以足够高的速率重现以进行调试)。 [ ] 您已经捕获了确切的症状(错误消息、错误输出、缓慢的计时),因此后续阶段可以验证修复是否确实解决了该问题。

03
第三阶段:假设

在测试任何假设之前,先生成 3-5 个排名假设。 单一假设的生成基于第一个看似合理的想法。

04
第四阶段:仪器

每个探针必须映射到第 3 阶段的特定预测。一次更改一个变量。工具首选项:调试器/REPL 检查(如果环境支持)。一个断点胜过十个日志。在区分假设的边界处有针对性的记录。永远不要“记录所有内容并 grep”。

05
第五阶段:修复+回归测试

在修复之前编写回归测试,但前提是有正确的接缝。正确的接缝是测试在调用站点发生的真实错误模式的测试。如果唯一可用的接缝太浅(当错误需要多个调用者时进行单调用者测试,无法复制触发错误的链的单元测试),则那里的回归测试会给出错误的置信度。如果不存在正确的接缝,那么这本身就是发现的结果。注意它。代码库架构正在防止错误被锁定。将其标记为下一阶段。

06
第六阶段:清理

声明完成之前需要: [ ] 原始重现不再重现(重新运行第 1 阶段循环) [ ] 回归测试通过(或记录了无缝的缺失) [ ] 删除了所有`[DEBUG-...]` 工具(`grep` 前缀) [ ] 删除了一次性原型(或移动到明确标记的调试位置)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。