systematic-debugging SKILL.md skillA
systematic-debugging from jnmetacode/superpowers-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jnmetacode/superpowers-zh/systematic-debugging@v1.0.0Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jnmetacode/superpowers-zh
- Path
skills/systematic-debugging/SKILL.md- Versions recorded
- 5
- Latest version
- v1.0.0, committed Oct 17, 2026
- First version recorded
- Mar 20, 2026
- Size
- 9,462 bytes
- Repository stars
- 8,348
- License
- MIT
遇到任何 bug、测试失败或异常行为时使用，在提出修复方案之前执行.
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
# 系统化调试
## 概述
**核心原则：** 在尝试修复之前，务必先找到根本原因。只修症状就是失败。
**敷衍走流程等于违背调试的精神。**
## 铁律
```
不做根因调查，不许提修复方案
```
如果你还没完成第一阶段，就不能提出修复方案。
## 何时使用
用于任何技术问题：
- 测试失败
- 生产环境 bug
- 异常行为
- 性能问题
- 构建失败
- 集成问题
**尤其在以下情况必须使用：**
- 时间紧迫（紧急情况最容易让人猜测式修复）
- 觉得"一个小修改"就能搞定
- 已经尝试了多种修复
- 上一次修复没有生效
- 你没有完全理解问题
**以下情况也不要跳过：**
- 问题看起来很简单（简单的 bug 也有根本原因）
- 你很赶时间（越急越容易返工）
- 领导要求立刻修好（系统化调试比反复尝试更快）
## 四个阶段
你必须完成每个阶段后才能进入下一个。
### 第一阶段：根因调查
**在尝试任何修复之前：**
1. **仔细阅读错误信息**
- 不要跳过错误或警告
- 它们往往直接包含解决方案
- 完整阅读堆栈跟踪
- 记下行号、文件路径、错误码
2. **稳定复现**
- 你能可靠地触发它吗？
- 具体的复现步骤是什么？
- 每次都能复现吗？
- 如果无法复现 → 收集更多数据，不要猜测
3. **检查近期变更**
- 什么变更可能导致了这个问题？
- git diff、最近的提交
- 新依赖、配置变更
- 环境差异
4. **在多组件系统中收集证据**
**当系统有多个组件时（CI → 构建 → 签名，API → 服务 → 数据库）：**
**在提出修复方案之前，先添加诊断埋点：**
```
对每个组件边界：
- 记录进入组件的数据
- 记录离开组件的数据
- 验证环境/配置的传递
- 检查每一层的状态
执行一次以收集证据，确定断裂点在哪里
然后分析证据，定位故障组件
然后针对该组件深入调查
```
**示例（多层系统）：**
```bash
# 第 1 层：工作流
echo "=== Secrets available in workflow: ==="
echo "IDENTITY: $([ -n "${IDENTITY:-}" ] && echo SET || echo UNSET)"
# 第 2 层：构建脚本
echo "=== Env vars in build script: ==="
…Read the whole file at its exact version.
How to install
mdr add jnmetacode/superpowers-zh/systematic-debugging@sha256:e77967d15305cb33The line at the top of this page pins the label v1.0.0, 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_pa4tfwq7hv4vccgi)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Mar 20, 2026 and Oct 17, 2026, about one every 53 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0.0 latest | 2026-10-17 | 98b4290 | 9,462 B | A | view · diff |
| v1.0.0 | 2026-09-06 | ee2bb93 | 9,397 B | A | view · diff |
| v1.0.0 | 2026-08-07 | 02d2551 | 9,421 B | A | view · diff |
| v1.0.0 | 2026-06-16 | 952fc29 | 9,866 B | A | view · diff |
| git:20260320.80bc100 | 2026-03-20 | 80bc100 | 9,794 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 (9462 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
jnmetacode/superpowers-zh · 8,348 stars · license MIT · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_pa4tfwq7hv4vccgi GET https://markdownregistry.com/api/v1/resolve?ref=jnmetacode/superpowers-zh/systematic-debugging GET https://markdownregistry.com/api/v1/blob/e77967d15305cb33f93cfaff065c1908e22707e6d78164b4d89c00d9fde0232d
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.
More from jnmetacode/superpowers-zh
Every file in jnmetacode/superpowers-zh