Dokumentation durchsuchen

Backup-Pack: ZIP-Sicherungen mit Zeitstempel, Wiederherstellung und Rotation

Backup Manager packt dein Projekt zeitgestempelt als ZIP, listet, stellt wieder her und rotiert die Archive mit vier Slash-Befehlen. Installation, fünf Beispiele, Speicherorte, Ausschlüsse, Lücken.

Auf dieser Seite
  1. Wann du es brauchst
  2. Was installiert wird
  3. Schnellstart
  4. Beispiele zum Kopieren
  5. Was es schreibt und wo
  6. Datenflüsse und Voraussetzungen
  7. Grenzen und Stolpersteine

Das Backup-Pack installiert Backup Manager, einen Agenten, der mit einem Befehl eine ZIP-Kopie deines Projekts erstellt, sie mit Datum und Uhrzeit benennt, die Kopien auflistet, auf Wunsch eine wiederherstellt und alte entfernt. Er ist für den Moment vor einer riskanten Änderung, einem großen Refactoring oder einer Migration gedacht, wenn du einen schnellen Rückweg willst, der nicht von der Versionsverwaltung abhängt. Er ist bewusst einfach: Er nutzt die Zip-Werkzeuge deines Betriebssystems und legt die Archive in einem Ordner backups/ im Projekt ab.

Wann du es brauchst

  • Vor einem großen Refactoring, einem Abhängigkeits-Upgrade, einer Datenmigration oder einem Autopilot-Lauf.
  • Für Projekte ohne Versionsverwaltung oder bei denen der nicht eingecheckte Stand zählt.
  • Es ersetzt keine echten Sicherungen: siehe die Grenzen unten.

Was installiert wird

Ein gepacktes Pack in .agents/skills/pack-backup/: die Agentendatei backup-agent.md und eine Workflow-Vorlage templates/backup-workflow.md. Es werden weder Skill noch Datendatei noch Skript mitgeliefert: Der Agent schreibt die Befehle selbst, in PowerShell unter Windows oder Bash unter Linux und macOS, und ersetzt den Platzhalter %PROJECT_ROOT% durch den echten Projektpfad.

Backup-Manager-Menü
BefehlWas er tut
/backupVollsicherung: ein ZIP des ganzen Projekts mit Zeitstempel, mit den Ausschlüssen unten
/backup-listListet die ZIP-Dateien in backups/ auf, neueste zuerst, mit Größe und Datum
/backup-restoreEntpackt ein gewähltes ZIP in einen neuen Ordner restore_<timestamp>/ im Projektstamm
/backup-cleanRotation: behält die letzten N Archive (5, wenn nichts anderes gesagt wird) und löscht den Rest, nachdem er dich gefragt hat

Schnellstart

  1. Das Pack installieren

    Core wird automatisch ergänzt. Für den Installer ist nur Node.js 20 nötig.

    Im Terminal deines Projekts
    npx bmad-plus install --packs backup

  2. Eine erste Sicherung anlegen

    Der Agent findet den Projektstamm, erkennt dein Betriebssystem, legt bei Bedarf backups/ an, baut das Archiv und nennt Name und Größe.

    Im Terminal deines Projekts
    /backup

  3. Den Ordner in der Versionsverwaltung ignorieren

    Die Archive sind gewöhnliche Projektdaten, halte sie also aus Commits heraus (Zeile für die .gitignore).

    Im Terminal deines Projekts
    backups/

Beispiele zum Kopieren

Eine Sicherung mit Zeitstempel anlegen

Führe es vor allem aus, was du eventuell rückgängig machen willst.

In deinem KI-Assistenten
/backup, dann liste auf, was du aus dem Archiv herausgelassen hast, damit ich prüfen kann, dass nichts Wichtiges fehlt.

Das solltest du erhalten Es entsteht die Datei backups/<project>_backup_<yyyyMMdd_HHmmss>.zip, und der Agent nennt Namen und Größe in Megabyte. Im Projektstamm werden node_modules, .git, vendor, backups/, __pycache__ und Dateien ausgeschlossen, die auf *.backup_* passen; diese Liste kann der Agent dir vorlesen.

In normaler Sprache vor einer riskanten Änderung sichern

Du kannst den Agenten beim Namen rufen und in normalen Worten fragen, statt den Slash-Befehl zu tippen.

In deinem KI-Assistenten
Backup Manager, sichere dieses Projekt, bevor ich die Module in src/ umbenenne, und nenne mir die Größe des Archivs.

Das solltest du erhalten Dasselbe Archiv wie bei /backup, mit angezeigter Dateigröße. Die Größe anzuzeigen gehört zu den Regeln des Agenten; unter Linux und macOS gibt der Referenzbefehl nur den Archivnamen aus, der Agent muss die Größe also selbst ergänzen.

Vorhandene Sicherungen auflisten

Nutze es, um zu wählen, welches Archiv du wiederherstellst oder entfernst.

In deinem KI-Assistenten
/backup-list

Das solltest du erhalten Eine Tabelle der *.zip-Dateien in backups/, nach letzter Schreibzeit sortiert (neueste zuerst), mit Name, Größe in Megabyte und Datum.

Wiederherstellen, ohne deine Arbeit zu überschreiben

Die Wiederherstellung geht in einen separaten Ordner, sodass du vergleichen kannst, bevor du etwas zurückkopierst.

In deinem KI-Assistenten
/backup-restore das neueste Archiv

Das solltest du erhalten Das ZIP wird nach restore_<yyyyMMdd_HHmmss>/ im Projektstamm entpackt, und der Agent gibt diesen Pfad aus. Deine aktuellen Dateien bleiben unberührt; kopiere zurück, was du brauchst.

Nur die letzten Sicherungen behalten

Die Rotation löscht Dateien, daher fragt der Agent immer zuerst nach Bestätigung.

In deinem KI-Assistenten
/backup-clean behalte die letzten 3.

Das solltest du erhalten Nach deiner Bestätigung werden Archive, die älter als die drei neuesten sind, aus backups/ gelöscht, und der Agent meldet, wie viele behalten wurden. Ohne Zahl gilt der Standard 5.

Was es schreibt und wo

Vom Pack angelegte Dateien und Ordner
PfadAngelegt vonInhalt
backups//backupDie Archive, benannt <project>_backup_<yyyyMMdd_HHmmss>.zip
restore_<yyyyMMdd_HHmmss>//backup-restoreDie entpackte Kopie eines Archivs

Datenflüsse und Voraussetzungen

  • Windows: PowerShell mit Compress-Archive und Expand-Archive. Linux und macOS: Bash und das Programm zip, das installiert sein muss.
  • Dein Host-Werkzeug muss dem Agenten erlauben, Shell-Befehle auszuführen. Nichts verlässt deinen Rechner: kein Upload, kein Netzwerkaufruf, kein Schlüssel.

Grenzen und Stolpersteine

Warnung Das ist keine Notfall-Sicherung

Die Archive liegen im Projekt, auf demselben Datenträger. Geht er verloren, sind beide weg. Das Pack plant keine Sicherungen, verschlüsselt sie nicht und kopiert sie nirgendwohin. Kopiere wichtige Archive selbst an einen anderen Ort.

Warnung Die Git-Historie ist nicht im Archiv

.git ist ausgeschlossen, eine Wiederherstellung bringt also Dateien zurück, keine Commits oder Branches. Abhängigkeiten in node_modules und vendor sind ebenfalls ausgeschlossen: Installiere sie nach der Wiederherstellung neu.

Hinweis Ausschlüsse nennen Ordner der obersten Ebene

Der PowerShell-Befehl filtert nur die Einträge im Projektstamm, und die Bash-Muster sind für Stammordner geschrieben, die Ausschlüsse gelten also nur im Projektstamm. Ein verschachteltes node_modules (etwa in packages/app/) kann daher im Archiv landen. Achte auf die vom Agenten gemeldete Größe und lass ihn bei Bedarf mehr ausschließen.

Hinweis Zu verwendende Befehlsnamen

Das Menü besteht aus /backup, /backup-list, /backup-restore und /backup-clean. Es gibt keinen Unterbefehl create: /backup allein erstellt das Archiv.

Hinweis Herkunft

Das Pack Universal Backup wurde von Laurent Rochetta bei Oveanet, seiner Firma, geschrieben und in BMAD+ integriert.

Siehe auch