systematic-debug SKILL.md skillA
systematic-debug from skymanbp/cc-enforcer is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add skymanbp/cc-enforcer/systematic-debug@git:20260924.632ab6bPins git:20260924.632ab6b in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- skymanbp/cc-enforcer
- Path
skills/systematic-debug/SKILL.md- Versions recorded
- 6
- Latest version
- git:20260924.632ab6b, committed Sep 24, 2026
- First version recorded
- Apr 27, 2026
- Size
- 11,103 bytes
- Repository stars
- 6
- License
- MIT
在 debug / 修 bug / 异常排查 / "为什么不工作" 等语境下自动唤起。强制 agent 先走完根因分析的 7 问与 5 步骤，禁止直接给出反应式修补。当用户描述：bug、错误、stack trace、异常行为、"为什么 X 失败"、"为什么 Y 不工作"、"修一下这个"、"测试不过"、"500 报错"、"突然就坏了" 等情形时使用。.
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-debug — 系统式 debug 流程 > 你（主代理）已被本 skill 接管。在解决用户描述的问题前，**必须**按以下流程进行根因分析。 > 这个 skill 是 [`rules/02-systematic-not-reactive.md`](rules/02-systematic-not-reactive.md) 与 [`rules/03-root-cause.md`](rules/03-root-cause.md) 的强制执行入口。 ## 强制流程（按顺序执行，不允许跳步） ### Step 0 · 构建可复现信号（feedback loop） > **这是本 skill 最核心的一步。** 借鉴 `mattpocock-skills:diagnose` 的 Phase-1 原则： > "If you have a fast, deterministic, agent-runnable pass/fail signal for the bug, you will find the cause." > 没有可复现信号，后续 Step 3 / Step 4 的"假设 → 证伪"全是空中楼阁——你只能凭印象写"应该是 X"。 > > **未建立可复现信号前，禁止进入 Step 3。** 反复试图绕开 Step 0 跳到 Step 3 是本 skill 的高频违规。 **0.1 · 选一种 loop 形态（按优先级试 10 种）** 按下面顺序尝试，先选满足"快 + 确定 + agent 可跑"三条的最高优先级： 1. **Failing test** —— 在合适的层（unit / integration / e2e）写一个最小测试，断言 bug 行为。最佳。 2. **Curl / HTTP script** —— 对运行中的 dev server 发请求，把响应跟期望 diff。 3. **CLI invocation + snapshot diff** —— 用 fixture 输入跑 CLI，跟已知正确输出 byte-diff。 4. **Headless browser 脚本** —— Playwright / Puppeteer 驱动 UI，断言 DOM / console / network。 5. **Replay captured trace** —— 把真实 request / payload / event log 存盘，在隔离环境里重放。 6. **Throwaway harness** —— 起一个最小子集（单 service + mocked deps），单函数调用触发 bug 路径。 …
Read the whole file at its exact version.
How to install
mdr add skymanbp/cc-enforcer/systematic-debug@sha256:23c1235b06dfe561The line at the top of this page pins the label git:20260924.632ab6b, 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_n2en7aw3d2sddxkr)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Apr 27, 2026 and Sep 24, 2026, about one every 30 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260924.632ab6b latest | 2026-09-24 | 632ab6b | 11,103 B | A | view · diff |
| git:20260812.131c150 | 2026-08-12 | 131c150 | 11,144 B | A | view · diff |
| git:20260811.3486c2c | 2026-08-11 | 3486c2c | 10,044 B | A | view · diff |
| git:20260513.78d9709 | 2026-05-13 | 78d9709 | 9,914 B | A | view · diff |
| git:20260429.0b91de7 | 2026-04-29 | 0b91de7 | 5,596 B | A | view · diff |
| git:20260427.163c5ca | 2026-04-27 | 163c5ca | 4,300 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 (11103 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
skymanbp/cc-enforcer · 6 stars · license MIT · pushed 2026-11-04 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_n2en7aw3d2sddxkr GET https://markdownregistry.com/api/v1/resolve?ref=skymanbp/cc-enforcer/systematic-debug GET https://markdownregistry.com/api/v1/blob/23c1235b06dfe561c1fb0b71ea4413f17e345a38150746e9a8ad43d4005a9dd8
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.