mcpField
Z
zip-handler

zip-handler

github.com/bluebagaiドキュメント3355 回インストール32 週間前に更新
リポジトリ

zip-handler について

Python スクリプトを使って、ZIP ファイルの展開、内容の編集、再圧縮を行う手順を示すスキルです。アーカイブを処理し、ダウンロードリンクを返すエージェント向けです。

主な機能

  1. 01既定または指定先への展開
  2. 02ファイルやフォルダーの ZIP 化
  3. 03出力アーカイブ名の指定
  4. 04展開・編集・再圧縮の手順

活用シーン

  1. 01編集のための ZIP 展開
  2. 02アーカイブ内ファイルの更新
  3. 03ダウンロード用のファイルやフォルダーの圧縮

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bluebagai/skills --skill zip-handler

インストール後、Claude Code で/zip-handlerを入力して読み込まれたか確認します。

同梱ファイルscripts/pack.pyscripts/unpack.py

詳細

概要

Python スクリプトを使って zip ファイルを扱う手順は以下のとおりです。この手順に従ってください。

a. ユーザーが zip ファイルを希望する場合:

  1. 「pack」bash スクリプト(以下を参照)を使って、ファイルまたはフォルダーを zip にまとめます。
  2. zip ファイルのダウンロードリンクを作成します。
  3. ダウンロードリンクをユーザーに返します。

b. zip ファイル内の内容を変更したい場合:

  1. 「unpack」bash スクリプト(以下を参照)を使って、ファイルを解凍します。
  2. テキストエディターまたは bash ツールでファイルを開き、必要な変更を加えます。
  3. 完了したら、再度「pack」bash スクリプトを使って、すべてのファイルを zip にまとめます。
  4. zip ファイルの新しいダウンロードリンクを作成します。
  5. 新しいリンクを相手に送ります。
  • 以上です。手順をひとつずつ進めてください。

Zip ファイルの解凍/展開

基本的な使い方
python scripts/unpack.py <path_to_zip_file>

これにより、zip ファイルの内容が、zip ファイル名(.zip 拡張子を除く)と同じ名前のディレクトリーに展開されます。

例
# Extract archive.zip to ./archive/
python scripts/unpack.py archive.zip

# Extract to a specific output directory
python scripts/unpack.py archive.zip -o my_output_folder

# Extract with absolute path
python scripts/unpack.py /path/to/files/data.zip

# View help and all options
python scripts/unpack.py --help
オプション
  • zip_path(必須):解凍する zip ファイルのパス
  • -o、--output:出力先ディレクトリーを指定します(デフォルト:拡張子を除いた zip ファイル名)

Zip ファイルの圧縮/作成

基本的な使い方
python scripts/pack.py <path_to_folder_or_file>

これにより、ソースと同じ名前に .zip 拡張子を付けた zip ファイルが作成されます。

例
# Zip a folder (creates my_folder.zip)
python scripts/pack.py my_folder

# Zip a single file (creates document.txt.zip)
python scripts/pack.py document.txt

# Create zip with custom name
python scripts/pack.py my_folder -o archive.zip

# Custom name without .zip extension (will be added automatically)
python scripts/pack.py my_folder -o archive

# Zip with absolute path
python scripts/pack.py /path/to/my_folder -o backup.zip

# View help and all options
python scripts/pack.py --help
オプション
  • source_path(必須):zip にまとめるフォルダーまたはファイルのパス
  • -o、--output:出力する zip ファイル名を指定します(デフォルト:ソース名 + .zip)

コメント