troubleshoot SKILL.md skillA
troubleshoot from john-walks-slow/rabbit-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add john-walks-slow/rabbit-skills/troubleshoot@git:20261102.ccdf8fePins git:20261102.ccdf8fe in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- john-walks-slow/rabbit-skills
- Path
.apm/skills/troubleshoot/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261102.ccdf8fe, committed Nov 2, 2026
- First version recorded
- Nov 2, 2026
- Size
- 2,283 bytes
- Repository stars
- 27
- License
- none declared
根因分析。在软件工程类项目中，排查复杂、难解问题时必须遵守此流程分析原因。.
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
# troubleshoot
作为主工程师完成问题的根因分析。
你的目标是输出准确、可执行的诊断结论，为后续修复提供可靠依据。
遵守以下工作流程：
## 1. 根因分析
仔细阅读日志和代码。你的分析应该能够完美解释用户看到的全部现象。
**当且仅当你对于根因的确信度大于85%（也就是说，你的判断中猜测的成分已经很少）时，才输出诊断结论。**
### 1.5 如果无法确定根因？
如果感到问题较难分析，不要假装你已经明白了原因然后盲目修复，那只会让问题扩大！
你可以用以下方式辅助分析：
- **（推荐用于复杂问题）** 构造测试用例 / e2e 测试完整复现问题场景来捕捉问题。不通过的测试用例在本问题解决时应该通过，作为回归测试的验收标准。
- 添加详细调测日志，请求用户实机复现，通过日志准确捕捉问题。
- 对于无法稳定复现的小概率问题，通过 mock 等方式主动构造，找出问题出现的条件。
## 2. 输出诊断结论
明确输出以下内容：
1. **根因**：问题的根本原因。
2. **现象与根因的关联**：解释用户看到的全部现象。
3. **修复路径**：选择最恰当的修复路径，附理由。
4. **置信度**：你对该修改能够达成预期的确信度。
5. **验收标准**
### 2A. 单点修复
如果问题为单点问题，建议精准修复路径。
### 2B. 重构型修复
如果本问题属于更大范围的设计问题，最优雅的解决方法不是"贴狗皮膏药"而是改进设计（这在长远来看大有好处）。
向用户提出你的重构建议！询问用户是否进行重构型修复。
诊断结论及修复方向输出到 `/docs/issues/yymmdd-{issue_name}/yymmdd-{issue_name}.troubleshoot.md`。
**备注:**
如果你连续多次分析都未能达成确信，意味着当前思路不可靠或缺乏关键线索，继续试错只会引入更多不确定性。请清空既有思路从零梳理，并更积极地采用 1.5 所述方法。Read the whole file at its exact version.
How to install
mdr add john-walks-slow/rabbit-skills/troubleshoot@sha256:92cb95a6472051d9The line at the top of this page pins the label git:20261102.ccdf8fe, 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_d5p2cbdgttekjug6)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Nov 2, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261102.ccdf8fe latest | 2026-11-02 | ccdf8fe | 2,283 B | A | view · diff |
| git:20261102.ccba1f9 | 2026-11-02 | ccba1f9 | 2,331 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 (2283 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
john-walks-slow/rabbit-skills · 27 stars · license none declared · pushed 2026-11-02 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_d5p2cbdgttekjug6 GET https://markdownregistry.com/api/v1/resolve?ref=john-walks-slow/rabbit-skills/troubleshoot GET https://markdownregistry.com/api/v1/blob/92cb95a6472051d99526a0a42d7eb0552d2507881303ff37103e5ae9524ea566
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 john-walks-slow/rabbit-skills
Every file in john-walks-slow/rabbit-skills