systematic-debugging

Identify and resolve software defects through a four-phase root cause analysis framework.

Updated Jul 13, 2026
One-click install
npx skills add https://github.com/zangjeicy/Hermes --skill systematic-debugging-zangjeicy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/zangjeicy/Hermes/tree/main/skills/software-development/systematic-debugging
Command: npx skills add https://github.com/zangjeicy/Hermes --skill systematic-debugging-zangjeicy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the cycle of guessing and quick-patching that leads to recurring bugs and technical debt by enforcing a rigorous, evidence-based debugging process.

Core Features & Use Cases

  • Root Cause Investigation: Provides a structured 4-phase framework to ensure the underlying issue is identified before any code is changed.
  • Tight Feedback Loops: Guides the creation of deterministic, automated reproduction scripts to validate symptoms and verify fixes.
  • Use Case: When a production service experiences intermittent failures, this skill directs the agent to build a high-repetition test harness to isolate the failure, trace the data flow, and implement a permanent fix rather than applying a temporary workaround.

Quick Start

Use the systematic-debugging skill to investigate the failing test case in the current repository by following the four-phase process.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
What is root cause analysis in software debugging?

Root cause analysis in software debugging is identifying the underlying defect before modifying code. This skill systematizes the process through a four-phase framework that enforces evidence-based hypothesis testing to ensure architectural integrity.

How do I fix intermittent production bugs without guessing?

To fix intermittent production bugs without guessing, you build deterministic reproduction loops that validate symptoms. This skill directs the creation of high-repetition test harnesses to isolate failures and trace data flow for permanent fixes.

How do I troubleshoot performance regressions systematically?

To troubleshoot performance regressions systematically, you follow a four-phase root cause analysis framework. This process requires constructing deterministic reproduction scripts and applying evidence-based hypothesis testing to resolve defects.

What is the best way to stop recurring bugs and technical debt?

The best way to stop recurring bugs and technical debt is to replace quick-patching with an evidence-based debugging process. This skill enforces rigorous root cause identification through automated reproduction loops before any code changes.

Can I use systematic debugging for failing test cases in my repository?

Yes, you can use systematic debugging for failing test cases by following the four-phase process. The skill guides the construction of deterministic, automated reproduction scripts to validate symptoms and verify fixes within the current repository.

When should I not use a quick patch for software defects?

You should not use a quick patch for software defects when facing test failures or production bugs, as it leads to recurring issues. Instead, apply a structured root cause analysis framework to ensure a permanent fix.