Agent skill · software engineering · aiskillstore
flow-debugging
4-phase systematic debugging for flow-fix. NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.
Why this skill is useful
Provides a structured debugging methodology that includes specific steps and templates for root cause analysis, which the AI may not generate on its own.
What it needs
About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Flow Debugging - Systematic Debugging Method The Iron Law Bug fixing is not a guessing game. Systematic debugging = faster fixes + fewer regressions. The 4-Phase Process Phase 1: Root Cause Investigation Iron Law: In this phase, NO FIX CODE ALLOWED. Output: Root cause hypothesis (evidence-based, not a guess) Phase 2: Pattern Analysis Output: Confirmed or refined root cause hypothesis Phase 3: Hypothesis and Testing Red Flag: If you're "trying this, trying that", you're guessing, not debugging. Phase 4: Implementation (TDD) Prerequisite: Phases 1-3 complete, root cause confirmed Rationalization Prevention Excuse Reality -------- --------- "I know where the problem is" Prove it. Investigate first. "Quick fix" Quick fix = quick regression. Systematic debug. "No time for tests" No tests = don't know if really fixed. "Small change" Small changes can introduce big bugs. Test it. "Fix first, investigate later" Fixing without understanding = guessing. "Let me try this" "Trying" is not debugging. Form hypothesis, verify it. "It's obvious" Nothing is obvious. Prove with evidence. "I've seen this before" Every bug is unique. Investigate this one. Red Flags - STOP If you find yourself: Fixing without reproduction "Trying this, trying that" 3+ failed fix attempts Saying "fixed" without tests Changing many files for one bug STOP. Go back to Phase 1. Investigate root cause. Debug Output Template Integration with flow-fix This skill is the core methodology for /flow-fix command: Cross-Reference flow-fix.md - Bug fix command flow-tdd/SKILL.md - TDD enforcement verification-before-completion - Verification skill --- [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/flow-debugging