systematic-debugging

Investigate technical issues through a four-phase root cause analysis process.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill prevents wasted time and new bugs by ensuring that the root cause of any technical issue is identified and addressed before any fixes are implemented. It combats the tendency to apply quick patches that only mask symptoms.

Core Features & Use Cases

  • Structured Investigation: Guides users through a mandatory four-phase process: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
  • Pressure Resistance: Includes explicit rules and anti-patterns to prevent shortcuts, especially under time pressure or when a quick fix seems obvious.
  • Use Case: When a test fails or a bug appears in production, use this Skill to systematically trace the issue back to its origin, ensuring a permanent fix rather than a temporary workaround.

Quick Start

Use the systematic-debugging skill to investigate any unexpected behavior or bug you encounter.

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 instead of just fixing the symptoms?

A systematic debugging methodology enforces a four-phase process—investigation, pattern analysis, hypothesis testing, and implementation—to trace issues back to their origin. This prevents wasted time and new bugs by ensuring the root cause is addressed before any fixes are implemented.

What is the best way to debug production bugs under time pressure?

Debugging production bugs under time pressure requires explicit rules to prevent shortcuts and common rationalizations. A structured methodology enforces rigorous investigation and hypothesis testing, ensuring a permanent fix rather than a temporary workaround even when a quick patch seems obvious.

How do I systematically troubleshoot test failures?

Troubleshooting test failures systematically involves moving through pattern identification and hypothesis testing before implementation. This structured process ensures you verify the root cause of the failure before applying changes, preventing new bugs from incorrect patches.

Why should I use a structured debugging process instead of patching an obvious fix?

A structured debugging process prevents wasted time and new bugs by combating the tendency to apply quick patches. It ensures the root cause of any technical issue is fully investigated and addressed, guaranteeing a permanent fix rather than a temporary workaround.

Can I use this systematic debugging methodology for performance problems?

Yes, this systematic debugging methodology addresses performance problems by enforcing a rigorous investigative process. It guides you through pattern analysis and hypothesis testing to find the root cause of performance issues before implementing any fixes.