wd-clip-image

name	wd-clip-image
description	画像の一部を切り出す。全体から注目したい場所だけを取り出して、そこに集中するための道具。
argument-hint	<画像パス> [--grid-cell col row N | --rect x y w h]

/wd-clip-image — 画像の一部を切り出す

全体を見ていると目が滑る。「ここだけ見たい」を切り出して、そこに集中する。annotate-grid とセットで使う。

引数

• $ARGUMENTS: <画像パス> [出力パス] [options]
  • 例: /wd-clip-image tmp/photo.png --grid-cell 3 2 8
  • 例: /wd-clip-image tmp/photo.png tmp/clip.png --rect 100 200 400 300
  • 省略時: 使い方を表示する

手順

引数なしの場合

使い方を表示する:

clip-image <input> <output> --rect x y width height
clip-image <input> <output> --grid-cell col row N
clip-image <input> <output> --grid-range col1 row1 col2 row2 N

クリップ領域（いずれか1つ必須）:
  --rect x y width height          ピクセル座標で矩形指定（左上原点）
  --grid-cell col row N            annotate-grid --divide N と同じ分割で1セル切り出す
  --grid-range col1 row1 col2 row2 N  (col1,row1) から (col2,row2) までの範囲を切り出す
                                    col, row は 0-origin（左上が 0,0）

引数ありの場合

1. 画像がワーキングディレクトリ配下にあるか確認する

   • なければ tmp/ にコピーする（annotate-grid と同じ手順）

2. 出力パスを決定する

   • 引数に出力パスがあればそれを使う
   • なければ tmp/clip-<ファイル名>.png を自動設定

3. コマンドを実行する

   ${CLAUDE_SKILL_DIR}/tools/clip-image tmp/<input>.png tmp/<output>.png <options>
   

4. 結果を報告する

   • 出力画像を Read ツールで表示する
   • 切り出しサイズ（px）を表示する

典型的な連携フロー

1. /annotate-grid tmp/photo.png --divide 4
   → tmp/annotated-photo.png で座標確認
2. 注目セルが (2,1) と判明
3. /clip-image tmp/photo.png --grid-cell 2 1 4
   → tmp/clip-photo.png（注目領域のみ）
4. 切り出した画像をさらに詳細確認

注意事項

• ツール実体は ${CLAUDE_SKILL_DIR}/tools/clip-image（Mach-O ARM64 バイナリ、ソース: clip-image.swift）
• 入出力は tmp/ 配下を使う
• --grid-cell の col/row は 0-origin かつ N 未満
• --rect の座標は左上原点（y は下向き増加）
• 切り出すのは元画像（annotated じゃない方）から。グリッド線入りを clip するとノイズになる

コツ（使いながら育てる）

• 切り出すのは元画像（annotated じゃない方）から。 グリッド線入りの画像を clip すると線がノイズになる。annotated で座標を確認して、clip は元画像に対して実行する
• 1段目 clip（512x384）がスイートスポット。 2段目（128x96）だとほぼ何も見えない。2段目が必要なら --rect で広めに指定する
• --grid-range が一番使いやすい。 --divide 8 で細かくグリッド → --grid-range col1 row1 col2 row2 8 で注目エリアを範囲指定。rect のピクセル座標計算が不要になる
• 「探す」と「味わう」は別。 grid で「どこに何がいるか」を探して、clip で「その質感や表情」を味わう。探す段階では grid-cell でざっくり、味わう段階では対象が画面いっぱいになるように調整

入力: $ARGUMENTS