Dokumentation

Führen Sie Ihre erste Aufgabe aus

Beschreiben Sie eine Aufgabe, genehmigen Sie den Plan und beobachten Sie, wie Coroid diese erstellt und überprüft.

Eine Aufgabe ist eine Arbeitsunit, die in einem pull request endet. Starten Sie eine neue Neue Aufgaben, und wählen Sie Aufgabe unter Erstellen als. Wenn Sie es auf Automatisch belassen, entscheidet Coroid selbst zwischen einer Aufgabe und einem Plan.

Wählen Sie eine geeignete erste Aufgabe

Die beste erste Aufgabe ist klein, praxisnah und nahe an existierenden Tests – etwa "eine --json Mit dem Parameter „flag“ im Export-Befehl wird die Ausgabeform an die vom Import-Befehl bereits unterstützte Struktur angepasst – dadurch erhält Coroid ein klares Ziel und Sie erhalten eine übersichtliche Darstellung des Ergebnisses.

Bei der ersten Ausführung sollten Sie Folgendes vermeiden:

  • Elemente, die die Authentifizierung, Zahlungen oder Datenmigration betreffen.
  • Arbeiten, bei denen noch keine Design-Entscheidung getroffen wurde.
  • Unklare Aufräumarbeiten – etwa „Fehlerbehandlung verbessern“, bei denen kein klarer Abschlusspunkt definiert ist.

Beschreiben Sie, was Sie erreichen möchten.

Formulieren Sie das gewünschte Ergebnis und nicht die Umsetzungsweise. Geben Sie an, was nach Abschluss der Arbeit gelten soll, und nennen Sie alles Ungewöhnliche: relevante Dateien, einzuhaltende Konventionen sowie Bereiche, die unberührt bleiben sollen.

Sie müssen den Plan nicht selbst erstellen. Das ist das erste Ergebnis, das Coroid liefert – und Sie können es anschließend genehmigen.

Falls Kontextinformationen im Code nicht enthalten sind – etwa ein ADR, eine Style-Guide oder ein Ticket – fügen Sie diese hinzu. Weitere Informationen finden Sie unter Projektkontext – dort sind die von Coroid ohne zusätzliche Angaben bekannen Details aufgeführt.

Neue Aufgabe
Beschreiben Sie das gewünschte Ergebnis. Coroid findet den richtigen Weg zur Umsetzung.
Erstellen als
AutomatischAufgabePlan
Coroid wählt das Ergebnis aus, oder Sie können es selbst bestimmen.
Projekt
web-app
Arbeitstitel
Kunden sollen ihre Rechnungen als CSV exportieren können.
Beschreibung

Die Finanzabteilungen bitten stets um Rechnungen in Tabellenkalkulationsdateien. Fügen Sie eine Export-Schaltfläche zur Rechnungsliste hinzu, die den aktuellen Filter als CSV herunterlädt.

Erledigt, wenn: die Datei in Excel und Numbers geöffnet werden kann, die Beträge die Währung des Kontos verwenden und Exporte mit über 10.000 Zeilen nicht abreißen.

Dateien anhängen
Nächstes: Qualifizierung. Bislang wurde nichts erstellt.Fortfahren

Das Formular „Neue Arbeit“: Wählen Sie aus, was erstellt werden soll, wählen Sie das Projekt aus und beschreiben Sie das Ergebnis in einer Überschrift und einer Kurzbeschreibung.

Weiter zur Qualifizierungsphase

Wählen Sie Fortfahren. Bislang wurde noch nichts erstellt: Coroid prüft die Anfrage, vergleicht sie mit dem aktuellen Release, sucht nach Duplikaten und bestätigt den weiteren Ablauf. Wenn alles passt, wird die Aufgabe erstellt und in die Warteschlange eingereiht. Sollte die Qualifizierungsprüfung die Anfrage ablehnen, werden die Gründe angegeben – dann können Sie die Anfrage bearbeiten und es erneut versuchen. Sehen Sie sich das an. Beschreiben Sie Ihren Bedarf.

Die Spezifikation überprüfen

Coroid wandelt Ihre Beschreibung in eine Spezifikationum: Was gebaut werden soll, was außerhalb des Umfangs liegt und die Akzeptanzkriterien, die den Erfolg bestimmen. Diese erscheint auf dem Reiter „Spezifikationen“ der Aufgabe.

Lesen Sie diese vor dem Bauvorgang durch. Falls die Akzeptanzkriterien nicht Ihren Vorstellungen entsprechen, korrigieren Sie sie jetzt – schließlich bilden sie die Grundlage für die spätere Überprüfung. Sehen Sie sich die Spezifikationen.

Den Plan genehmigen

Bei Änderungen, die über eine geringfügige Anpassung hinausgehen, wird die Spezifikation zu einem Plan: einem geordneten Satz von Schritten. Sie genehmigen ihn erst, bevor Code geschrieben wird.

Hier können Sie am kostengünstigsten eingreifen. Einen Plan abzulehnen kostet nur eine Minute – einen fertigen pull request abzulehnen bedeutet hingegen den Verlust eines gesamten Durchlaufs.

Den Vorgang verfolgen

Sobald die Aufgabe erstellt ist, gelangt sie in PENDING , bis ein Agent-Slot frei wird, anschließend IN_PROGRESS. Sie können den Vorgang live verfolgen: die ausgeführten Schritte, aufgerufene Tools, bearbeitete Dateien und die sich ansammelnden Testergebnisse.

Sie müssen nicht zuschauen – Benachrichtigungen informieren Sie, wann Ihr Eingreifen erforderlich ist oder wenn der Vorgang abgeschlossen ist.

Was Sie erwartet

  • Dauer wird durch die Größe der Änderung und die Dauer Ihres Test-Suites bestimmt – nicht durch die Anzahl der verfügbaren Agent-Slots. Diese steuern lediglich, wie viele Aufgaben gleichzeitig ausgeführt werden.
  • NEEDS_HUMAN_REVIEW ist kein Fehler. Das bedeutet, dass Coroid auf eine Entscheidung stößt, die nur Sie treffen können. Beantworten Sie die Anfrage, und die Aufgabe wird fortgesetzt.
  • Nachbearbeitung ist normal. Falls der Rezensent etwas findet, wird die Aufgabe vor Ihrem Einblick an den Entwickler zurückgegeben.

Weiter

Ergebnis überprüfen und zusammenführen – was dabei herauskommt und worauf Sie achten müssen.