Work Chains

Work Chains sind das Batch-Ausführungssystem von CodeCourier für Issues. Anstatt Issues einzeln auszuführen, können Sie mehrere Issues zu einer Work Chain gruppieren und sequenziell ausführen - jedes Issue wird in der vorgegebenen Reihenfolge gelöst, und das nächste beginnt erst, wenn das vorherige abgeschlossen ist. Ideal für zusammengehörige Fixes, die in einer bestimmten Reihenfolge angewendet werden sollen, etwa eine Reihe von Security-Patches oder einen koordinierten Satz Refactoring-Aufgaben.

Was sind Work Chains?

Eine Work Chain ist eine geordnete Liste von Issues, die mit einem einzelnen Workflow und einer Ausführungskonfiguration verknüpft ist. Sobald Sie eine Chain starten, verarbeitet CodeCourier jedes Issue sequenziell:

1. Das erste Issue wird aufgegriffen und ein Workflow-Run gestartet
2. Der Run führt in einer Sandbox Code-Änderungen aus und erstellt einen PR
3. Nach Abschluss des Runs wird das nächste Issue der Chain bearbeitet
4. Dies wird fortgesetzt, bis alle Issues gelöst sind oder ein Fehler auftritt

Work Chains vs. Sprint Chains

Work Chains und Sprint Chains sind in CodeCourier unterschiedliche Konzepte, auch wenn sie die Idee der sequenziellen Ausführung teilen:

Nutzen Sie Work Chains für eine Menge abgegrenzter, unabhängig behebbarer Issues. Nutzen Sie Sprint Chains für eine geplante Abfolge von Feature-Implementierungen.

Wie Prompts ausgewählt werden

Der Prompt, der an jeden Workflow-Run einer Chain übergeben wird, wird durch das Feld suggestedPrompt des Issues bestimmt. Dieses Feld wird in der Regel vom KI-Issue-Agent während des Scannings befüllt - es enthält konkrete, zielgerichtete Fix-Anweisungen, die für genau dieses Issue formuliert sind, statt einer generischen Beschreibung.

Die Auflösungsreihenfolge ist:

1. Ist suggestedPrompt gesetzt und nicht leer, wird er als Run-Prompt verwendet. So erhält der Workflow-Run präzise, KI-formulierte Anweisungen, die genau auf den benötigten Fix zugeschnitten sind.
2. Ist suggestedPrompt nicht gesetzt, wird die description des Issues als Fallback verwendet.

Eine Work Chain erstellen

So erstellen Sie eine Work Chain auf der Issues-Seite:

1. Wählen Sie die einzubeziehenden Issues über die Checkboxen in der Issue-Liste aus.
2. Klicken Sie auf die Schaltfläche Work Chain erstellen.
3. Konfigurieren Sie die Chain-Einstellungen:
   • Workflow - Wählen Sie den Workflow-Blueprint für alle Issues der Chain
   • GitHub-Repository-URL (optional) - Ziel-Repository für PRs
   • Branch-Name (optional) - Basis-Branch für die Arbeit
4. Bestätigen Sie die Erstellung der Chain. Den Issues werden ein workChainId und ein workChainOrder zugewiesen, die ihre Position in der Sequenz widerspiegeln.

Wie die Ausführung funktioniert

Sobald eine Work Chain gestartet wurde, folgt die Ausführung für jedes Issue diesem Muster:

1. Der suggestedPrompt des Issues (oder die description, falls kein Prompt gesetzt ist) wird als Run-Prompt verwendet.
2. Ein Workflow-Run wird mit dem konfigurierten Workflow, GitHub-URL und Branch der Chain gestartet.
3. Das Issue wird mit dem Run verknüpft und sein Status wechselt zu running.
4. Sobald der Run abgeschlossen ist, wird der Issue-Status auf completed oder failed gesetzt.
5. Bei Erfolg geht die Chain zum nächsten Issue über. Bei Fehlschlag pausiert die Chain zur Überprüfung.

Status-Tracking der Chain

Work Chains haben einen eigenen Lebenszyklusstatus:

Felder einer Work Chain

Fortschritt der Chain überwachen

Der Fortschritt einer Work Chain wird in Echtzeit auf der Issues-Seite angezeigt. Sie sehen:

• Den Gesamtstatus und den Fortschritt in Prozent
• Welches Issue gerade bearbeitet wird
• Individuelle Issue-Status innerhalb der Chain
• Links zu den für jedes Issue erstellten Workflow-Runs
• Aus abgeschlossenen Issues erzeugte Pull Requests

Schlägt ein Issue in der Chain fehl, können Sie den Fehler prüfen, den Suggested Prompt des Issues anpassen und die Chain ab dem fehlgeschlagenen Issue erneut starten.

Nächste Schritte