systematic-debugging

Trace bugs and test failures to their root cause before proposing fixes.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/51hhh/BU03 --skill systematic-debugging-51hhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/51hhh/BU03/tree/main/.github/skills/systematic-debugging
Command: npx skills add https://github.com/51hhh/BU03 --skill systematic-debugging-51hhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It replaces guesswork with a disciplined debugging workflow so bugs, flaky tests, and unexpected behavior are resolved at the source instead of patched by symptoms.

Core Features & Use Cases

  • Root-cause-first investigation for bugs, build failures, and production incidents.
  • Pattern comparison and single-hypothesis testing to avoid shotgun fixes.
  • Failing-test creation, verification, and architectural re-evaluation when repeated fixes fail.
  • Useful for time-sensitive outages, flaky CI, multi-service failures, and hard-to-reproduce issues.

Quick Start

Use the systematic-debugging skill to inspect the failure, reproduce it, trace the cause, and apply the smallest verified fix.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of flaky CI test failures?

Trace flaky CI test failures to their root cause by gathering evidence, comparing patterns, and testing a single explicit hypothesis before proposing a fix. This disciplined debugging workflow replaces guesswork with failing-test creation and verification to resolve the actual source.

What is the best way to debug multi-component production incidents?

Debug multi-component production incidents by inspecting the failure path, reproducing the issue, and tracing the root cause. Apply minimal testing and create a failing test to verify that the root cause is resolved before applying the smallest verified fix.

How does systematic debugging work for build failures and performance regressions?

Systematic debugging works by replacing shotgun fixes with pattern comparison and single-hypothesis testing. It diagnoses build failures and performance regressions by tracing each issue back to its root cause through evidence gathering before any fix is proposed.

Why do repeated bug fixes fail to resolve unexpected behavior?

Repeated bug fixes often fail because they patch symptoms instead of the root cause. When repeated fixes fail, this approach requires architectural re-evaluation and verification that the root cause is resolved through minimal testing and failing-test creation.

Can I use this debugging approach for hard-to-reproduce issues in multi-service systems?

Yes, this debugging approach suits hard-to-reproduce issues in multi-service systems where the failure path is unclear. It applies evidence gathering, pattern comparison, and single-hypothesis testing to resolve time-sensitive outages and multi-component failures at the source.