Spezifikationen
Der Spezifikationen-Reiter enthält Entwicklungsspezifikationen — normalisierte, versionierte Beschreibungen einer Entwicklung, aus denen sowohl der Agent als auch die Menschen im Team arbeiten. Eine Spezifikation ist die gemeinsame Quelle der Wahrheit für ein Stück Arbeit: was gebaut wird, warum und nach welchen Regeln. Spezifikationen werden von der Rolle „Spezifikation" im Chat erzeugt — siehe Entwickler-Rollen.
Wozu eine Spezifikation dient#
Eine Spezifikation verwandelt eine lose Anforderung in eine normalisierte, versionierte Beschreibung, gegen die der Agent umsetzen und die ein Mensch prüfen kann. Jede Spezifikation ist eine Familie mit einer stabilen spec_id, die über jede Version gleich bleibt — sodass die Historie ein durchgehender Strang ist, während sich die Spezifikation weiterentwickelt, und Links darauf nie brechen. Wenn Sie dem Agenten eine Spezifikation zur Umsetzung übergeben (auch im autonomen Modus), arbeitet er aus dieser stabilen, versionierten Definition statt aus einer einmaligen Chat-Nachricht.
Die Spezifikationsliste#
Die linke Seite listet Ihre Spezifikations-Familien. Jeder Eintrag zeigt:
- Den Titel der Spezifikation.
- Ein Status-Badge.
- v{version} — die aktuelle Version.
- {n} Versionen — wie viele Versionen existieren.
Wenn ein Projekt noch keine Spezifikationen hat, zeigt die Liste:
Noch keine Spezifikationen — nutzen Sie die Rolle „Spezifikation" im Chat, um eine zu erstellen.
Wählen Sie links eine Familie, um sie zu öffnen.
Die Familienansicht#
Das Öffnen einer Familie zeigt drei Unterreiter:
| Unterreiter | Was er zeigt | Wann verfügbar |
|---|---|---|
| Aktuell | Die aktuelle Version, aus Markdown gerendert | Immer |
| Versionen (N) | Jede Version, mit Änderungszusammenfassungen pro Version | Immer |
| Vergleichen | Ein Diff zweier Versionen nebeneinander | Nur mit 2 oder mehr Versionen (sonst deaktiviert) |
Aktuell#
Der Unterreiter Aktuell rendert die neueste Version der Spezifikation als formatiertes Markdown. Admins erhalten Steuerelemente zur Verwaltung der Spezifikation:
| Steuerelement | Was es tut |
|---|---|
| Bearbeiten | Die aktuelle Version zum Bearbeiten öffnen. |
| Speichern | Ihre Änderungen speichern. |
| Abbrechen | Ihre Änderungen verwerfen und den Bearbeitungsmodus verlassen. |
| Familie umbenennen | Den Titel der Spezifikation ändern. Die spec_id bleibt gleich. |
| Löschen | Die gesamte Familie und alle ihre Versionen löschen. |
Löschen entfernt die gesamte Spezifikationsfamilie — jede Version, nicht nur die aktuelle. Es gibt kein Löschen pro Version; das ist Alles-oder-nichts.
Versionen (N)#
Der Unterreiter Versionen zeigt die vollständige Historie:
- Eine Versionsleiste, die jede Version nach Tag auflistet. Eine Version mit einer Änderungszusammenfassung ist mit einem Punkt markiert.
- Eine Box „Änderungen in v{v}", die beschreibt, was sich in der ausgewählten Version geändert hat.
- Der Inhalt der ausgewählten Version.
Nutzen Sie dies, um jede frühere Version genau so zu lesen, wie sie war, und um den Verlauf zu sehen, wie sich die Spezifikation entwickelt hat.
Vergleichen#
Der Unterreiter Vergleichen zeigt einen Diff zwischen zwei beliebigen Versionen. Er benötigt mindestens zwei Versionen, um verfügbar zu sein.
| Steuerelement | Was es tut |
|---|---|
| Von | Die Basisversion wählen, von der aus verglichen wird. |
| Bis | Die Version wählen, mit der verglichen wird. |
| Diff-Ansicht | Zeigt Hinzufügungen und Entfernungen mit einer + / −-Randspalte. |
| Box „Was sich geändert hat" | Eine Zusammenfassung der Unterschiede zwischen den beiden gewählten Versionen. |
Wie Spezifikationen entstehen#
Sie schreiben Spezifikationen hier nicht von Grund auf von Hand — Sie erzeugen sie mit der Rolle „Spezifikation" im Chat. Beschreiben Sie dem Agenten die Anforderung in dieser Rolle, und er erstellt eine normalisierte Spezifikation, die dann als Familie auf diesem Reiter erscheint. Admins können sie danach mit Bearbeiten / Speichern verfeinern, und jede bedeutsame Änderung wird zu einer neuen Version mit eigener Änderungszusammenfassung.
Wie es weitergeht#
- Entwickler-Rollen — einschließlich der Rolle „Spezifikation", die Spezifikationen erzeugt.
- Chat — wo Sie eine Rolle wählen und eine Spezifikation erstellen.
- Autonomer Modus — dem Agenten eine Spezifikation übergeben und ihn unbeaufsichtigt arbeiten lassen.
- Methodik — die Regeln und das Wissen, die der Agent bei der Umsetzung einer Spezifikation anwendet.