Dies ist die Seite, auf die im Rest der Dokumentation verwiesen wird. Sie benennt jede Ausführungsphase, damit andere Artikel präzise angeben können, wo etwas stattfindet.
Der Pfad
- 1
SpezifikationWas gebaut werden soll und wie Sie erkennen, dass es funktioniert.
ArchitektSie können bearbeiten - 2Planung
Geordnete Schritte, die vor dem Schreiben von Code geprüft werden.
ArchitektSie genehmigen - 3
ErstellungCode und Tests werden in einer isolierten Arbeitsumgebung geschrieben.
Entwickler - 4
ÜberprüfungIhr Test-Suite sowie Prüfungen und Qualitätskriterien.
QA - 5
ReviewEine automatisierte Überprüfung der Differenzen.
Rezensent - 6Pull-Request
Auf einem Branch in Ihrem Repository, wartet auf Sie.
Sie führen zusammen
Fehlgeschlagene Verifizierungen und behebbare Rezensionsergebnisse gehen als Nachbesserung an den Entwickler zurück, bevor ein pull request erstellt wird.
Diese Phasen sind bei beiden Ausführungsmodi einer Aufgabe identisch. Im Standardmodus überführt die Plattform die Aufgabe von einer Phase zur nächsten. Im Coordinator-Modus bleibt der Planungsagent als Koordinator bei der Aufgabe, weist jedem Agenten die richtige Phase zu und entscheidet, was nach jedem Ergebnis geschieht – einschließlich des Zurücksenden von Arbeit. In beiden Fällen wird eine Phase durch ihre eigenen Prüfungen abgeschlossen. Siehe Agentenrollen um zu erfahren, wie sich die beiden Modi unterscheiden.
Spezifikation
Coroid beginnt nicht mit Ihrem Satz. Zuerst wandelt es Ihre Beschreibung in eine Spezifikation: Was gebaut werden soll, was ausdrücklich außerhalb des Umfangs liegt und die Annahmekriterien, die festlegen, ob die Arbeit erfolgreich war.
Das ist wichtig, weil die Annahmekriterien die Grundlage für die spätere Prüfung durch die Verifizierungsphase bilden. Eine vage Spezifikation führt zu Arbeit, die schwer zu bewerten ist.
Sie können die Spezifikation auf der Aufgaben- Spezifikation Registerkarte vor Beginn der Ausführung lesen und bearbeiten.
Der Leitfaden zur spezifikationsgesteuerten Entwicklung erklärt, wie Sie testbare Kriterien formulieren, den Umfang abgrenzen und dieselbe Definition von Erfolg über Planung, Implementierung und Überprüfung hinweg beibehalten.
Planen
Für alles außer kleinen Änderungen wird die Spezifikation zu einem Plan: einer geordneten Reihe von Schritten, die in Phasen gruppiert sind. Sie genehmigen den Plan, bevor Code geschrieben wird.
Einen Plan abzulehnen ist kostengünstig und der richtige Schritt, wenn der Ansatz falsch ist. Nach dem Schreiben des Codes zu rejecten ist teuer. In dieser Phase hat Ihr Urteil den größten Einfluss.
Erstellen
Ein Agent kopiert das Repository in einen isolierten Arbeitsbereich und arbeitet dort. Er liest den Code, schreibt die Änderung und erstellt oder aktualisiert die Tests.
Der Arbeitsbereich ist einzeln pro Aufgabe nutzbar und temporär. Die Arbeit eines Agents berührt nie Ihren Standardzweig, und zwei gleichzeitig laufende Aufgaben können die jeweiligen Arbeitsergebnisse nicht einsehen.
Verifizieren
Zuerst läuft Ihr eigenes Testpaket – das ist das stärkste Signal, da es widerspiegelt, was Ihr Team bereits als wichtig erachtet.
Darüber hinaus werden Qualitätsprüfungen ausgeführt, wie Ihre Organisation sie konfiguriert hat: Abdeckungsgrenzwerte, Linting, Browser-Tests gegen eine Vorschau-Bereitstellung und die Sicherheit Schutzmechanismen. Eine blockierende Prüfung stoppt die Aufgabe; eine empfehlende Prüfung protokolliert ein Ergebnis und lässt die Aufgabe fortfahren.
Rezension
Ein Überprüfungsagent liest die Unterschiede wie ein Kollege und erstellt Ergebnisse. Behebbare Ergebnisse werden zur Nachbesserung zurückgesendet; die übrigen werden dem pull request zugeordnet, damit Sie sie sehen können.
Deshalb kommt ein Coroid pull request bereits überprüft bei Ihnen an – nicht um Ihre Überprüfung zu ersetzen, sondern damit Ihre Überprüfung nicht die erste ist.
Pull-Request
Der Zweig wird gepusht und ein pull request wird gegen Ihren Basiszweig geöffnet, wobei die Änderung, die Tests, die Verifizierungsergebnisse und die Überprüfungsergebnisse enthalten sind. Wenn der Code bereits das leistet, was die Aufgabe verlangt, gibt es nichts zu pushen: Die QA überprüft stattdessen den unveränderten Code, und die Aufgabe wird ohne pull request abgeschlossen.
Hier endet die Automatisierung der Coroid-Aufgabe. Das Zusammenführen übernehmen Sie.
Nach dem Zusammenführen
Öffnen Sie Releases um den exakten Commit vorzubereiten, den Sie versenden möchten. Eine Release kann mehrere zusammengeführte Pull-Requests, einen direkten Commit oder Arbeit enthalten, die außerhalb von Coroid zusammengeführt wurde. Die Release-Prüfung und -Freigaben beziehen sich auf diesen Commit und eine bestimmte Umgebung. Ihre Pipeline deployt ihn; Coroid protokolliert einen beobachteten Erfolg oder eine ausdrückliche Bestätigung, bevor es als versendet angezeigt wird. Eine Aufgabe, die als COMPLETED gekennzeichnet ist, oder ein allein zusammengeführter pull request beweisen die Bereitstellung nicht.
Aufgabenstatus
Der Status einer Aufgabe zeigt Ihnen an, wo sie auf dem oben beschriebenen Weg ist:
| Status | Bedeutung |
|---|---|
PENDING | Akzeptiert, wartet auf einen verfügbaren Agentenslot |
IN_PROGRESS | Aktuell in Bearbeitung |
PENDING_REVIEW | Die Arbeit ist fertig und überprüft, wartet auf Integration oder Freigabe |
COMPLETED | Die Aufgabenarbeit ist abgeschlossen; die Bereitstellung wird separat verfolgt |
NEEDS_HUMAN_REVIEW | Coroid kann nicht selbst weiterarbeiten und stellt Ihnen eine Frage. |
PAUSED | Vorübergehend gestoppt, fortsetzbar |
FAILED | Die Ausführung konnte nicht abgeschlossen werden |
CANCELLED | Von Ihnen gestoppt |
WONT_FIX | Absichtlich geschlossen, ohne die Arbeit auszuführen |
Was die Durchlaufrate bestimmt
Ein Agentenslot Ein Task wird jeweils einzeln ausgeführt. Die Slots bestimmen, wie viel Arbeit parallel stattfindet; sie beschleunigen jedoch keinen einzelnen Task. Die Dauer eines Tasks hängt von der Größe der Änderung und der Laufzeit des Test-Suites ab.
Weiter
Rollen der Agenten – welcher Agent welche Arbeitsphase übernimmt. Anschließend sehen Sie... Releases für den Pfad nach dem Merge durch Ihre Umgebungen.