Skill · em Corrigir bugs

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Procedência

Origem: obra/superpowers
Caminho: skills/systematic-debugging
Versão fixada: 5bf4e78011075bcfc0dc295f0724994cd123ee71
Licença: MIT
Espelhado em 25/09/2026
270,6 mil instalações no skills.sh (lido em 25/09/2026)

Antes de instalar

11 arquivos · 39,8 KB · inclui 2 scripts que executam: condition-based-waiting-example.ts, find-polluter.sh

Instalar na sua CLI

O comando baixa a versão fixada (commit 5bf4e78) direto da origem, para a pasta que a CLI lê. Precisa de curl (macOS e Linux); no Windows não há comando, porque o Rook Labs é para macOS.

Claude Code

Neste projeto: instala em .claude/skills/systematic-debugging/.

d=".claude/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.claude/skills/systematic-debugging/.

d="$HOME/.claude/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Codex

Neste projeto: instala em .agents/skills/systematic-debugging/.

d=".agents/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.agents/skills/systematic-debugging/.

d="$HOME/.agents/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Antigravity

Neste projeto: instala em .agents/skills/systematic-debugging/.

d=".agents/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Global: instala em ~/.gemini/antigravity-cli/skills/systematic-debugging/.

d="$HOME/.gemini/antigravity-cli/skills/systematic-debugging"
u="https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/skills/systematic-debugging"
curl -fsSL --create-dirs \
  -o "$d/SKILL.md" "$u/SKILL.md" \
  -o "$d/condition-based-waiting-example.ts" "$u/condition-based-waiting-example.ts" \
  -o "$d/condition-based-waiting.md" "$u/condition-based-waiting.md" \
  -o "$d/CREATION-LOG.md" "$u/CREATION-LOG.md" \
  -o "$d/defense-in-depth.md" "$u/defense-in-depth.md" \
  -o "$d/find-polluter.sh" "$u/find-polluter.sh" \
  -o "$d/root-cause-tracing.md" "$u/root-cause-tracing.md" \
  -o "$d/test-academic.md" "$u/test-academic.md" \
  -o "$d/test-pressure-1.md" "$u/test-pressure-1.md" \
  -o "$d/test-pressure-2.md" "$u/test-pressure-2.md" \
  -o "$d/test-pressure-3.md" "$u/test-pressure-3.md" \
  -o "$d/LICENSE" "https://raw.githubusercontent.com/obra/superpowers/5bf4e78011075bcfc0dc295f0724994cd123ee71/LICENSE"

Peça ao Rook

Já usa o Rook Labs? Cole no chat do Rook: instale a skill https://rooklabs.sh/marketplace/superpowers.systematic-debugging

Prévia do SKILL.md

---
name: systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
---

# Systematic Debugging

## Overview

**Core principle:** ALWAYS find root cause before attempting fixes. Symptom fixes are failure.

**Violating the letter of this process is violating the spirit of debugging.**

## The Iron Law

```
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
```

If you haven't completed Phase 1, you cannot propose fixes.

## When to Use

Use for ANY technical issue:
- Test failures
- Bugs in production
- Unexpected behavior
- Performance problems
- Build failures
- Integration issues

**Use this ESPECIALLY when:**
- Under time pressure (emergencies make guessing tempting)
- "Just one quick fix" seems obvious
- You've already tried multiple fixes
- Previous fix didn't work
- You don't fully understand the issue

**Don't skip when:**
- Issue seems simple (simple bugs have root causes too)
…

Ver todo o marketplace