astro:help — wie man die Pipeline nutzt
Die Pipeline astro: ist eine Sammlung von Skills für die KI-gestützte Entwicklung vom Vertrag bis zum PR/Übergabe, mit einer Code‑Guard (dem Gate), das die Sicherheitsbarrieren durchsetzt. Jeder Skill entspricht einer Phase; verwende sie in der Reihenfolge, rufe aber nur das auf, was du brauchst.
Die Pipeline auf einen Blick
| Phase | Befehl | Wann verwenden |
|---|---|---|
| 0 · Vertrag | astro:setup | Beim Starten/Wiederaufnehmen eines Projekts, bevor Code geschrieben wird. |
| 1 · Planen | astro:plan | Du hast eine Änderung beschrieben und möchtest einen Plan vor der Implementierung. |
| 2 · Ausführen | astro:exec | Führt den gesamten Plan aus, eine Aufgabe nach der anderen. |
| 3 · Abschließen | astro:commit | Erzeuge die Nachricht und committe eine logische Änderung. |
| 3 · Abschließen | astro:pr | Erstelle die Pull‑Request‑Beschreibung. |
| 3 · Abschließen | astro:answer | Übergabetext der Aufgabe für QA/PO (lokale Datei). |
| Gate | astro:gate | Öffne den Gate‑Regeleditor im Browser. |
| Hilfe | astro:help | Diese Anleitung. |
Typischer Ablauf
astro:setup(einmal pro Projekt) — legt den Vertrag inCLAUDE.mdfest (Barrieren + Standards), erkennt den Stack und lädt bei Laravel die Architektur herunter und stellt sicher, dass pro Domain eineAGENTS.mdexistiert. Installiert das Gate: die Mini‑Appai-gate/(SQLite) erzeugt.claude/hooks/astro_gate.pyund registriert den Hook, der verbotene Befehle blockiert.astro:plan— du beschreibst die Änderung; er orientiert sich, fragt nur das, was deine Entscheidung ist (AskUserQuestion), schlägt einen Plan vor und zerlegt ihn nach deiner Zustimmung in Tasks innerhalb der Session (ohne Dateien im Projekt anzulegen).astro:exec— führt den Plan aus, eine Aufgabe nach der anderen, implementiert nur den Umfang, folgt dem Vertrag und der Architektur, mit echten Tests (echte Ausgabe).astro:commit— Nachricht im FormatTYP: Titel+ Liste der Änderungen (deutsch, Partizip Perfekt); ein Commit pro logischer Änderung.- Abschließen:
astro:pr(PR‑Beschreibung) und/oderastro:answer(Übergabetext für QA/PO, in eine lokale, nicht‑commitbare Datei geschrieben).
Das Gate (Code garantiert)
Das Prompt leitet an, das Gate garantiert: jede Befehlsausführung wird inspiziert und blockiert, wenn sie verbotenen Text enthält (migrate:fresh, rm -rf, git push --force, truncate…). Die Regeln sind editierbar:
astro:gate(oderpython3 ai-gate/app.py) öffnet die UI (http://127.0.0.1:8787), um Regeln hinzuzufügen/zu bearbeiten/zu deaktivieren; Gate generieren schreibt.claude/hooks/astro_gate.pyneu.- Das generierte Gate ist standalone – es läuft auch als CLI in der VM/CI:
python3 astro_gate.py "$CMD" && eval "$CMD".
Prinzipien, die in allen Phasen gelten
- Frage nur das, was deine Entscheidung ist; entscheide den Rest (mit sicherem Standard, Hinweis auf die Annahme).
- Überprüfe an der Quelle, erfinde keine API/Route/Spalte/Version.
- Kleine, prüfbare Änderungen; Tests mitgeliefert; echte Evidenz, nicht Behauptung.
- Nichts Destruktives, keine Geheimnisse, keine Abhängigkeiten hochladen – und das Gate verstärkt dies.