xixu-me/skills

Utilisez cette compétence pour l'interface en ligne de commande tzst. Par défaut, passez à l'exécution lorsque l'utilisateur souhaite clairement une action d'archivage réelle et que les chemins requis ou les noms d'archives sont déjà connus.

Cette compétence est réservée à la CLI. Si l'utilisateur pose des questions sur du code Python comme from tzst import ..., traitez cela comme une tâche générale de documentation de bibliothèque ou d'API Python plutôt que d'utiliser cette compétence comme guide principal.

Quand utiliser

Utilisez cette compétence lorsque l'utilisateur :

• mentionne les archives .tzst ou .tar.zst
• souhaite créer, extraire, aplatir, lister ou tester une archive tzst
• a besoin d'aide pour installer tzst ou choisir des indicateurs CLI
• souhaite une sortie tzst lisible par machine pour les scripts ou l'automatisation
• a besoin de conseils sur la gestion sécurisée des conflits ou les filtres d'extraction

N'utilisez pas cette compétence pour des questions génériques sur tar, zip ou l'API Python, sauf si tzst fait réellement partie de la demande.

Pré-vérification

1. Vérifiez si tzst est disponible avec tzst --version ou tzst --help.
2. S'il est manquant, privilégiez l'un de ces chemins d'installation :
   • uv tool install tzst
   • pip install tzst
   • un binaire autonome depuis https://github.com/xixu-me/tzst/releases/latest lorsque l'utilisateur ne souhaite pas une installation Python
3. Réexécutez tzst --version ou tzst --help avant de faire un travail réel.

Flux de travail

1. Déterminez si la demande est une exécution ou un guidage. Les demandes comme "archive ces fichiers", "extrais cette sauvegarde", "liste ce qu'il y a à l'intérieur", "teste cette archive" ou "installe tzst" sont des intentions d'exécution.
2. Choisissez la commande qui correspond à la demande :
   • a, add, create pour la création d'archive
   • x, extract pour une extraction normale avec préservation de la structure des répertoires
   • e, extract-flat uniquement lorsque l'utilisateur souhaite explicitement une sortie aplatie
   • l, list pour l'inspection de l'archive
   • t, test pour les vérifications d'intégrité
3. Si l'utilisateur souhaite extraire seulement quelques membres et que les noms des membres sont incertains, listez d'abord.
4. Chargez references/cli-reference.md lorsque vous avez besoin de la matrice des commandes, des noms exacts des indicateurs ou d'exemples copiables.

Valeurs par défaut sûres

• Préférez x à e sauf si l'aplatissement est explicitement demandé.
• Conservez --filter data comme mode d'extraction par défaut.
• Utilisez --filter tar uniquement lorsque l'utilisateur a besoin de la compatibilité standard de style tar.
• Utilisez --filter fully_trusted uniquement lorsque l'utilisateur déclare explicitement que la source de l'archive est totalement fiable.
• Maintenez la création atomique d'archive activée. N'utilisez --no-atomic que lorsque l'utilisateur le demande explicitement.
• Préférez --streaming pour les grandes archives ou les environnements à mémoire limitée.
• Pour l'automatisation ou les pipelines, préférez tzst --json --no-banner ....
• Pour l'extraction automatisée, exigez un choix explicite non interactif de --conflict-resolution comme replace_all, skip_all, ou auto_rename_all.
• Ne combinez pas --json avec une invitation interactive de conflit.

Notes de script

• Placez les indicateurs globaux avant la sous-commande dans les exemples, comme tzst --json --no-banner l archive.tzst.
• Utilisez les codes de sortie dans les scripts : 0 pour succès, 1 pour erreurs d'opération, 2 pour erreurs d'analyse des arguments, et 130 pour interruption.
• Lorsque le nom de l'archive est important, dites à l'utilisateur que tzst peut normaliser une cible de création en .tzst ou .tar.zst.

Erreurs courantes

• Utiliser e alors que l'utilisateur s'attendait à ce que la structure de répertoires d'origine soit préservée
• Recommander fully_trusted pour des archives provenant d'une source inconnue ou non fiable
• Oublier une stratégie de conflit explicite pour une extraction non interactive
• Traiter une question sur l'API Python comme une question CLI
• Deviner les indicateurs à partir des habitudes tar au lieu de vérifier la référence fournie ou l'aide CLI installée