intake-to-issue
Macht aus einem unstrukturierten Anliegen ein sauberes, auffindbares Issue. Erster Schritt der Lieferkette: danach folgt das Refinement.
Voraussetzungen
- Das Arbeitsverzeichnis ist ein Git-Repo, oder der Nutzer nennt das Ziel-Repo.
- Zugriff auf die Plattform, in dieser Reihenfolge:
- GitHub- bzw. GitLab-Tools des eigenen KI-Tools (MCP), falls verfügbar
ghbzw.glabCLI (angemeldet)- REST-API mit
GITHUB_TOKENbzw.GITLAB_TOKEN
- Konkrete Befehle: references/befehle.md
Ablauf
- Plattform bestimmen:
git remote get-url originauswerten (github.com→ GitHub, sonstgitlabim Host → GitLab). Unklar ⇒ nachfragen. - Anliegen erfassen: Quelle zusammenfassen: Problem, erwartetes Verhalten, betroffener Bereich, Dringlichkeit, Quelle (Mail, Ticket, Chat). Fehlt Wesentliches (z. B. Repro-Schritte bei einem Bug), gezielt nachfragen.
- Typ bestimmen:
bug|feature|task|question. - Deduplizieren: offene und geschlossene Issues nach 2–3 Schlüsselbegriffen durchsuchen. Passender Treffer ⇒ kein neues Issue, stattdessen am bestehenden kommentieren und dessen Link zurückmelden.
- Risiko vorklassifizieren: grob nach Tragweite, wird im Refinement bestätigt.
low: lokal begrenzt, kein Datenmodell, keine Sicherheitmed: mehrere Stellen oder geteilte Logik betroffenhigh: Datenmodell/Migration, Auth, Zahlungen, Datenschutz, Produktionsdaten
- Entwurf zeigen: Titel, Body (Vorlage: assets/issue-body.md), Labels. Anlegen erst nach Bestätigung, außer der Nutzer hat ausdrücklich „direkt anlegen" gesagt.
- Issue anlegen: Labels
type:<typ>undrisk:<stufe>. Existiert ein Label im Repo nicht, anlegen, falls die Rechte reichen; sonst ohne Label anlegen und das dem Nutzer melden. - Rückverknüpfung: stammt das Anliegen aus einem externen Ticket, beide Seiten verlinken (bzw. dem Nutzer den Link für das Ticket geben).
Output
Issue-Nummer, URL, Typ und Risiko. Bei Duplikat: Link zum bestehenden Issue.
Leitplanken
- Keine Duplikate anlegen.
- Keine Secrets oder personenbezogenen Daten aus der Quelle übernehmen: Tokens, Passwörter, E-Mail-Adressen, Telefonnummern, Namen von Betroffenen neutralisieren (z. B. „ein Nutzer meldet …").
- Issues mit Label
manualnie automatisch weiterverarbeiten. - Titel kurz und sachlich, im Body nur, was für das Verständnis nötig ist.
Beispiel-Prompts
- „Nimm diese Support-Mail auf und leg ein Issue an."
- „Mach aus diesem Bug-Report ein Issue mit Repro-Schritten."