systematic-debugging

Identifies and fixes root causes of bugs via a four-phase debugging workflow.

968|43|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/GanyuanRan/Aegis --skill systematic-debugging-ganyuanran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/GanyuanRan/Aegis/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/GanyuanRan/Aegis --skill systematic-debugging-ganyuanran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic Debugging provides a canonical, phase-driven workflow to uncover root causes before applying fixes, reducing symptom-only patches and speeding up reliable software repair.

Core Features & Use Cases

  • Phase 1: Root Cause Investigation
  • Phase 2: Pattern Analysis
  • Phase 3: Hypothesis and Testing
  • Phase 4: Implementation and Dual-Track Closure
  • Defense-in-depth and Quality Gate checks to prevent regressions and ensure robust repairs.

Quick Start

Read the overview, then follow Phase 1 through Phase 4 to diagnose and fix bugs by identifying root causes first.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I identify the root cause of flaky integration tests instead of patching symptoms?

Root cause debugging enforces a phase-based workflow starting with explicit diagnostics and pattern analysis to uncover the true source of flaky integration failures before applying fixes.

What is the best way to systematically debug unit test failures under time pressure?

Systematic debugging uses a four-phase workflow requiring explicit diagnostics and canonical owners to reliably resolve unit test failures under time pressure without symptom-only patches.

How do I prevent regressions when fixing complex software bugs?

Prevent regressions by applying defense-in-depth validations and quality gate checks during the implementation phase to ensure robust repairs and dual-track closure of complex bugs.

Can I use a phase-based debugging workflow for both unit tests and integration failures?

Yes, phase-based debugging applies to unit tests, integration failures, and flaky behavior by enforcing hypothesis testing and pattern analysis across all testing scopes.

Why does my bug fix keep causing new issues in other parts of the system?

Symptom-only patches cause new issues because they skip root cause investigation; applying a phase-driven workflow with canonical owners ensures the actual source is fixed.

When should I not use a symptom fix for a bug?

Avoid symptom fixes whenever dealing with flaky behavior or integration failures, and instead require explicit diagnostics and pattern analysis to identify the root cause first.