Anhang A. Wie das Lehrbuch mit Spec Kit und Kiro zusammenhängt
In diesem Lehrbuch wird ein eigener SDD-Dialekt für Qwen Code verwendet:
mission.md
tech-stack.md
roadmap.md
requirements.md
plan.md
validation.mdDas ist nicht das einzig mögliche Format. Spec Kit und Kiro lösen eine ähnliche Aufgabe, nennen die Artefakte jedoch anders und teilen die Phasen anders auf.
Der Hauptunterschied
Im Lehrbuch ist validation.md in eine separate Datei ausgelagert. Das ist beabsichtigt: Agent und Mensch brauchen eine explizite Menge von Fakten, die entscheidet, ob ein Branch gemergt werden darf.
In anderen Systemen kann diese Idee auf Aufgaben, Checklisten, Plananalysen oder Akzeptanzkriterien verteilt sein.
Zuordnungstabelle
| Lehrbuch | Spec Kit | Kiro | Bedeutung |
|---|---|---|---|
mission.md | Projektverfassung | Steering-Dateien | warum das Projekt existiert |
tech-stack.md | Verfassung und Plan | Steering-Dateien, Design | technische Einschränkungen |
roadmap.md | Reihenfolge der Spezifikationen und Aufgaben | Feature- und Aufgabenliste | Phasenreihenfolge |
requirements.md | /speckit.specify und /speckit.clarify | Requirements | was gebaut werden muss |
plan.md | /speckit.plan und /speckit.tasks | Design und Tasks | wie die Umsetzung aufgeteilt wird |
validation.md | teilweise /speckit.analyze, Checklisten und Aufgaben | Kriterien in Aufgaben und Tests | welche Fakten den Merge erlauben |
QWEN.md | Agent-Regeln für Integration | Steering-Dateien | wie sich der Agent im Projekt verhalten soll |
| Qwen Code Skills | Befehle, Erweiterungen und Presets | Agent Hooks und Steering | wiederholbarer Prozess |
Wie man den Prozess überträgt
Wenn ein Team Spec Kit verwendet, muss man ihm nicht die Dateinamen aus diesem Lehrbuch aufzwingen. Übertragen Sie die Bedeutung:
- die Projektverfassung muss explizit sein;
- Unklarheiten müssen vor dem Plan geklärt werden;
- der Plan muss architektonische Entscheidungen von der Aufgabenliste trennen;
- Prüffakten müssen vor der Umsetzung sichtbar sein;
- die Umsetzung muss mit den Artefakten verglichen werden, nicht mit dem Chat-Verlauf.
Wenn ein Team Kiro verwendet, übertragen Sie drei Ebenen:
- Steering-Dateien für dauerhafte Regeln;
- Specs für konkrete Features;
- Aufgaben und Tests als überprüfbarer Pfad zur Umsetzung.
Warum das Lehrbuch ein eigenes Format hat
Das Format des Lehrbuchs ist bewusst einfacher als industrielle Befehlssätze.
Gründe:
- Dateien sind ohne spezielle CLI-Hilfsmittel leicht lesbar;
- Qwen Code kann direkt mit ihnen arbeiten;
validation.mdmacht die Prüfung zu einem eigenständigen Denkschritt;- die Struktur passt für kleine Projekte und für die Übertragung auf einen anderen Agenten;
- der Leser sieht den Prozess, nicht nur einen Befehl wie
/speckit.implement.
Es gibt auch einen Nachteil: in einem großen Team müssen Vereinbarungen über Merge-Requests, Roadmap-Besitzer, Spec-Reviews und Aufgabenvorlagen hinzugefügt werden. Diese Themen werden in Teil 16 behandelt.
Wie man ein Format wählt
Verwenden Sie das Format des Lehrbuchs, wenn:
- Sie SDD lernen;
- das Projekt klein ist;
- das Team alle Entscheidungen in gewöhnlichen Markdown-Dateien sehen möchte;
- ein plattformunabhängiger Prozess benötigt wird.
Verwenden Sie Spec Kit, wenn:
- das Team fertige Befehle und Vorlagen möchte;
- ein separater Schritt zur Klärung von Unklarheiten benötigt wird;
- Erweiterungen, Presets und wiederholbare Workflows wichtig sind;
- mehrere Projekte vorhanden sind und ein einheitlicher Standard erforderlich ist.
Verwenden Sie Kiro, wenn:
- das Team bereits mit Kiro arbeitet;
- eingebaute Specs, Steering-Dateien und Agent-Hooks benötigt werden;
- eine enge Integration in den IDE-Prozess wichtig ist.
Das Format sollte nicht zur Religion werden. Entscheidend ist, dass Absicht, Plan, Prüfung und Entscheidungen in reviewbaren Artefakten leben.