Issues – Übersicht

Issues sind das System von CodeCourier, um Probleme in Ihrer Codebasis zu entdecken, zu verfolgen und zu beheben. Ob durch eine KI-gestützte Scanning-Session identifiziert oder manuell angelegt - jedes Issue steht für eine abgegrenzte Arbeitseinheit: ein zu behebender Bug, eine umzusetzende Verbesserung oder eine zu erledigende Aufgabe. Issues können einzeln über Workflow-Runs ausgeführt oder zu Work Chains zusammengefasst werden, um sie sequenziell zu lösen.

Was sind Issues?

Ein Issue ist ein strukturierter Datensatz, der ein Problem oder eine Aufgabe samt ausreichendem Kontext erfasst, damit ein KI-Agent es lösen kann. Jedes Issue umfasst einen Titel, eine Beschreibung, eine Prioritätsstufe und einen optionalen suggestedPrompt, der spezifische Anweisungen für einen KI-Agent bereitstellt. Issues können aus zwei Quellen stammen:

• KI-Discovery - Eine Issue Session scannt Ihre Codebasis mit einem KI-Agent in einer Cloud-Sandbox und extrahiert automatisch eine Liste von Issues.
• Manuelle Erstellung - Sie legen Issues direkt über die Oberfläche an und geben Titel, Beschreibung, Priorität und optionale Fix-Anweisungen an.

Lebenszyklus eines Issues

Jedes Issue durchläuft einen einfachen, linearen Lebenszyklus, der in Echtzeit verfolgt wird:

Beziehung zu anderen Konzepten

Issues stehen an der Schnittstelle mehrerer CodeCourier-Systeme:

• Runs - Wenn Sie ein Issue ausführen, wird ein Workflow-Run erstellt und mit ihm verknüpft. Der Run führt die eigentliche Arbeit (Code-Änderungen, PR-Erstellung) in einer E2B-Sandbox aus.
• Workflows- Sie wählen den Workflow- Blueprint aus, der beim Ausführen eines Issues verwendet wird. Der Workflow definiert die mehrstufige Agent-Pipeline (z. B. Designer → Checker).
• Personas - Die im Workflow konfigurierten Personas bestimmen das Verhalten und den System-Prompt des KI-Agents bei der Bearbeitung des Issues.
• Work Chains - Mehrere Issues können in einer Work Chain gruppiert werden, um sie sequenziell als Batch auszuführen - ähnlich einer CI-Pipeline für Fixes.
• Issue Sessions - KI-gestützte Scanning- Sessions, die Ihre Codebasis analysieren und automatisch eine Issue-Liste erzeugen.
• Answering Sessions - Nach Abschluss einer Issue Session löst eine Answering Session die im Scanning erzeugten Fragen und Annahmen auf und verfeinert sie zu handlungsleitendem Kontext, bevor die Umsetzung beginnt.

Der Ablauf von Issue Discovery und Behebung

Der vollständige Lebenszyklus von der Entdeckung bis zur Behebung folgt diesem Muster:

1. Issue Session - Ein KI-Planner-Agent scannt Ihre Codebasis und erzeugt eine strukturierte Issue-Liste sowie Fragen und Annahmen zu Anforderungen, Umfang und Architektur.
2. Answering Session - Ein Answering Agent prüft die erzeugten Fragen und Annahmen, verfeinert sie und produziert freigegebene Antworten, die als Kontext für die Umsetzung dienen. Sie prüfen jede Annahme und genehmigen, lehnen ab oder korrigieren sie.
3. Issue-Behebung - Einzelne Issues werden über Workflow-Pipelines ausgeführt, wobei die freigegebenen Annahmen als zusätzlicher Kontext einfließen. Issues können auch in einer Work Chain für die sequenzielle automatisierte Ausführung zusammengefasst werden.

Wann Issues vs. Workflows einsetzen

Wichtige Funktionen

• KI-gestützte Discovery - Issue Sessions nutzen eine Cloud-Sandbox, um Ihre gesamte Codebasis zu scannen und Bugs, Sicherheitslücken, Performance-Probleme und Verbesserungspotenziale aufzudecken.
• Answering Sessions- Ein strukturierter, KI-gesteuerter Q&A-Ablauf, der vor jeder Umsetzung Fragen aus Issue-Scanning-Sessions klärt und Annahmen validiert, damit die KI über den richtigen Kontext für treffsichere Fixes verfügt.
• Prioritätsbasierte Organisation - Jedes Issue hat eine Prioritätsstufe (low, medium, high, critical), damit Sie sich auf das Wichtigste konzentrieren können.
• Vorgeschlagene Prompts - Jedes Issue kann einen KI-generierten suggestedPrompt mit konkreten Fix-Anweisungen tragen, der beim Ausführen direkt an den Workflow-Run weitergegeben wird.
• Work-Chain-Ausführung - Gruppieren Sie Issues und führen Sie sie sequenziell aus - jedes Issue wird in der vorgegebenen Reihenfolge gelöst, bevor das nächste beginnt.
• Automatische PR-Erstellung - Wenn ein Issue-Run abgeschlossen ist, wird ein Pull Request im konfigurierten GitHub-Repository erstellt.
• Echtzeit-Tracking - Issue-Status werden in Echtzeit über reaktive Queries aktualisiert, sodass Sie jederzeit den aktuellen Stand jedes Issues sehen.
• Session-Fortschritts-Tracking - Issue Sessions verfolgen den Fortschritt über die Zähler currentIteration und maxIterations und geben Ihnen Einblick, wie weit der Agent im Scanning-Prozess fortgeschritten ist.

Issue-Datenfelder

Nächste Schritte