systematic-debugging

systematic-debugging is a skill for Claude Code, Codex from yinqd3/workbuddy-skills. It costs 64 tokens per session (877 once invoked), scanned A, original, MIT.

A step-by-step debugging guide that starts by finding the root cause before suggesting a fix. It covers reproducing the problem, examining recent changes, tracing data, testing hypotheses, and checking for regressions.

In plain words
What is it for?
Use it for test failures, production bugs, performance problems, build failures, and integration issues. It helps gather evidence, compare working examples, test explanations, and verify the final repair.
Why use it?
It reduces guesswork and symptom-only fixes by requiring evidence about where and why a failure occurs.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/yinqd3/workbuddy-skills/systematic-debugging
Any agent
npx skills add yinqd3/workbuddy-skills --skill systematic-debugging
Clone the repo
git clone --depth 1 https://github.com/yinqd3/workbuddy-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for systematic-debugging

README.md
[![agentmods](https://agentmods.dev/badge/skills/yinqd3/workbuddy-skills/systematic-debugging.svg)](https://agentmods.dev/skills/yinqd3/workbuddy-skills/systematic-debugging)
Your own site
<a href="https://agentmods.dev/skills/yinqd3/workbuddy-skills/systematic-debugging"><img src="https://agentmods.dev/badge/skills/yinqd3/workbuddy-skills/systematic-debugging.svg" alt="Measured on agentmods" height="20"></a>
Per session 64 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 877 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00064 $0.00877
Opus 5 $0.00032 $0.00439
Sonnet 5 $0.00013 $0.00175
Haiku 4.5 $0.00006 $0.00088

Measured 5d ago against content hash f104819d820f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

systematic-debugging scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

superpowers/systematic-debugging/SKILL.md · 110 lines

What it actually says

系统化调试

核心原则

总是先找到根因再尝试修复。 症状修复 = 失败。随机修复浪费时间并制造新 bug。

铁律

没有根因调查 = 没有修复

没完成阶段 1,不能提修复方案。

何时使用

任何技术问题:

  • 测试失败
  • 生产 Bug
  • 意外行为
  • 性能问题
  • 构建失败
  • 集成问题

尤其在以下情况必须使用:

  • 时间紧迫时(紧急情况最容易想猜)
  • "就改一下"看起来很明显
  • 已经试过多次修复
  • 上次修复没起作用
  • 你不完全理解这个问题

四阶段调试法

必须完成每个阶段再进入下个阶段。

阶段 1:根因调查

在尝试任何修复之前:

  1. 仔细读错误信息

    • 不要跳过错误或警告
    • 完整读堆栈跟踪
    • 注意行号、文件路径、错误码
  2. 稳定复现

    • 能可靠触发吗?
    • 精确步骤是什么?
    • 每次都发生吗?
    • 如果不能复现 → 收集更多数据,不要猜
  3. 检查最近的变更

    • 什么改变可能导致这个?
    • git diff、最近的提交
    • 新依赖、配置变更
    • 环境差异
  4. 多组件系统的证据收集

    在每个组件边界:
      - 记录什么数据进入
      - 记录什么数据出来
      - 验证配置/环境传播
    跑一次看哪里断了,然后再深入那层
    
  5. 追踪数据流

    • 错误值的起源在哪里?
    • 谁用错误值调用了这个?
    • 向上追踪调用栈直到找到源头
    • 在源头修复,不在症状处修复

阶段 2:模式分析

找到模式再修复:

  1. 在代码库中找类似的工作示例
  2. 完整对照参考——不要略读
  3. 列出工作与失败之间的每个差异
  4. 理解所有依赖和假设

阶段 3:假设+检验

  1. 形成一个清晰的假设:"我认为 X 是根因,因为 Y"
  2. 明确写下来
  3. 设计最小测试来证明/否定它
  4. 跑测试
  5. 如果被否定 → 形成新假设,重复
  6. 如果被证明 → 进入修复

阶段 4:修复+验证

  1. 在根因处修复,不在症状处
  2. 写一个能捕获这个 bug 的测试
  3. 验证修复有效
  4. 验证无回归(全量测试套件)
  5. 清晰提交信息,解释根因

反模式

  • "试试这个" — 没有根因的随机修复
  • "大概是 X" — 没有证据的猜测
  • "快速补丁" — 症状修复,根因还在
  • 一次改多个东西 — 无法知道哪个起效
  • 跳过复现 — 调试一个不能稳定触发的问题
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 110 lines · 64 tokens per session scan A f104819d820f

Subscribe to this mod's changes

systematic-debugging is a skill published in the GitHub repository yinqd3/workbuddy-skills (6 stars, last pushed 3mo ago), licensed MIT. It adds 64 tokens to every session and 877 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

results-report

This skill should be used when the user asks to "write an experiment report", "summarize experimental results", "do experiment retrospection", "write a results report", "写实验总结报告", "写实验复盘", or mentions turning completed experiment artifacts into a structured, decision-oriented research report. It assumes strict…

Galaxy-Dawn/claude-scholar · 78 tokens

research-brainstorm-from-kb

Explores and structures research ideas into obsidian-vault/ideas/ notes using the local paper knowledge base and frontier techniques. Use when the user provides research questions or ideas and wants decomposed candidate directions, related-work analysis based primarily on obsidian-vault/analysis, and cross-domain…

RipeMangoBox/BITE · 99 tokens

domain-fork

Migrates BITE's architecture to a new professional domain (e.g. frontend development, accounting, journalism). Interactive session with the user to map research concepts to domain equivalents, then generates a complete set of adapted skills and folder structure. Explicit trigger only.

RipeMangoBox/BITE · 55 tokens

papers-batch-analyze

Batch-analyzes papers from a user-provided CSV or obsidian-vault/paperlist.csv by splitting the list into safe per-batch CSVs, spawning parallel worker agents, writing analysis notes under obsidian-vault/analysis/, and refreshing obsidian-vault/index/ after all completed batches. Use when the user asks to analyze many…

RipeMangoBox/BITE · 97 tokens

papers-collect-from-github-repo

Collects paper candidates from any GitHub repository README or docs — awesome lists, survey companion repos, lab paper lists, conference accepted-paper repos, benchmark leaderboards, etc. Agent fetches the README (or specified doc), analyzes its format, writes a one-off parser, and outputs rows aligned with…

RipeMangoBox/BITE · 90 tokens

code-context-paper-retrieval

Retrieves code-context-relevant papers from the local knowledge base in two modes (brief/deep), using obsidian-vault/analysis/ as the primary retrieval source and obsidian-vault/paperPDFs/ for optional deeper reading. obsidian-vault/index/ is optional and mainly serves statistics, Obsidian navigation, and backlink…

RipeMangoBox/BITE · 108 tokens