xixu-me/skills

Use este skill para a interface de linha de comando tzst. Padrão para execução quando o usuário claramente deseja uma ação real de arquivamento e os caminhos ou nomes de arquivo necessários já são conhecidos.

Este skill é exclusivamente para CLI. Se o usuário estiver perguntando sobre código Python, como from tzst import ..., trate isso como uma tarefa geral de documentação de biblioteca Python ou API, em vez de usar este skill como guia principal.

Quando Usar

Use este skill quando o usuário:

• mencionar arquivos .tzst ou .tar.zst
• quiser criar, extrair, achatar, listar ou testar um arquivo tzst
• precisar de ajuda para instalar tzst ou escolher flags da CLI
• quiser saída legível por máquina do tzst para scripts ou automação
• precisar de orientação sobre tratamento seguro de conflitos ou filtros de extração

Não use este skill para perguntas genéricas sobre tar, zip ou API Python, a menos que tzst faça parte da solicitação.

Verificação Inicial

1. Verifique se tzst está disponível com tzst --version ou tzst --help.
2. Se estiver ausente, prefira um destes caminhos de instalação:
   • uv tool install tzst
   • pip install tzst
   • um binário de lançamento independente de https://github.com/xixu-me/tzst/releases/latest quando o usuário não quiser uma instalação Python
3. Execute novamente tzst --version ou tzst --help antes de realizar o trabalho real.

Fluxo de Trabalho

1. Decida se a solicitação é execução ou orientação. Solicitações como "arquive esses arquivos", "extraia este backup", "liste o que está dentro", "teste este arquivo" ou "instale tzst" são intenção de execução.
2. Escolha o comando que corresponde à solicitação:
   • a, add, create para criação de arquivo
   • x, extract para extração normal com preservação da estrutura de diretórios
   • e, extract-flat apenas quando o usuário explicitamente quiser saída achatada
   • l, list para inspeção do arquivo
   • t, test para verificações de integridade
3. Se o usuário quiser extrair apenas alguns membros e os nomes dos membros forem incertos, liste primeiro.
4. Carregue references/cli-reference.md quando precisar da matriz de comandos, nomes exatos de flags ou exemplos copiáveis.

Padrões Seguros

• Prefira x em vez de e, a menos que o achatamento seja explicitamente solicitado.
• Mantenha --filter data como modo de extração padrão.
• Use --filter tar apenas quando o usuário precisar de compatibilidade padrão do estilo tar.
• Use --filter fully_trusted apenas quando o usuário disser explicitamente que a fonte do arquivo é totalmente confiável.
• Mantenha a criação atômica de arquivos habilitada. Use --no-atomic apenas quando o usuário o solicitar explicitamente.
• Prefira --streaming para arquivos grandes ou ambientes com memória limitada.
• Para automação ou pipelines, prefira tzst --json --no-banner ....
• Para extração automatizada, exija uma escolha explícita de --conflict-resolution não interativa, como replace_all, skip_all ou auto_rename_all.
• Não combine --json com prompts de conflito interativos.

Notas para Scripts

• Coloque flags globais antes do subcomando em exemplos, como tzst --json --no-banner l archive.tzst.
• Use códigos de saída em scripts: 0 para sucesso, 1 para erros de operação, 2 para erros de análise de argumentos e 130 para interrupção.
• Quando a nomeação do arquivo for importante, informe ao usuário que tzst pode normalizar um destino de criação para .tzst ou .tar.zst.

Erros Comuns

• Usar e quando o usuário esperava que a estrutura de diretórios original fosse preservada
• Recomendar fully_trusted para arquivos de fonte desconhecida ou não confiável
• Esquecer uma estratégia explícita de conflito para extração não interativa
• Tratar uma pergunta sobre API Python como pergunta sobre CLI
• Adivinhar flags com base em hábitos do tar em vez de verificar a referência fornecida ou a ajuda da CLI instalada