systematic-debugging SKILL.md skillA
systematic-debugging from huangwb8/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add huangwb8/skills/systematic-debugging@git:20260906.d2681a7Pins git:20260906.d2681a7 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- huangwb8/skills
- Path
skills/alpha/awesome-code/agents/systematic-debugging/SKILL.md- Versions recorded
- 4
- Latest version
- git:20260906.d2681a7, committed Sep 6, 2026
- First version recorded
- Aug 25, 2026
- Size
- 13,216 bytes
- Repository stars
- 50
- License
- MIT
用于遇到缺陷、测试失败或异常行为，且必须在提出修复方案前调查根因的场景。未经根因分析不得只修复表象。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Systematic Debugging - 系统化调试 ## 铁律 ``` NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST ``` **违反规则的信件就是违反规则的精神。** **无例外**： - 不跳过根因调查直接修复 - 不基于猜测进行修复 - 不尝试多个更改同时测试 - 不在不完全理解的情况下修复 --- ## 常见合理化 | 借口 | 现实 | |------|------| | "快速修复现在，稍后调查" | 永不会有"稍后"。技术债积累 | | "尝试改变 X，看是否有效" | 猜测不是调试。可能碰巧修复但未理解 | | "添加多个更改，运行测试" | 无法确定哪个更改有效。浪费调试时间 | | "可能大概差不多是 X" | 模糊理解导致错误修复 | | "不完全理解但可能有效" | 理解不完全=修复不完整 | --- ## 红色标志 - 停止并重新开始 - "快速修复现在，稍后调查" - "尝试改变 X，看是否有效" - "添加多个更改，运行测试" - "可能大概差不多是 X，让我修复" - "不完全理解但可能有效" - 基于猜测而非证据的修复 **所有这些意味着：停止修复。回到根因调查阶段。** --- ## 四阶段框架 ### 阶段 1：根因调查 **任何修复前**： 1. **仔细阅读错误消息** - 不要跳过错误或警告 - 它们通常包含确切解决方案 2. **一致复现** - 你能可靠触发吗？ 3. **检查最近变更** - 什么变更可能导致此问题？ 4. **多组件系统收集证据** ```bash # 对于每个组件边界： - 记录进入组件的数据 - 记录退出组件的数据 - 验证环境/配置传播 - 检查每层状态 运行一次以收集显示何处中断的证据 然后分析证据以识别失败组件 然后调查该特定组件 ``` 5. **追踪数据流** - 向后追踪到坏值起源 ### 阶段 2：模式分析 1. **找到工作示例** 2. **与参考对比** 3. **识别差异** 4. **理解依赖** ### 阶段 3：假设与测试 1. **形成单一假设**："我认为 X 是根本原因，因为 Y" 2. **最小化测试**：进行最小可能更改 3. **验证后再继续** 4. **3+ 次修复失败时：质疑架构** ### 阶段 4：实现 1. **创建失败测试用例** 2. **实施单一修复**：只改验证该假设所需的最小范围 3. **验证修复**：一次只验证一个假设，不把多个修复混在同一次验证里 4. **收敛范围**：避免顺手重构、无关格式化或新增未证明必要的抽象 …
Read the whole file at its exact version.
How to install
mdr add huangwb8/skills/systematic-debugging@sha256:32d6ab7468de9eb7The line at the top of this page pins the label git:20260906.d2681a7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_wktjeg2jvxi3wtg5)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Aug 25, 2026 and Sep 6, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260906.d2681a7 latest | 2026-09-06 | d2681a7 | 13,216 B | A | view · diff |
| git:20260905.a346b91 | 2026-09-05 | a346b91 | 13,311 B | A | view · diff |
| git:20260905.7c0ea7c | 2026-09-05 | 7c0ea7c | 13,272 B | A | view · diff |
| git:20260825.4f192d9 | 2026-08-25 | 4f192d9 | 12,272 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (13216 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
huangwb8/skills · 50 stars · license MIT · pushed 2026-11-01 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_wktjeg2jvxi3wtg5 GET https://markdownregistry.com/api/v1/resolve?ref=huangwb8/skills/systematic-debugging GET https://markdownregistry.com/api/v1/blob/32d6ab7468de9eb7d136907b87658fbc7564ed4232491a8a446608b78d0ebccc
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.