xixu-me/skills

このスキルは tzst コマンドラインインターフェース用です。ユーザーが明らかにアーカイブ操作を望んでおり、必要なパスやアーカイブ名が既にわかっている場合は、デフォルトで実行します。

このスキルは CLI 専用です。ユーザーが from tzst import ... のような Python コードについて尋ねている場合は、それを一般的な Python ライブラリまたは API ドキュメントのタスクとして扱い、このスキルを主要なガイドとして使用しないでください。

使用する場面

以下の場合にこのスキルを使用します：

• ユーザーが .tzst または .tar.zst アーカイブに言及している
• .tzst アーカイブの作成、展開、フラット展開、一覧表示、テストを希望している
• tzst のインストールや CLI フラグの選択についてヘルプが必要な場合
• スクリプトや自動化のために機械可読な tzst 出力が必要な場合
• 安全な競合ハンドリングや抽出フィルタのガイダンスが必要な場合

リクエストに tzst が実際に含まれていない限り、一般的な tar、zip、または Python API の質問にはこのスキルを使用しないでください。

事前確認

1. tzst --version または tzst --help で tzst が利用可能か確認します。
2. 利用できない場合は、以下のインストール方法のいずれかを推奨します：
   • uv tool install tzst
   • pip install tzst
   • ユーザーが Python インストールを望まない場合は、https://github.com/xixu-me/tzst/releases/latest のスタンドアロンリリースバイナリ
3. 実際の作業を行う前に、tzst --version または tzst --help を再実行します。

ワークフロー

1. リクエストが実行かガイダンスかを判断します。 「これらのファイルをアーカイブして」「このバックアップを展開して」「中身を表示して」「このアーカイブをテストして」「tzst をインストールして」などのリクエストは実行意図です。
2. リクエストに一致するコマンドを選択します：
   • a、add、create：アーカイブ作成用
   • x、extract：ディレクトリ構造を保持した通常の展開用
   • e、extract-flat：ユーザーが明示的にフラット出力を希望する場合のみ
   • l、list：アーカイブの検査用
   • t、test：整合性チェック用
3. ユーザーが少数のメンバーのみを展開したいが、メンバー名が不明な場合は、最初に一覧表示します。
4. コマンドマトリックス、正確なフラグ名、コピペ用の例が必要な場合は、references/cli-reference.md を読み込んでください。

安全なデフォルト

• フラット展開が明示的に要求されていない限り、e よりも x を優先します。
• デフォルトの抽出モードとして --filter data を維持します。
• --filter tar は、ユーザーが標準の tar スタイル互換性を必要とする場合にのみ使用します。
• --filter fully_trusted は、ユーザーがアーカイブソースを完全に信頼していると明示した場合にのみ使用します。
• アトミックなアーカイブ作成を有効にしたままにします。ユーザーが明示的に希望する場合にのみ --no-atomic を使用します。
• 大規模アーカイブやメモリ制約のある環境では --streaming を優先します。
• 自動化やパイプラインでは、tzst --json --no-banner ... を優先します。
• 自動抽出では、replace_all、skip_all、auto_rename_all などの明示的な非対話型 --conflict-resolution の選択を必須とします。
• --json と対話型の競合プロンプトを組み合わせないでください。

スクリプト作成の注意点

• 例では、サブコマンドの前にグローバルフラグを配置します（例：tzst --json --no-banner l archive.tzst）。
• スクリプトでは終了コードを使用します：0 は成功、1 は操作エラー、2 は引数解析エラー、130 は中断を示します。
• アーカイブ名が重要な場合、tzst が作成ターゲットを .tzst または .tar.zst に正規化する可能性があることをユーザーに伝えてください。

よくある間違い

• ユーザーが元のディレクトリ構造の保持を期待しているのに e を使用する
• 未知または信頼できないソースからのアーカイブに fully_trusted を推奨する
• 非対話型抽出で明示的な競合戦略を忘れる
• Python API の質問を CLI の質問として扱う
• バンドルされたリファレンスやインストール済みの CLI ヘルプを確認せずに、tar の習慣からフラグを推測する