hunt

Überblick über die hunt-Skill

Wofür hunt gedacht ist

hunt ist eine Debugging-first-Skill, die Root-Cause-Denken erzwingt, bevor überhaupt ein Fix angewendet wird. Sie ist besonders geeignet für Fehler, Abstürze, Regressionen, fehlschlagende Tests, Probleme mit veraltetem Cache, Screenshot-Bugs und „Früher hat es funktioniert“-Fehler, bei denen Sie eine testbare Hypothese statt eines schnellen Workarounds brauchen.

Wer sie installieren sollte

Installieren Sie die hunt-Skill, wenn Sie regelmäßig über App-Code, Tests, Build-Artefakte oder Laufzeitverhalten hinweg debuggen und einen wiederholbaren Leitfaden brauchen, um das Problem schnell einzugrenzen. Besonders nützlich ist sie, wenn die Symptome unklar sind, frühere Fixes immer wieder scheitern oder sich der Fehler über Logs, UI-Status und generierte Ausgaben erstreckt.

Was sie besonders macht

Der Kernwert ist Disziplin: eine konkrete Datei, Funktion, Zeile oder Bedingung identifizieren und dann so lange Belege sammeln, bis die Ursache belastbar ist. Die ergänzenden Referenzen decken Logging, Fehlermuster, IME-/Unicode-Sonderfälle und Rendering-Bugs ab. Die Skill sagt also nicht nur „debuggen Sie gründlicher“, sondern führt Sie zur richtigen Diagnoseklasse.

So verwenden Sie die hunt-Skill

Installation und Kontext einrichten

Nutzen Sie für Ihre Umgebung den normalen Installationsablauf für Skills und öffnen Sie dann die Skill-Dateien in dieser Reihenfolge: SKILL.md, references/failure-patterns.md, references/logging-techniques.md, references/ime-unicode.md und references/rendering-debug.md. Beginnen Sie mit der Referenz, die zum Symptom passt; lesen Sie nicht alles, außer das Problem betrifft mehrere Bereiche.

So prompten Sie für den Einsatz von hunt

Für den besten Einsatz von hunt bitten Sie zuerst um Diagnose und nicht um Reparatur, und nennen Sie das kleinstmögliche reproduzierbare Symptom, das Sie haben. Ein starker Prompt klingt etwa so: „Hunt this regression: clicking Save no longer persists after refresh; latest change touched src/hooks/user.ts; logs show cache hit.“ Ein schwacher Prompt klingt eher so: „Save is broken, please fix.“

Der Workflow, den die Skill erwartet

Der hunt-Leitfaden erwartet, dass Sie zuerst eine Ein-Satz-Hypothese formulieren, sie mit Belegen prüfen und erst dann patchen, wenn die Ursache testbar ist. Praktisch heißt das: reproduzieren, den Pfad eingrenzen, genau einen unterscheidenden Logeintrag oder Check sammeln, den Ausbreitungspfad bestätigen und dann den kleinstmöglichen Fix plus nach Möglichkeit einen Regressionstest schreiben.

Praktischer Lesepfad

Nutzen Sie references/failure-patterns.md, wenn der Fehler nach Cache-, Queue-, Guard- oder Build-Grenzproblemen aussieht. Nutzen Sie references/logging-techniques.md, wenn Sie instrumentierte Belege brauchen. Nutzen Sie references/ime-unicode.md bei CJK-Eingabe oder Kompositionsfehlern. Nutzen Sie references/rendering-debug.md für PDF-, Druck-, Font- oder Layoutfehler.

hunt-Skill-FAQ

Ist hunt nur für Codefehler gedacht?

Nein. Die hunt-Skill ist für das Debuggen jeder konkreten Fehlerart gedacht: Laufzeitfehler, fehlschlagende Tests, kaputte generierte Artefakte, UI-Regressionen und Abweichungen in der Ausgabe. Für reines Code-Review oder Feature-Design ist sie nicht die richtige Wahl.

Muss ich die genaue Ursache schon kennen?

Nein, aber Sie brauchen eine Hypothese, die sich widerlegen lässt. Die Skill ist dafür gebaut, Sie von „irgendetwas ist kaputt“ zu „Ich glaube, die Ursache ist X, weil Y“ zu bringen.

Ist hunt besser als ein normaler Prompt?

Meistens ja, wenn der Fehler mehrdeutig oder wiederkehrend ist. Ein allgemeiner Prompt liefert vielleicht direkt einen Patch; hunt versucht zuerst, das Rätselraten zu reduzieren. Dadurch sinkt das Risiko eines Fixes, der einen anderen Pfad kaputtmacht.

Wann sollte ich hunt nicht verwenden?

Überspringen Sie sie, wenn Sie eine neue Funktion bauen, ohne Bug refaktorisieren oder bereits einen bestätigten Minimal-Fix haben und nur noch Implementierungshilfe brauchen. Sie ist auch nicht die beste Wahl für grobes Architektur-Brainstorming.

So verbessern Sie die hunt-Skill

Geben Sie von Anfang an stärkere Belege

Nennen Sie das Symptom, die letzte Änderung, die genaue Umgebung und ein oder zwei konkrete Beobachtungen. Zum Beispiel: „tritt nur bei Kaltstart auf“, „funktioniert nach Cache-Leerung wieder“, „bricht auf macOS mit CJK-Eingabe“, oder „PDF wird lokal gerendert, aber nicht in CI“. So kann hunt sofort das passende Fehlermuster wählen.

Vermeiden Sie typische Fehler

Der größte Fehler ist, nach einem Fix zu fragen, bevor die Ursache eingegrenzt ist. Ein weiterer häufiger Fehler sind vage Beobachtungen: Logs, die nur die Fehlermeldung zeigen, aber nicht den Branch, die Sequenz oder den Zustandswechsel, der eine Hypothese von einer anderen unterscheidet. Ergänzen Sie trennscharfe Belege, nicht bloß mehr Lärm.

Nach dem ersten Durchlauf weiter iterieren

Wenn die erste Diagnose unvollständig ist, antworten Sie mit der neuen Beobachtung, statt den gesamten Prompt neu zu starten. Die hunt-Skill funktioniert am besten als Eingrenzungsschleife: Hypothese, Prüfung, Gegenbeispiel, stärkere Hypothese. So kommen Sie von der hunt-Skill-Installation zu einem verlässlichen Hunt im Debugging-Workflow.