diagnosing-bugs SKILL.md skillA
diagnosing-bugs from vinvcn/mattpocock-skills-zh-cn is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add vinvcn/mattpocock-skills-zh-cn/diagnosing-bugs@git:20261008.5be0dc1Pins git:20261008.5be0dc1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- vinvcn/mattpocock-skills-zh-cn
- Path
skills/engineering/diagnosing-bugs/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261008.5be0dc1, committed Oct 8, 2026
- First version recorded
- Jul 4, 2026
- Size
- 8,508 bytes
- Repository stars
- 5,110
- License
- MIT
面向棘手缺陷和性能回退的诊断循环。适用于用户说 “diagnose” / “debug this”，或报告某些东西 broken、throwing、failing、slow 时。.
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
# 诊断缺陷 面向棘手 bugs 的纪律。只有在明确说明理由时才跳过阶段。 探索 codebase 时，先读取 `GLOSSARY.md`（如果存在），建立相关 modules 的清晰 mental model，并检查你将触碰区域的 ADRs。 ## 脱敏 这个 skill 会要求你展示 commands、outputs 和捕获的 artifacts。**先 redact 掉每个 secret**：用 `<REDACTED>` 替换。Build loops 要针对 env vars 进行，让 credential 留在 environment 里而不是你展示的内容中。捕获的 artifacts 带有 auth headers：只引用携带 signal 的那些行。 如果 redact 后的 output 不足以诊断 bug，就说明情况并询问用户。 ## Phase 1 - 构建 feedback loop **这就是这个 skill 的核心。** 其他所有内容都是机械步骤。如果你拥有一个针对该 bug 的 **tight** pass/fail signal，即它会在 _这个_ bug 上变红，你就能找到原因；bisection、hypothesis-testing 和 instrumentation 都只是消费这个 signal。没有它，盯着代码看多久都救不了你。 在这里投入不成比例的精力。**要强硬、要有创造力、拒绝放弃。** ### 构建 loop 的方式 - 大致按以下顺序尝试 1. **Failing test**，放在能触达 bug 的 seam 上：unit、integration、e2e 都可以。 2. **Curl / HTTP script**，打到运行中的 dev server。 3. **CLI invocation**，使用 fixture input，并把 stdout 与 known-good snapshot diff。 4. **Headless browser script**（Playwright / Puppeteer），驱动 UI，并断言 DOM/console/network。 5. **Replay a captured trace.** 把真实 network request / payload / event log 保存到磁盘，并在隔离环境中 replay 到代码路径。 6. **Throwaway harness.** 启动系统的最小子集（一个 service、mocked deps），用一次 function call 触发 bug code path。 …
Read the whole file at its exact version.
How to install
mdr add vinvcn/mattpocock-skills-zh-cn/diagnosing-bugs@sha256:78c753c8565286abThe line at the top of this page pins the label git:20261008.5be0dc1, 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_fap5crzrspe6ua57)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 4, 2026 and Oct 8, 2026, about one every 24 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261008.5be0dc1 latest | 2026-10-08 | 5be0dc1 | 8,508 B | A | view · diff |
| git:20261008.f659bb3 | 2026-10-08 | f659bb3 | 8,543 B | A | view · diff |
| git:20260921.49ef591 | 2026-09-21 | 49ef591 | 8,545 B | A | view · diff |
| git:20260811.b46e155 | 2026-08-11 | b46e155 | 8,880 B | A | view · diff |
| git:20260704.c71ad54 | 2026-07-04 | c71ad54 | 8,426 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 (8508 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
vinvcn/mattpocock-skills-zh-cn · 5,110 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fap5crzrspe6ua57 GET https://markdownregistry.com/api/v1/resolve?ref=vinvcn/mattpocock-skills-zh-cn/diagnosing-bugs GET https://markdownregistry.com/api/v1/blob/78c753c8565286abfe7647fa75b85d7562396ba4744dc55c358a6c7dfddf801e
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 vinvcn/mattpocock-skills-zh-cn
Every file in vinvcn/mattpocock-skills-zh-cn