Strukturierte Fehlersuche-Sitzung – Wiederholen, Isolieren, Diagnosieren und Beheben von Problemen. Auslösen können Fehlermeldungen oder Stack-Traces sein, zum Beispiel „Dies funktioniert in der Staging-Umgebung, aber nicht in der Produktionsumgebung“ oder „Etwas ist nach dem Deployment kaputtgegangen“. Ebenso eignet sich diese Methode, wenn das Verhalten des Systems von den Erwartungen abweicht und die Ursache offensichtlich nicht ist.
...Alle erweiternÜber das Debuggen
Die Fähigkeit zum Debuggen dient dazu, Benutzer durch einen strukturierten Fehlerbehebungsprozess zu führen, wenn sich das Verhalten von Software als falsch, unklar oder rückläufig erweist. Sie ist für Situationen konzipiert, in denen eine Fehlermeldung, ein Stacktrace oder unerwartetes Verhalten auf ein Problem hindeuten, das nicht sofort diagnostiziert werden kann. Durch die Gliederung des Debugging-Prozesses in klare Phasen hilft sie Benutzern dabei, systematisch von der Beobachtung von Symptomen zur Identifizierung der Ursache vorzugehen, anstatt sich auf Vermutungen zu verlassen.
Die Fähigkeit folgt einer vierstufigen Methodik: Wiederholung des Problems, Isolierung der betroffenen Komponenten, Diagnose und Behebung. In der Phase der Wiederholung geht es darum, das erwartete Verhalten mit dem tatsächlichen zu vergleichen und zuverlässige Schritte zur Nachstellung des Problems festzulegen. In der Phase der Isolierung werden die betroffenen Komponenten anhand neuer Änderungen wie Deployments, Konfigurationsupdates oder Abhängigkeitsänderungen eingegrenzt; gleichzeitig werden Protokolle und Fehlerausgaben analysiert. Während der Diagnosephase werden Hypothesen formuliert und getestet, Ausführungspfade nachverfolgt und die zugrunde liegende Ursache ermittelt – anstatt sich nur auf oberflächliche Symptome zu konzentrieren. Schließlich geht es in der Phase der Behebung darum, korrigierende Maßnahmen vorzuschlagen, dabei Nebeneffekte zu berücksichtigen und präventive Tests zu empfehlen, um Rückläufigkeiten zu vermeiden.
Diese Fähigkeit richtet sich in erster Linie an Entwickler, DevOps-Engineers, QA-Tester und Site Reliability Engineers, die regelmäßig Probleme in Produktions- und Entwicklungsumgebungen beheben. Sie ist besonders nützlich bei Situationen wie Rückläufigkeiten nach Deployments, umweltbedingten Fehlern oder unerklärlichen Ausfällen nach neueren Änderungen. Durch die Anwendung einer strukturierten Fehlerbehebungsprozedur wird das trial-and-error-Verfahren reduziert und die Konsistenz bei der Lösung von Problemen verbessert.
Häufig gestellte Fragen
Welche Informationen sollten ich bereitstellen, um diese Debugging-Fähigkeit zu nutzen?
Sie sollten eine Fehlermeldung, einen Stacktrace, eine Beschreibung des unerwarteten Verhaltens, Schritte zur Nachstellung des Problems oder Kontextinformationen wie neuerliche Änderungen oder Protokolle bereitstellen. Je genauer die Informationen sind, desto effektiver wird der Debugging-Prozess sein.
Erfordert diese Fähigkeit den Zugriff auf externe Tools oder Verbindungsmechanismen?
Sie kann optional auf verfügbare Tools wie Überwachungssysteme, Versionskontrollsysteme oder Projektverfolgungstools zurückgreifen, sofern diese verbunden sind. Es ist jedoch auch möglich, die Fähigkeit ausschließlich mit den bereitgestellten Informationen, Protokollen und Kontextdaten zu nutzen.
Für welche Arten von Problemen eignet sich diese Fähigkeit nicht?
Sie ist nicht geeignet für rein theoretische Fragen oder allgemeine Erklärungen. Sie richtet sich speziell darauf aus, konkrete Softwareprobleme mit nachweislich falschem Verhalten zu diagnostizieren und zu lösen.
/debug
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md.
Run a structured debugging session to find and fix issues systematically.
Usage
/debug $ARGUMENTSHow It Works
┌─────────────────────────────────────────────────────────────────┐│ DEBUG │├─────────────────────────────────────────────────────────────────┤│ Step 1: REPRODUCE ││ ✓ Understand the expected vs. actual behavior ││ ✓ Identify exact reproduction steps ││ ✓ Determine scope (when did it start? who is affected?) ││ ││ Step 2: ISOLATE ││ ✓ Narrow down the component, service, or code path ││ ✓ Check recent changes (deploys, config changes, dependencies) ││ ✓ Review logs and error messages ││ ││ Step 3: DIAGNOSE ││ ✓ Form hypotheses and test them ││ ✓ Trace the code path ││ ✓ Identify root cause (not just symptoms) ││ ││ Step 4: FIX ││ ✓ Propose a fix with explanation ││ ✓ Consider side effects and edge cases ││ ✓ Suggest tests to prevent regression │└─────────────────────────────────────────────────────────────────┘What I Need From You
Tell me about the problem. Any of these help:
- Error message or stack trace
- Steps to reproduce
- What changed recently
- Logs or screenshots
- Expected vs. actual behavior
Output
## Debug Report: [Issue Summary]### Reproduction- **Expected**: [What should happen]- **Actual**: [What happens instead]- **Steps**: [How to reproduce]### Root Cause[Explanation of why the bug occurs]### Fix[Code changes or configuration fixes needed]### Prevention- [Test to add]- [Guard to put in place]
If Connectors Available
If ~~monitoring is connected:
- Pull logs, error rates, and metrics around the time of the issue
- Show recent deploys and config changes that may correlate
If ~~source control is connected:
- Identify recent commits and PRs that touched affected code paths
- Check if the issue correlates with a specific change
If ~~project tracker is connected:
- Search for related bug reports or known issues
- Create a ticket for the fix once identified
Tips
- Share error messages exactly — Don't paraphrase. The exact text matters.
- Mention what changed — Recent deploys, dependency updates, and config changes are top suspects.
- Include context — "This works in staging but not prod" or "Only affects large payloads" narrows things fast.
debug installieren
Laden Sie die Fähigkeitsdateien herunter und extrahieren Sie sie in Ihren Ordner .claude/skills/.
ZIP herunterladenKlonen Sie das Repository und kopieren Sie die Skill-Dateien in Ihr Projekt.
git clone https://github.com/anthropics/knowledge-work-plugins/blob/main/engineering/skills/debug/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Kopieren





Heim
