investigate

Überblick über den investigate-Skill

Was der investigate-Skill macht

Der investigate-Skill ist für systematisches Debugging und Root-Cause-Analyse gedacht, wenn etwas kaputt ist, instabil läuft oder sich anders verhält als erwartet. Er richtet sich an Nutzer, die mehr brauchen als einen schnellen Patch: Wenn Sie verstehen wollen, warum ein Fehler auftritt, was sich geändert hat und welche Korrektur sicher ist, strukturiert investigate diese Arbeit.

Für wen er gedacht ist

Nutzen Sie den investigate-Skill für Code Reviews, Incident-Triage, Bugfixing und Situationen nach dem Muster „Gestern hat es noch funktioniert“. Er passt besonders gut, wenn ein Agent nicht raten soll, sondern erst Beweise sammelt und von den Symptomen zur bestätigten Ursache arbeitet, bevor Code verändert wird.

Was ihn auszeichnet

Der zentrale Unterschied ist die Regel „keine Fixes ohne Root Cause“. Dadurch ist der investigate-Skill disziplinierter als ein generischer Debug-Prompt: Er lenkt den Ablauf in Richtung Untersuchung, Analyse, Hypothesenbildung und Umsetzung, statt sofort mit Änderungen zu beginnen. Außerdem unterstützt er proaktives Triggern, was in Agent-Workflows nützlich ist, wenn der Skill sofort aktiv werden soll, sobald Fehler oder Stack Traces auftauchen.

So verwenden Sie den investigate-Skill

Installieren und aufrufen

Installieren Sie den investigate-Skill mit:

npx skills add garrytan/gstack --skill investigate

Verwenden Sie ihn, wenn Ihr Prompt klar einen Fehlerzustand beschreibt, etwa einen Stack Trace, einen 500-Fehler, eine Regression oder unerwartete Ausgabe. Die besten Ergebnisse erzielen Sie, wenn Sie das Symptom, den Ort des Auftretens und das gewünschte „funktioniert wieder“-Bild konkret benennen.

Geben Sie die richtige Ausgangsinformation

Ein starker Prompt für den investigate-Skill enthält:

• die genaue Fehlermeldung oder einen Log-Ausschnitt
• den Befehl, Endpoint oder die Nutzeraktion, die den Fehler auslöst
• was sich kürzlich geändert hat
• was Sie bereits geprüft haben
• Auswirkungen und Dringlichkeit

Beispiel: „Untersuche, warum npm test jetzt in CI nach dem letzten Merge fehlschlägt. Vergleiche main mit HEAD, prüfe die letzten Änderungen an der auth middleware und schlage keine Codeänderungen vor, bevor die Ursache bestätigt ist.“

Lesen Sie zuerst die richtigen Dateien

Beginnen Sie mit SKILL.md und sehen Sie sich danach SKILL.md.tmpl an, um Vorlagenverhalten oder Routing-Logik zu verstehen. Da dieses Repository keine separaten Ordner rules/, resources/ oder scripts/ hat, liegt der Hauptnutzen im Skill-File selbst und in allen Inline-Referenzen, auf die es verweist. Für investigate für Code Review sollten Sie besonders auf die Trigger-Sprache und die Grenzen sicherer Operationen vor dem Editieren achten.

Workflow-Tipps, die die Ergebnisse verbessern

Behandeln Sie investigate als Entscheidungsworkflow, nicht als freie Konversation. Bitten Sie den Agenten darum:

1. den Fehlertyp zu identifizieren,
2. unterstützende Belege zu sammeln,
3. ein oder zwei testbare Hypothesen zu bilden,
4. die wahrscheinlichste Ursache zu verifizieren,
5. den kleinsten sicheren Fix umzusetzen.

Wenn Sie Schritt 1 überspringen, kann der Skill zwar trotzdem Analyse liefern, aber sie ist für Code Review oder Incident Response deutlich weniger brauchbar.

FAQ zum investigate-Skill

Ist investigate nur für Bugs gedacht?

Nein. Der investigate-Skill eignet sich auch für Regressionen, fehlgeschlagene Deployments, kaputte Integrationen und unklare Verhaltensänderungen. Wenn die Aufgabe lautet „Finde heraus, warum das passiert“, ist investigate meist der richtige Startpunkt.

Worin unterscheidet er sich von einem normalen Prompt?

Ein normaler Prompt kann direkt nach einem Fix fragen. Der investigate-Skill ist strukturierter: Er erzwingt zuerst Root-Cause-Denken, was fragile Änderungen reduziert und die finale Anpassung im Code Review besser begründbar macht.

Ist investigate gut für Anfänger?

Ja, wenn der Nutzer ein Symptom und etwas Kontext liefern kann. Einsteiger profitieren meist von dem Skill, weil er Rätselraten reduziert, aber sie müssen dennoch konkrete Belege wie Logs, Reproduktionsschritte oder einen fehlschlagenden Befehl mitgeben.

Wann sollte ich ihn nicht verwenden?

Verwenden Sie investigate nicht, wenn Sie die genaue Änderung bereits kennen oder wenn Sie eine einfache Content-Änderung ohne zu diagnostizierenden Fehler durchführen. In solchen Fällen ist ein einfacher Task-Prompt schneller.

So verbessern Sie den investigate-Skill

Liefere Belege, nicht nur eine Beschwerde

Der größte Qualitätssprung entsteht durch präzisere Eingaben. Statt „die App ist kaputt“ sollten Sie die fehlschlagende Anfrage, den Fehlertext, den Dateipfad, die Umgebung und den letzten bekannten funktionierenden Stand angeben. Der investigate-Skill arbeitet am besten, wenn er jede Hypothese an beobachtbare Belege koppeln kann.

Den Suchraum eingrenzen

Wenn das Problem in einem Code Review liegt, benennen Sie das wahrscheinliche Subsystem und das Zeitfenster der Änderung. Zum Beispiel: „Konzentriere dich auf auth, nur Änderungen aus den letzten zwei Commits, und prüfe, ob der Bug in staging reproduzierbar ist.“ Das verhindert, dass investigate zu breit streut, und erhöht die Chance auf eine schnelle Root Cause.

Nach dem ersten Durchlauf nachschärfen

Wenn die erste Antwort nicht eindeutig ist, verlangen Sie eine engere Untersuchung statt eines breiteren Umbaus. Gute Folgefragen sind: „Liste die drei wahrscheinlichsten Hypothesen mit Konfidenzangaben auf“, „Zeige, welche Belege jede einzelne widerlegen würden“ oder „Verfolge den Fehler von Input bis Output und halte vor dem Coden an.“