xixu-me/skills

Nutze dieses Skill für die tzst-Befehlszeilenschnittstelle. Standardmäßig zur Ausführung übergehen, wenn der Benutzer eindeutig eine echte Archivaktion wünscht und die erforderlichen Pfade oder Archivnamen bereits bekannt sind.

Dieses Skill ist nur für die CLI. Wenn der Benutzer nach Python-Code wie from tzst import ... fragt, behandele dies als allgemeine Python-Bibliotheks- oder API-Dokumentationsaufgabe, anstatt dieses Skill als Hauptanleitung zu verwenden.

Wann verwenden

Verwende dieses Skill, wenn der Benutzer:

• .tzst- oder .tar.zst-Archive erwähnt
• ein tzst-Archiv erstellen, extrahieren, flach extrahieren, auflisten oder testen möchte
• Hilfe bei der Installation von tzst oder der Auswahl von CLI-Flags benötigt
• maschinenlesbare tzst-Ausgabe für Skripterstellung oder Automatisierung wünscht
• eine sichere Konflikthandhabung oder Extraktionsfilter-Anleitung benötigt

Verwende dieses Skill nicht für allgemeine tar-, zip- oder Python-API-Fragen, es sei denn, tzst ist tatsächlich Teil der Anfrage.

Vorbereitung

1. Überprüfe, ob tzst mit tzst --version oder tzst --help verfügbar ist.
2. Falls es fehlt, bevorzuge einen dieser Installationspfade:
   • uv tool install tzst
   • pip install tzst
   • ein separates Release-Binärpaket von https://github.com/xixu-me/tzst/releases/latest, wenn der Benutzer keine Python-Installation wünscht
3. Führe tzst --version oder tzst --help erneut aus, bevor du mit der eigentlichen Arbeit beginnst.

Workflow

1. Entscheide, ob die Anfrage eine Ausführung oder eine Anleitung ist. Anfragen wie „diese Dateien archivieren“, „dieses Backup extrahieren“, „zeigen, was drin ist“, „dieses Archiv testen“ oder „tzst installieren“ sind Ausführungsabsichten.
2. Wähle den Befehl, der zur Anfrage passt:
   • a, add, create für die Archivierung
   • x, extract für normale Extraktion mit beibehaltener Verzeichnisstruktur
   • e, extract-flat nur, wenn der Benutzer explizit eine flache Ausgabe wünscht
   • l, list zur Archivprüfung
   • t, test für Integritätsprüfungen
3. Wenn der Benutzer nur wenige Mitglieder extrahieren möchte und die Mitgliedsnamen unsicher sind, liste zuerst auf.
4. Lade references/cli-reference.md, wenn du die Befehlsmatrix, genauen Flag-Namen oder Kopier-Einfüge-Beispiele benötigst.

Sichere Standardeinstellungen

• Bevorzuge x gegenüber e, es sei denn, die flache Extraktion wird explizit angefordert.
• Behalte --filter data als Standard-Extraktionsmodus bei.
• Verwende --filter tar nur, wenn der Benutzer standardmäßige tar-Kompatibilität benötigt.
• Verwende --filter fully_trusted nur, wenn der Benutzer explizit angibt, dass die Archivquelle vollständig vertrauenswürdig ist.
• Behalte die atomare Archiverstellung bei. Greife nur auf --no-atomic zurück, wenn der Benutzer dies explizit wünscht.
• Bevorzuge --streaming für große Archive oder speicherbeschränkte Umgebungen.
• Für Automatisierung oder Pipelines bevorzuge tzst --json --no-banner ....
• Für automatisierte Extraktion erfordere eine explizite nicht-interaktive --conflict-resolution-Auswahl wie replace_all, skip_all oder auto_rename_all.
• Kombiniere --json nicht mit interaktiver Konfliktabfrage.

Hinweise zur Skripterstellung

• Setze globale Flags vor den Unterbefehl in Beispielen, z. B. tzst --json --no-banner l archive.tzst.
• Verwende Exit-Codes in Skripten: 0 für Erfolg, 1 für Betriebsfehler, 2 für Argumentparsungsfehler und 130 für Unterbrechung.
• Wenn die Archivbenennung wichtig ist, teile dem Benutzer mit, dass tzst ein Erstellungsziel auf .tzst oder .tar.zst normalisieren kann.

Häufige Fehler

• Verwenden von e, wenn der Benutzer erwartet, dass die ursprüngliche Verzeichnisstruktur erhalten bleibt
• Empfehlen von fully_trusted für Archive aus unbekannter oder nicht vertrauenswürdiger Quelle
• Vergessen einer expliziten Konfliktstrategie für die nicht-interaktive Extraktion
• Behandeln einer Python-API-Frage als CLI-Frage
• Raten von Flags aus tar-Gewohnheiten, anstatt die gebündelte Referenz oder die installierte CLI-Hilfe zu überprüfen