bug-debugging SKILL.md skillA
bug-debugging from lixiuxiu559/agentforge is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add lixiuxiu559/agentforge/bug-debugging@git:20260930.d24348cPins git:20260930.d24348c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- lixiuxiu559/agentforge
- Path
skills/bug-debugging/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260930.d24348c, committed Sep 30, 2026
- Size
- 7,945 bytes
- Repository stars
- 4
- License
- MIT
针对具体错误、失败测试、偶发异常或性能回归定位根因，并在用户确认修复方案后实施修复。适用于“排查这个 bug”“为什么这里失败”“修好这个异常”；不用于泛泛讲解报错含义、无具体症状的全仓找 bug 或仅评审 diff。.
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 调试与修复
把一个具体症状推进到有证据的原因、可审阅的方案，以及经用户同意并验证的修复。
```text
确认症状 → 复现或取证 → 验证根因 → 展示方案并等待同意
→ 实施修复 → 回归验证与清理
```
## 执行边界
- **修复前必须展示原因、证据、修复方案、影响与验证办法，等用户明确同意该方案后再实施。** “帮我修好”、紧急程度、沉默或调查子 agent 的建议，都不代表对尚未展示的方案的同意。
- 用户只要求诊断时，交付结论与建议；不把诊断自动扩展成修复。已有具体方案和明确批准时复用批准记录，不重复确认。
- 确认前可读代码、运行本地测试、分析日志，在临时目录或隔离副本中制作复现与做可撤销的实验；不把实验性补丁应用到用户工作区，不修改业务代码、持久配置或弱化测试来“试修”。若取证必须改动用户工作区或共享环境，先说明具体诊断操作并取得同意；诊断授权不等于修复批准。
- 委派给 `research` 或 `implementation-workflow` 时传递当前阶段与授权范围，不通过委派绕过确认点。部署、外发、生产写操作不随修复批准自动获得授权。
## 1. 确认症状与当前状态
读取项目指令、相关代码与测试及当前 Git 状态，保留用户已有改动。明确期望行为的依据、实际行为、触发输入、版本/环境、影响范围；已有信息直接复用，只追问阻止调查的缺口。
先确认这是用户报告的那个失败。构建失败、缺失依赖或无效测试命令应单独记录，不能当作目标 bug 的复现。期望行为存在产品歧义时，先明确约定，不能把个人偏好当缺陷。
简单问题可用一个复现和一个有依据的假设完成诊断；不为填流程强凑多个原因、多个子 agent 或长报告。
## 2. 建立复现或可核对的观测
优先复用失败测试、用户操作或现有脚本。记录实际执行的命令/操作、环境、输入和关键输出；断言应能区分期望行为与该症状，不能只检查“没报错”。读代码以构造复现是允许的。
按需缩小输入和执行路径，每次缩减后重跑，并保留原始场景；缩减到足以区分原因即可，不要求证明全局最小。复杂复现、偶发异常、性能回归及仅人工可见的症状，按需读 `references/reproduction-strategies.md`。
无法复现时继续利用已有日志、调用链和环境差异取证，明确缺失信号；不得伪造失败命令或把一次通过当作不存在缺陷。调查受阻时交付已知事实、已排除项及最有区分力的下一项取证需求，不用猜测填满结论。
## 3. 用实验验证原因
从症状沿数据或控制流向上追踪：输入与状态在哪里首次偏离约定，什么触发条件使偏差传到用户可见结果。堆栈末端的报错位置不一定是原因。
…Read the whole file at its exact version.
How to install
mdr add lixiuxiu559/agentforge/bug-debugging@sha256:c3991b3217eafab6The line at the top of this page pins the label git:20260930.d24348c, 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_6q6iw6cm3fvcghdq)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Sep 30, 2026.
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 (7945 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
lixiuxiu559/agentforge · 4 stars · license MIT · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_6q6iw6cm3fvcghdq GET https://markdownregistry.com/api/v1/resolve?ref=lixiuxiu559/agentforge/bug-debugging GET https://markdownregistry.com/api/v1/blob/c3991b3217eafab6d98af14a0b47deb8c01d4994c76b02e9ea9493dae4f95956
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.