SKILL

systematic-debugging

在修改代码之前找出缺陷的根本原因:构建紧凑且能复现失败的反馈循环,在组件边界收集证据,对可证伪的假设排序,然后一次性修复并用回归测试证明。适用于任何测试失败、生产缺陷、异常行为、性能回归或构建失败——尤其是在时间紧迫或某次修复未奏效之后。不适用于探索性的“让它更好”式重构,也不适用于原因已被证实、已知的机械性改动。

机器翻译
查看英文原文

Find a bug's root cause before changing code: build a tight red-capable feedback loop, gather evidence at component boundaries, rank falsifiable hypotheses, then fix once and prove it with a regression test. Use for any test failure, production bug, unexpected behavior, performance regression or build failure — especially under time pressure or after a fix that did not work. Not for exploratory "make it nicer" refactors, and not for a known mechanical change with an already-proven cause.

适用对象:软件开发与测试。自动收录 · 待核查。

原作者说明节选

从固定版本的 SKILL.md 提取,保留原文语言。以下内容属于作者说明,本站尚未验证安装、兼容或运行结果。

查看英文原文

原文涵盖的主题

  • Systematic Debugging
  • Overview
  • The Iron Law
  • The Feedback Loop Rule
  • When to Use
  • The Four Phases
  • Phase 1: Root Cause Investigation
  • 1. Read Error Messages Carefully

Random fixes waste time and create new bugs. Quick patches mask underlying issues. Core principle: ALWAYS find root cause before attempting fixes. Symptom fixes are failure. Violating the letter of this process is violating the spirit of debugging. Method adapted from the public superpowers debugging flow (MIT); the feedback-loop rule, ranked falsifiable hypotheses, and rule-of-three escalation were extended here. If you haven't completed Phase 1, you cannot propose fixes. The feedback loop is the debugging work. Before reading code to build a theory, create or identify a tight command that can go red on the user's exact symptom and green when the bug is fixed. A tight loop is fast, deterministic, agent-runnable, and specific enough to catch this bug — not merely "doesn't crash". When a clean repro is hard, spend disproportionate effort building the loop. Guessing without a red-capable loop is the failure mode this skill exists to prevent. Use for ANY technical issue: Test failures Bugs in production Unexpected behavior Performance problems Build failures Integration issues Use this ESPECIALLY when: Under time pressure (emergencies make guessing tempting) "Just one quick fix" seems

这里只展示节选,请以完整原文和当前要求为准。

来源仓库
wxxb789/hoa
源文件
skills/systematic-debugging/SKILL.md
固定版本
beb1eca66d8fed7c3942dc3ef50990bf37837706
阅读完整原作者说明 ↗

准备条件

  • 本条仅收录原作者的技能元数据;请阅读完整说明,确认依赖、许可与使用条件。

第一件可以尝试的小事

先阅读原作者说明,再决定是否在自己的 AI 工具中使用。

对应 AI 工具说明

作者有说明不等于本站实机验证。没有证据时,不自动标为兼容、安全或免费。

来源与内容状态

本条为自动发现的元数据,尚未完成人工文档核查;适用性与运行结果待核查。

原作者:wxxb789/hoa · 原作者仓库元数据。文档核查:未核查。最近来源检查:2026-11-09T20:02:15.496Z。

分类由名称、说明与路径规则生成,分类不代表已核实适配。

许可与权利归属

MIT。第三方内容及版权归原作者,使用条件以原文为准。

许可原文 ↗

本站没有因同步、复制或用户自报成功而将资源标为运行验证通过。

限制与注意事项

  • 元数据收录不代表本站已经安装、适配、实测或进行安全审查。