KI-gestütztes GitHub-Issue-Triage mit FixClaw: Human in the Loop

Open-Source-Maintainer brennen nicht durch das Schreiben von Code aus. Sie brennen an der Inbox aus. Hundert offene Issues, die Hälfte Duplikate, ein Drittel ohne Stack-Trace, und irgendwo dazwischen der eine echte Bug, der morgen einen zahlenden Nutzer trifft. FixClaw ist ein KI-Tool für GitHub-Issue-Triage, das diese Last abnimmt, ohne Ihnen die Kontrolle aus der Hand zu nehmen.

Das hier ist eine Produkt-Landingpage, kein Tutorial. Wer ein eigenes Triage-System von Grund auf bauen will, springt nach unten zu den verwandten Leitfäden. Wer GitHub-Issue-Automatisierung sucht, die sich liest wie ein hilfreicher Junior-Maintainer und vor jedem Post auf die Freigabe wartet, liest weiter.

Das Problem, das jeder Maintainer kennt

Sie öffnen GitHub am Montag. Vierzig neue Issues seit Freitag. Acht davon sind derselbe Crash unter Windows, eingereicht von acht verschiedenen Leuten, die vor dem Anlegen nicht gesucht haben. Vier sind Feature-Requests, als Bug getarnt. Zwei sind einzeilige „funktioniert nicht"-Meldungen ohne Version, ohne OS, ohne Trace. Eines ist ein echter Security-Report, eingequetscht zwischen einem Tippfehler und einem Theming-Wunsch.

Triage frisst Stunden. Sie kopieren denselben „Können Sie bitte die Node-Version und ein minimales Repro teilen?"-Kommentar fünfmal. Sie setzen zehnmal das gleiche needs-info-Label. Sie schließen Duplikate und verlinken sie zurück. Bis Sie fertig sind, ist die Fokuszeit der Woche weg.

Die üblichen Antworten lösen das nicht. GitHub Actions mit Regex-Regeln fangen die offensichtlichen Fälle und übersehen den Rest. Generische Issue-Bots antworten mit Textbausteinen und nerven die Reporter. Einen Teilzeit-Triager einzustellen funktioniert, bis das Volumen springt. Keine dieser Optionen liest das Issue so, wie Sie es lesen würden.

Was FixClaw tatsächlich tut

FixClaw ist KI-gestütztes Issue-Management für GitHub-Repos. In einem Satz: Es liest jedes neue Issue, findet Duplikate in Ihrer Historie, klassifiziert Schweregrad und Typ, schlägt Labels vor, entwirft einen Triage-Kommentar und wartet darauf, dass Sie übernehmen oder editieren.

Die Installation läuft als GitHub App. Sie zeigen sie auf ein Repo, setzen optional ein paar Regeln, und ab dann bekommt jedes neue Issue innerhalb von Minuten einen strukturierten Triage-Vorschlag. Sie bleiben Maintainer. FixClaw bleibt Assistent.

Wie es in Ihren Workflow passt

Der Ablauf bei jedem neuen Issue sieht so aus.

neues Issue geöffnet
  > FixClaw liest Issue-Body, Kommentare, verlinkten Code und Docs
  > zieht die letzten 200 Issues aus dem Repo als Duplikat-Kontext
  > Claude klassifiziert: bug / feature / question / duplicate
  > erzeugt Labels, verlinkt verwandte Issues, entwirft eine Antwort
  > postet einen Triage-Vorschlag als Kommentar am Issue
  > Sie übernehmen, editieren oder ignorieren

Keine automatische Antwort geht an den Reporter, solange Sie keine Regel dafür setzen. Der Standard-Modus ist vorschlagen, nicht handeln. Sie sehen die vorgeschlagenen Labels, die vorgeschlagene Duplikat-Verlinkung, die vorgeschlagene Antwort, und ein Klick übernimmt alles.

Wer mehr Automatisierung will, schaltet sie pro Label ein. Beispiel: auto-apply label=needs-info bei Konfidenz über 0,9, auto-close as duplicate bei Konfidenz über 0,95, sofern das Quell-Issue jünger als 30 Tage ist. Die Regeln gelten pro Repo, nicht global.

Warum Claude unter der Haube

FixClaw nutzt Claude, weil drei Eigenschaften für Triage besonders zählen.

Langer Kontext. Duplikat-Erkennung ist die härteste Triage-Aufgabe. Ein generischer Klassifizierer sieht das neue Issue und vielleicht die Top-k-Nachbarn aus einem Vektor-Index. Claude sieht das neue Issue plus den vollständigen Text von fünfzig Kandidaten-Issues plus die verlinkten Code-Snippets, alles in einem Prompt. Das ist der Unterschied zwischen „die sehen ähnlich aus" und „das ist tatsächlich derselbe Bug, eingereicht vor drei Wochen, und hier ist die Zeile, die es belegt".

Tool-Use für strukturierten Output. Triage ist eine strukturierte Aktion: eine Liste von Labels, ein Schweregrad, ein Duplikat-Link, ein Antwort-Entwurf. FixClaw definiert diese als Tool-Schemata, und Claude liefert sie als validiertes JSON zurück. Kein Regex-Parsing von Prosa, keine halluzinierten Label-Namen, die im Repo gar nicht existieren.

Reasoning. Für schwierige Entscheidungen schaltet FixClaw Extended Thinking ein. „Ist das ein Duplikat von #1247 oder ein neuer Fall mit überlappenden Symptomen?" ist genau die Frage, bei der ein Modell, das tatsächlich durchdenkt, bessere Antworten liefert.

Was FixClaw von Auto-Respondern abhebt

Generische Issue-Bots kopieren denselben Template-Text in jeden Thread. Reporter hören nach dem zweiten Mal auf, sie zu lesen. FixClaw ist in Ihrem Repo verankert, nicht in einem generischen Issue-Modell.

Es liest Ihre tatsächliche Issue-Historie, nicht eine vorgefertigte Taxonomie. Wenn Ihr Team area/parser als Label nutzt, ist das, was vorgeschlagen wird. Wenn Sie eine Konvention haben, dass P0 „Produktion steht" und P3 „nice to have" bedeutet, lernt FixClaw das aus den letzten hundert geschlossenen Issues.

Es liest Docs und Code-Referenzen, die im Issue verlinkt sind. Wenn ein Reporter einen Stack-Trace auf src/auth/session.ts:42 einfügt, zieht FixClaw diese Datei und nimmt sie in den Triage-Kontext auf. Der vorgeschlagene Kommentar kann sich auf die tatsächliche Zeile beziehen.

Jeder Vorschlag trägt einen Konfidenz-Score und eine einzeilige Begründung. Sie sehen, dass die Duplikat-Empfehlung 0,87 sicher ist und die Begründung „gleiche Fehlermeldung, gleiches OS, gleiche Version, anderer Nutzer" lautet. Sie entscheiden, ob das reicht.

Der Standard ist Human in the Loop. Nichts wird gepostet, gelabelt oder geschlossen ohne Ihre Regel oder Ihren Klick. Wer einen vollautonomen Bot will, der das Repo führt, ist bei FixClaw falsch. Wer einen Triage-Co-Piloten will, ist richtig.

Typische Einsatzfelder

Kleine bis mittlere Open-Source-Projekte. Sie pflegen eine Library mit 20 bis 100 offenen Issues und sind allein oder ein Team von drei. Triage frisst Ihr Wochenende. FixClaw senkt die Zeit pro Issue von Minuten auf Sekunden, weil der erste Entwurf schon da ist.

Enterprise-Repos mit dedizierter Triage. Ein großer interner Monorepo, in dem Triage ein Vollzeitjob ist. FixClaw übernimmt den ersten Durchgang, sodass die Triage-Person Vorschläge reviewt statt bei null anzufangen. Dasselbe Team deckt das doppelte Volumen ab.

Community-getriebene Projekte. Projekte, in denen schnellere Erstantworten Contributors bei der Stange halten. FixClaw kann innerhalb von Minuten nach dem Anlegen ein höfliches, präzises „Folgendes brauchen wir noch von Ihnen" posten, statt drei Tage später, wenn ein Maintainer dazu kommt.

Was FixClaw nicht tut

Es schreibt nicht Ihren Code. Issue-to-PR-Generierung ist eine andere Produktkategorie, und sie mit hineinzumischen würde das Human-in-the-Loop-Versprechen brechen. Wer Code geschrieben haben will, nutzt einen Coding-Agent und hält Triage separat. Für Agents, die nach Freigabe ausführen, deckt das HITL-Approval-Flow-Blueprint die Design-Entscheidungen ab — Kanal, Risikoklasse, Audit-Trail, Eskalation.

Es ersetzt nicht das Maintainer-Urteil bei Feature-Entscheidungen. FixClaw labelt einen Request als feature und entwirft eine Bestätigung. Es entscheidet nicht, ob Sie das Feature akzeptieren. Das bleibt bei Ihnen.

Es fasst keine Pull Requests an. Nur Issues. PR-Review ist ein anderes Problem mit anderen Tradeoffs, und wir wollen es nicht halb lösen.

Es liefert keine Antwort-Bausteine. Jeder Kommentar-Entwurf wird frisch aus dem konkreten Issue generiert. Kein Template-Spam.

Setup in fünf Minuten

1. Installieren Sie die GitHub App auf Ihrem Account oder Ihrer Organisation.
2. Wählen Sie die Repos, auf denen FixClaw aktiv sein soll.
3. Optional: Im Dashboard pro-Label-Regeln setzen (Auto-Apply, Auto-Close, Konfidenz-Schwellen).
4. Ein neues Issue öffnen oder warten. Der erste Triage-Vorschlag erscheint innerhalb von Minuten als Kommentar.

Kein YAML im Repo. Keine Workflow-Dateien zu pflegen. Keine Secrets zu rotieren. Die App hält die Berechtigungen, FixClaw spricht mit GitHub und Claude, Sie sehen die Ergebnisse direkt am Issue.

Preis und Modell

Kostenloser Tarif für kleine Repos unter 50 Issues pro Monat. Bezahlt für höheres Volumen, abgerechnet pro Issue oder pro Monat. Open-Source-Projekte mit aktiver Community bekommen typischerweise die kostenlose Nutzung gegen einen kleinen Integrationshinweis im Issue-Template.

Enterprise-Selfhosting ist für Teams verfügbar, die die Pipeline in der eigenen Infrastruktur laufen lassen müssen. Gleiches Produkt, Ihre VPC, Ihr Anthropic-API-Key.

Aktuelle Zahlen und die aktuelle Preisgestaltung stehen im FixClaw-GitHub-Repo.

Datenverarbeitung und Datenschutz

FixClaw liest den Text von Issues und ihren Kommentaren. Bei öffentlichen Repos handelt es sich um öffentliche Daten. Bei privaten Repos fließen die Daten über die Anthropic-API unter einem Standard-Auftragsverarbeitungsvertrag, ohne Training auf Ihren Inhalten und mit der Option, in einer EU-Region zu laufen, falls Sie das brauchen.

Nichts wird über das hinaus gespeichert, was FixClaw zum Betrieb braucht: die Repo-Einstellungen, die Regelkonfiguration und die Vorschläge selbst, damit Sie sie später nachvollziehen können. Issue-Inhalte werden nach Abschluss des Triage-Laufs nicht aufbewahrt.

Beim Selfhosting verlässt nichts davon Ihre Infrastruktur. Sie bringen Ihren eigenen Anthropic-Key mit, und der Datenpfad gehört Ihnen Ende zu Ende.

Wie es gebaut wurde

FixClaw läuft auf der Claude-API mit Tool-Use als Kernmechanismus für strukturierte Triage-Aktionen. Das Backend ist TypeScript, webhook-getrieben, zwischen Events zustandslos. Ein GitHub-Webhook feuert auf issues.opened, FixClaw zieht den Repo-Kontext, ruft Claude mit dem Triage-Tool-Schema auf und postet das Ergebnis als Kommentar zurück.

Die Duplikat-Erkennung kombiniert Embeddings für die Vorauswahl mit Claude und langem Kontext für die finale Entscheidung. Günstiges Recall, teure Präzision, nur wo es zählt. Extended Thinking wird selektiv aktiviert, wenn die Vorauswahl mehrdeutig ist — das hält die Durchschnittskosten pro Triage berechenbar.

Die Architektur greift dieselben Muster auf, die in produktiven Agent-Systemen funktionieren: strukturierte Tool-Calls statt freier Generierung, Prompt-Caching auf dem Repo-Kontext-Präfix, damit häufige Reads günstig bleiben, strikte JSON-Validierung auf jeder Tool-Antwort. Die ausführliche Version dieser Architektur deckt der Leitfaden zur Produktions-AI-Agent-Architektur ab.

Wer so etwas selbst bauen will, findet im Tutorial MCP-Server in TypeScript bauen und im Leitfaden zu Claude-Code-SDK-Agents die beweglichen Teile. Die Begründung, warum KI für Triage überhaupt sinnvoll ist, steht in GitHub-Issue-Management mit KI.

Wann FixClaw das richtige Werkzeug ist

Sie pflegen zwischen einem und fünfzig aktive Repos. Ihr Issue-Volumen liegt über zwanzig pro Monat — genug, dass manuelle Triage Sie tatsächlich Zeit kostet. Sie wollen Triage-Hilfe, keinen Bot, der für Sie entscheidet. Sie wollen Labels, Duplikat-Verlinkungen und einen Antwort-Entwurf, der auf Sie wartet — und Sie wollen den finalen Klick behalten.

Wann nicht

Ihre Triage ist vollständig deterministisch, und eine GitHub Action mit Labelern und Regex-Regeln macht den Job. Ein KI-Tool obendrauf wäre Komplexität ohne Mehrwert.

Ihre Issues sind so domänenspezifisch, dass nur ein Fachexperte sie klassifizieren kann. FixClaw wird oft genug falsch liegen, um zu nerven.

Sie wollen einen vollautonomen Bot, der das ganze Repo führt. FixClaw ist Human in the Loop by Design und bleibt es. Wer Autonomie als Ziel hat, ist mit einem anderen Tool besser bedient.

Verwandte Leitfäden

• GitHub-Issue-Management mit KI für das größere Bild
• Produktions-AI-Agent-Architektur für die Muster, die FixClaw nutzt
• MCP-Server in TypeScript bauen und Claude-Code-SDK-Agents für den Eigenbau

Maintainer brennen wegen Triage aus, nicht wegen Code. FixClaw nimmt die Triage-Last ab, während Sie die Kontrolle über jedes Label, jede Verlinkung und jeden Close behalten. Mit einem Repo anfangen. Den ersten Vorschlag sehen. Dann entscheiden.