systematic-debugging

Diagnose software bugs through a four-phase root cause investigation workflow.

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill systematic-debugging-maopujie10-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/software-development/systematic-debugging
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill systematic-debugging-maopujie10-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Random fixes and guess-and-check patching waste hours and introduce new bugs. This Skill enforces a disciplined debugging process that finds the root cause before any fix is attempted, preventing symptom-only patches and repeated failed fix attempts. ## Core Features & Use Cases - Four-Phase Process: Root cause investigation, pattern analysis, hypothesis testing, and verified implementation, each with explicit completion criteria. - Tight Feedback Loops: Builds fast, deterministic reproduction commands (failing tests, curl scripts, headless browser checks, bisection harnesses) that go red on the exact symptom and green when fixed. - Rule of Three: After three failed fixes, the process stops and questions the underlying architecture instead of attempting a fourth patch. - Use Case: A flaky integration test fails intermittently in CI. The Skill guides you to raise the reproduction rate, trace data flow across components, form ranked hypotheses, and land a single regression-tested fix. ## Quick Start Use the systematic-debugging skill to investigate why the login endpoint returns a 500 error before proposing any fix.

Frequently Asked Questions about systematic-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a bug systematically instead of guessing?

Follow the four phases: first investigate the root cause by reading errors fully and building a reproduction loop, then analyze patterns against working code, then test ranked hypotheses one variable at a time, and finally implement a single fix verified by a regression test.

How to reproduce a flaky test that fails intermittently?

Raise the reproduction rate by running the trigger repeatedly, parallelizing execution, adding stress, or narrowing timing windows. A 50% flake is debuggable while a 1% flake usually is not, so prioritize loop reliability over immediate fixing.

What should I do after multiple fix attempts fail?

Stop after three failed fixes and question the architecture rather than attempting a fourth patch. Repeated failures where each fix reveals new coupling elsewhere indicate an architectural problem that needs discussion, not another symptom patch.

Can systematic debugging be used under time pressure or emergencies?

Yes, the process is designed especially for emergencies because systematic investigation is faster than guess-and-check thrashing. Skipping root cause analysis under pressure guarantees rework and new bugs.

When should I not skip the root cause investigation phase?

Never skip it, even for simple-seeming bugs or when a fix looks obvious. Simple bugs have root causes too, and proposing fixes before completing Phase 1 violates the core rule of the process.