mcpField
P
preview-shots

preview-shots

github.com/dzhng生産性1.4k260 回インストール今日更新
リポジトリ

preview-shots について

preview-shotsは、レビュー対象の画像をmacOSのPreviewでまとめて表示するエージェントスキルです。PNGやGIFを選んで順番を整え、各画像に説明を付けることで、関連する結果を一つのウィンドウで確認できます。

主な機能

  1. 01レビューに必要な画像だけを選択
  2. 02画像をPreviewでまとめて開く
  3. 03重要度に応じた画像の並べ替え
  4. 04各画像に説明を付記
  5. 05次の作業に進む際のウィンドウ終了

活用シーン

  1. 01変更直後のスクリーンショットの確認
  2. 02統合結果と参考画像の比較
  3. 03保存済みのビジュアル成果物を共有して意見を得る

インストール

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

$npx skills add https://github.com/dzhng/skills --skill preview-shots

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

詳細

プレビュー画像

レビューが必要な画像を、ユーザーが順に切り替えて確認できるよう、1つのプレビューウィンドウに表示します。

ワークフロー

  1. 画像を選定する — 「これで合っているか?」の判断に役立つ画像を選びます。直前に変更または承認されたベースライン、統合後の結果、比較対象がある場合は参照画像です。フォルダー内の PNG をすべて表示するのではなく、変更を判断できる最小限のセットを選びます。ユーザーが特定の画像を指定した場合は、その画像だけを開きます。
  2. ウィンドウは1つにする — open -a Preview <path> <path> ... を1回実行して開きます。open の呼び出し1回で、すべてのファイルがサムネイルサイドバー付きの1つのウィンドウに表示されます。呼び出しを分けると、別々のウィンドウが開きます。
  3. キャプションを付ける — 画像ごとに1行で内容を説明し、ユーザーが何を切り替えて見ているのか分かるようにします。

ルール

  • macOS のみ(open)。絶対パスまたはリポジトリルートからの相対パスを指定します。
  • ファイルは重要度の高い順に並べます。最初のファイルがプレビューを開いたときに表示されます。
  • ライブの Chrome ではなく、レビュー用に保存された PNG/GIF の成果物を確認します。特に指定がなければ、正確なリグレッションキャプチャはヘッドレスで実行します。ユーザーがライブブラウザーを明示的に求めた場合、またはヘッドフルでのみ発生するバグを再現する場合に限り、Chrome を開きます。
  • 一度に表示するのは1セットのみ。ウィンドウを増やしてはいけません。 新しいセットを開く前に、開いているウィンドウを閉じます:osascript -e 'tell application "Preview" to close every window'。
  • ユーザーの応答を待たずに先へ進む場合は閉じます。 確認を求めないレビュー用に画像を開いた後、ユーザーの応答を待たずに先へ進む場合は、その後にプレビューを閉じます:osascript -e 'quit app "Preview"'。夜間の自律実行で、プレビューウィンドウが多数並んだ画面を見てユーザーが目を覚ますことがあってはなりません。開いているセットは最大1つとし、チェックポイントを過ぎたらウィンドウをすべて閉じます。

コメント