systematic-debugging

Enforce root-cause analysis before code fixes using a four-phase debugging workflow.

146|35|Updated Mar 20, 2023
One-click install
npx skills add https://github.com/mwangli/stock-trading --skill systematic-debugging-mwangli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/mwangli/stock-trading/tree/main/.trae/skills/systematic-debugging
Command: npx skills add https://github.com/mwangli/stock-trading --skill systematic-debugging-mwangli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Random fixes waste time and create new issues. Systematic debugging ensures root causes are found before applying any fix, improving stability and time-to-resolution.

Core Features & Use Cases

  • Phase-driven workflow spanning Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
  • Comprehensive evidence gathering across components and logs to locate the true source of failures.
  • Safe fix practices including creating failing tests and validating fixes before declaring success.

Quick Start

Begin with Phase 1: reproduce the issue and collect diagnostic evidence, then progress through Phases 2–4 to implement a root-cause based 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 a production bug before applying a fix?▼

To find the root cause of a production bug, you must enforce a systematic debugging workflow that reproduces the issue and gathers diagnostic evidence across components before writing any code fix.

What is the best way to troubleshoot recurring test failures systematically?▼

Troubleshooting test failures systematically requires a four-phase workflow: root-cause investigation, pattern analysis, hypothesis testing, and implementation with explicit evidence gathering to locate the true source of failures.

How do I stop random fixes from creating new issues in my software?▼

Stop random fixes by enforcing root-cause analysis before any code modification, ensuring you create failing tests and validate fixes before declaring success to improve system stability.

Can I use systematic debugging for performance issues and integration problems?▼

Yes, systematic debugging applies to performance issues and integration problems by driving a phase-based workflow that requires explicit evidence gathering and hypothesis verification across software systems.

What are the steps to diagnose software errors systematically?▼

Diagnosing software errors systematically involves four phases: reproduce the issue and collect diagnostic evidence, analyze patterns, test hypotheses, and implement a root-cause based fix with verification.

When should I not use a phase-based debugging approach?▼

Avoid phase-based debugging only for trivial, immediately obvious errors where the root cause is already explicitly identified, as the evidence gathering and hypothesis testing workflow adds unnecessary overhead.