Issues erstellen und verwalten

Schritt-für-Schritt-Anleitung zum manuellen Erstellen von Issues, Setzen von Prioritäten, Bearbeiten von Issue-Details und Massenverwaltung.

5 min Lesezeit
issuescreatemanage

Issue Sessions können Probleme automatisch entdecken - Sie können Issues aber auch manuell erstellen und verwalten. Das ist nützlich, wenn Sie bereits wissen, was behoben werden muss, zusätzlichen Kontext zu KI-entdeckten Issues hinzufügen möchten oder Arbeitsobjekte organisieren wollen, die kein Codebasis-Scanning benötigen.

Ein Issue manuell erstellen

Um auf der Issues-Seite ein Issue zu erstellen, klicken Sie auf die Schaltfläche Neues Issue. Der Dialog für manuelle Issues öffnet sich mit folgenden Feldern:

  1. Titel (erforderlich) - Eine kurze, prägnante Zusammenfassung des Problems oder der Aufgabe. Halten Sie ihn knapp, aber spezifisch genug, damit das Issue auf einen Blick erkennbar ist.
  2. Beschreibung (erforderlich) - Eine detaillierte Erläuterung des Issues. Geben Sie Kontext dazu, wo das Problem auftritt, was das erwartete Verhalten sein sollte, sowie relevante Fehlermeldungen oder Symptome an.
  3. Priorität (erforderlich) - Die Wichtigkeit des Issues. Standardwert ist medium, falls nicht angegeben.
  4. Suggested Prompt(optional) - Konkrete Anweisungen für einen KI-Agent zur Behebung des Issues. Falls angegeben, wird dieser Prompt beim Start eines Workflow-Runs anstelle der Beschreibung verwendet. Formulieren Sie ihn als direkte Anweisung (z. B. "Behebe den Memory Leak in src/ws/handler.ts, indem Event- Listener beim Disconnect bereinigt werden").

Gute Suggested Prompts schreiben

Ein gut formulierter Suggested Prompt verbessert die Erfolgsquote der KI-basierten Behebung erheblich. Geben Sie konkrete Dateipfade, Funktionsnamen und den gewünschten Lösungsweg an. Je präziser die Anweisungen, desto besser das Ergebnis.

Prioritätsstufen

Jedes Issue hat eine Prioritätsstufe, die Ihnen hilft, Arbeit zu organisieren und zu priorisieren:

PrioritätWann verwenden
criticalProduktionsstörende Bugs, Sicherheitslücken oder Datenverlust-Szenarien, die sofort behandelt werden müssen.
highErhebliche Bugs oder Issues, die Kernfunktionalität beeinträchtigen, für die es jedoch Workarounds gibt. Sollten im aktuellen Sprint adressiert werden.
mediumNicht kritische Verbesserungen, kleinere Bugs oder Aufgaben, die erledigt werden sollten, aber nicht dringend sind. Dies ist die Standardpriorität.
lowNice-to-have-Verbesserungen, Code-Aufräumarbeiten oder kleinere kosmetische Issues, die warten können.

Issues bearbeiten

Sie können jedes Feld eines Issues nach der Erstellung aktualisieren. Aus der Issue-Detailansicht heraus können Sie bearbeiten:

  • Titel - Verfeinern Sie die Zusammenfassung, sobald Sie mehr über das Problem wissen
  • Beschreibung - Ergänzen Sie zusätzlichen Kontext oder Untersuchungsnotizen
  • Priorität - Passen Sie sie an Änderungen in Auswirkung oder Dringlichkeit an
  • Suggested Prompt - Aktualisieren Sie die Fix-Anweisungen auf Basis neuer Erkenntnisse

Laufende Issues

Issues mit Status running sollten nicht bearbeitet werden, da Änderungen den aktiven Workflow-Run nicht beeinflussen. Warten Sie, bis der Run abgeschlossen oder fehlgeschlagen ist, bevor Sie Änderungen vornehmen und es erneut versuchen.

Issues löschen

Issues unterstützen Soft-Delete - gelöschte Issues werden in den Papierkorb verschoben und können bei Bedarf wiederhergestellt werden. So löschen Sie Issues:

  • Einzellöschung - Klicken Sie auf die Löschen-Aktion in einer einzelnen Issue-Karte oder in der Detailansicht.
  • Massenlöschung - Wählen Sie mehrere Issues über die Checkboxen in der Issue-Liste aus und klicken Sie dann auf die Aktion zum Massenlöschen. Praktisch zum Aufräumen großer Mengen irrelevanter KI-entdeckter Issues.

Issues mit KI entdecken

Für die automatische Issue-Discovery bietet CodeCourier Issue Sessions - KI-gestützte Scanning- Runs, die Ihre Codebasis analysieren und Issues automatisch extrahieren. Eine Issue Session provisioniert eine Cloud-Sandbox, führt einen KI-Agent mit Ihrem Discovery-Prompt aus und produziert eine strukturierte Issue-Liste mit Titeln, Beschreibungen, Prioritäten und vorgeschlagenen Fix-Prompts.

Nächste Schritte