写真ウォーターマーク＆リサイザースキル (photo-watermark-resizer)
このスキルは、ブログ投稿用の多数の写真や画像フォルダを一括リサイズ（幅/高さのピクセル調整）し、透過PNGウォーターマークを合成するツールです。 AIエージェントはユーザーのリクエストに応じて、1) CLIスクリプトで即座に自動変換 するか、2) ユーザーがマウスでプレビューを見ながら配置できるGUIアプリを起動 することができます。
実行環境とパス
- Python実行ファイル:
C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe(またはシステムのpython) - CLIスクリプト: cli_resizer.py
- GUIオリジナルプロジェクト:
C:\Users\쭈니\Documents\photo resiging\watermark_resizer.py(実行ファイル:WatermarkResizer.exe) - デフォルトのウォーターマークアセット参照パス (
C:\Users\쭈니\Pictures):C:\Users\쭈니\Pictures\넥스가드서명.pngC:\Users\쭈니\Pictures\넥스가드서명화이트.pngC:\Users\쭈니\Pictures\서명화이트.pngC:\Users\쭈니\Pictures\안산수암점.png
使用方法 (Step-by-Step)
1. AIがバックグラウンドで即座に一括変換する場合 (CLIモード)
ユーザーがフォルダパスとサイズ/ウォーターマークオプションを指定した場合、cli_resizer.py を実行して即座に処理します。
& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈ニ\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" `
--input "<対象フォルダまたはファイルパス>" `
--watermark "<ウォーターマークPNGパス>" `
--width 800 `
--height 600 `
--opacity 80 `
--size 20 `
--margin 3 `
--position "右下" `
--json
主要オプション説明
| オプション | デフォルト値 | 説明 |
|---|---|---|
-i, --input | (必須) | 変換する画像が含まれるフォルダのパス、または単一の画像ファイルパス |
-w, --watermark | なし | 合成するウォーターマークPNGファイルのパス (省略時はリサイズのみ実行) |
-o, --output | 元フォルダ/processed | 結果を保存するフォルダパス (未指定時は各画像フォルダ配下の processed/ に自動保存) |
--width | 800 | 目標の幅 (Width) ピクセルサイズ (0 を指定すると高さ基準でアスペクト比を維持) |
--height | 600 | 目標の高さ (Height) ピクセルサイズ (0 を指定すると幅基準でアスペクト比を維持) |
--no-resize | False | フラグ追加時は元の解像度を維持し、ウォーターマークのみ合成 |
--stretch | False | フラグ追加時はアスペクト比を無視し、指定した width x height に強制合わせ |
--opacity | 80.0 | ウォーターマークの不透明度 (10 ~ 100%) |
--size | 20.0 | 結果画像の幅に対するウォーターマークの幅の割合 (5 ~ 100%) |
--margin | 3.0 | 角の余白の割合 (0 ~ 50%) |
--position | Bottom-Right | 左上(Top-Left), 中央上(Top-Center), 右上(Top-Right), 左中央(Middle-Left), 中央(Center), 右中央(Middle-Right), 左下(Bottom-Left), 中央下(Bottom-Center), 右下(Bottom-Right), カスタム(Custom) |
--custom-x, --custom-y | 95.0 | --position Custom 時の横/縦の相対位置パーセント (0 ~ 100%) |
--no-recursive | False | サブフォルダの探索を無効にし、最上位フォルダの画像のみ変換 |
--json | False | 処理結果をAIが解析しやすいJSON形式で出力 |
2. ユーザーがマウスでウォーターマークを直接配置したい場合 (GUIモード)
ユーザーが「ウィンドウを開いて」「プレビューで直接位置を調整したい」とリクエストした場合、--gui オプションでデスクトップアプリを起動します:
& "C:\Users\쭈니\AppData\Local\Programs\Python\Python313\python.exe" "C:\Users\쭈니\.gemini\config\skills\photo-watermark-resizer\scripts\cli_resizer.py" --gui
結果の検証 (Verification)
- コマンド実行後、出力されたJSONの
"status": "success"および"processed"の件数を確認します。 - 指定された対象フォルダ内の
processed/サブフォルダに変換された画像が生成されていることを確認し、ユーザーに保存先パスと処理件数を通知します。