画像処理加工
既存画像に対して確定処理を行います:リサイズ/クロップ/パディング/フォーマット変換/圧縮/透かし/角丸/結合/サムネイル生成。 すべての操作は
skills/shared/scripts/image_ops.py(純粋な Pillow)を経由し、即興でスクリプトを書くことはありません。
入力
- 1 枚または複数の、すでに存在する画像ファイルのパス(PNG/JPG/WebP など Pillow がサポートする形式)
- 目標とする操作とパラメータ(サイズ、比率、品質、透かしテキスト、結合方法など)
出力
- 処理後の画像ファイル(パスはユーザーが指定するか、デフォルトで
outputs/テーマ名/に出力) - 各コマンドは
✅ パス (幅x高さ, サイズKB)を表示;infoは JSON を出力
境界線(card-* との明確な区別)
- card-quote / card-xiaohongshu / poster-hero / comparison-card = デザインして新しい画像をレンダリング(HTML→スクリーンショット)
- image-editing = 既存画像を加工。ビジュアルデザインは行わず、コンテンツ生成もせず、ピクセルレベルの処理のみ実施
- 「データやテキストから画像を生成する」必要がある場合 → chart / infographic / card-* を使用。このスキルは既存の画像ファイルのみ扱います
実行手順
- 入力画像が存在することを確認し、目標操作とパラメータを明確にする
- プロジェクトルートから
image_ops.pyの対応サブコマンドを実行(下記参照) - プラットフォームサイズが必要な場合、
references/platform-sizes.mdで推奨アスペクト比/ピクセルを確認する - 出力パスとサイズを報告する。複数の操作を連続して実行可能(例:リサイズ後に圧縮)
コマンド一覧
スクリプトパスは固定で skills/shared/scripts/image_ops.py。すべてのサブコマンドで -h によりパラメータを確認できます。
# リサイズ:幅/高さ/パーセント指定、--keep-ratio でアスペクト比保持
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio
# クロップ:座標指定 または 中央クロップで指定サイズに
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080
# パディング(ソーシャルメディア適応の中核):任意の画像を 1:1 / 9:16 / 16:9 にパディング
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"
# フォーマット変換 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85
# 圧縮:品質指定 または 目標ファイルサイズ上限に近づける(jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200
# 透かし:テキスト(位置・透明度・フォントサイズ・色、自動でシステムの中華フォントを検索)または画像(右下など)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@アカウント名" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8
# 角丸(透明PNG出力);--radius-percent 50 で円形
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50
# 複数画像の結合:横並び/縦並び/グリッド NxM(列x行)、--cell-width/height でセルサイズ統一
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540
# サムネイル(最長辺ピクセル指定)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256
# 画像情報取得(JSON:サイズ/形式/アスペクト比/ファイルサイズ/アルファチャンネル)
python skills/shared/scripts/image_ops.py info -i in.jpg
ドメイン知識:プラットフォーム推奨サイズ
一般的なプラットフォームの推奨サイズは references/platform-sizes.md にあります。頻出の覚え書き:
- 小红书(小紅書)縦型図文:1080×1440(3:4);小红书動画/縦型ポスター:1080×1920(9:16)
- WeChat(微信)朋友圈単画像 / 汎用正方形:1:1(例 1080×1080)
- 横型名言/カバー:16:9(例 1920×1080);WeChat 公式アカウントヘッダー 900×383
- Weibo(微博)添付画像:1:1 または 4:3;Douyin(抖音)/ 微信视频号カバー:9:16(1080×1920)
適応の考え方:優先して pad(余白を追加、画像を切らず変形しない)で画を保全;全面にしたい場合は crop で中央を目標アスペクト比にクロップ;単にファイルサイズを小さくしたい場合は resize / compress を使用。
プロファイル対応
- プロファイルあり:透かしテキストはデフォルトでアカウント名/ハンドルに;出力アスペクト比はデフォルトでメインプラットフォームに合わせる(例:小红书アカウントのデフォルトは 1080×1440)
- プロファイルなし:ユーザーが明示的に指定したパラメータで実行。出力アスペクト比はデフォルトで元画像を保持、透かしはユーザーがテキストを指定する必要あり
依存関係とエラーハンドリング
- 依存:Pillow(インストール済み、
python -c "import PIL"で確認可)、純粋な標準ライブラリ、その他サードパーティなし - スクリプト内蔵の境界チェック:ファイルが存在しない/クロップ枠が画像範囲を超える/不正なアスペクト比や色 → 終了コード 2 で
ERROR:を表示 - システムに中国語フォントがない場合、PIL のデフォルトフォントにフォールバックし
WARNを表示。--fontでフォントを指定可能 - 自己診断:
python skills/shared/scripts/image_ops.py --selftest