systematic-debugging

Identify root causes of bugs through a four-stage systematic process.

1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/xxih/ai-harness-zh --skill systematic-debugging-xxih
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/xxih/ai-harness-zh/tree/main/references/translations/superpowers/skills/systematic-debugging
Command: npx skills add https://github.com/xxih/ai-harness-zh --skill systematic-debugging-xxih

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps engineers avoid premature fixes by enforcing a disciplined, evidence‑driven process for bugs, test failures, and unexpected behavior.

Core Features & Use Cases

  • Four‑stage workflow: root‑cause investigation, pattern analysis, hypothesis testing, and fix implementation.
  • Evidence collection: guides logging, environment checks, and component boundary tracing.
  • Risk reduction: prevents guesswork, limits regression, and flags when architectural changes are needed.
  • Applicable scenarios: CI failures, runtime crashes, performance regressions, integration issues, and flaky tests.

Quick Start

Use the systematic debugging skill to analyze the bug, gather evidence, and receive a step‑by‑step root‑cause investigation plan.

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 a bug before attempting a fix?

To find the root cause of a bug, follow a systematic investigation process that collects evidence through logging and environment checks before proposing fixes. This prevents premature guesses and ensures thorough validation.

What is the best way to debug CI failures and flaky tests systematically?

Debugging CI failures and flaky tests systematically involves a four-stage process: root-cause investigation, pattern analysis, hypothesis testing, and fix implementation. This enforces evidence collection and limits regression risk.

How do I investigate runtime crashes and performance regressions without causing regressions?

Investigating runtime crashes and performance regressions requires evidence-driven analysis at component boundaries. By testing hypotheses before implementing fixes, you minimize guesswork and prevent introducing new regressions.

When should I use a systematic debugging process for software testing?

Use a systematic debugging process for software testing when facing unexpected behavior, integration issues, or CI failures. It is essential when you need to enforce pattern analysis and validate fixes to reduce regression risk.

Why does guessing fixes lead to regression risk in software debugging?

Guessing fixes during software debugging leads to regression risk because it bypasses evidence collection and hypothesis testing. A disciplined, four-stage root-cause investigation ensures fixes are validated and thoroughly targeted.

Does systematic debugging work for integration issues and unexpected behavior?

Yes, systematic debugging works for integration issues and unexpected behavior by tracing component boundaries and analyzing patterns. It guides structured evidence collection to identify root causes accurately across various scenarios.