preview-shots について
preview-shotsは、レビュー対象の画像をmacOSのPreviewでまとめて表示するエージェントスキルです。PNGやGIFを選んで順番を整え、各画像に説明を付けることで、関連する結果を一つのウィンドウで確認できます。
主な機能
- 01レビューに必要な画像だけを選択
- 02画像をPreviewでまとめて開く
- 03重要度に応じた画像の並べ替え
- 04各画像に説明を付記
- 05次の作業に進む際のウィンドウ終了
活用シーン
- 01変更直後のスクリーンショットの確認
- 02統合結果と参考画像の比較
- 03保存済みのビジュアル成果物を共有して意見を得る
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dzhng/ skills --skill preview-shotsインストール後、Claude Code で/preview-shotsを入力して読み込まれたか確認します。
詳細
プレビュー画像
レビューが必要な画像を、ユーザーが順に切り替えて確認できるよう、1つのプレビューウィンドウに表示します。
ワークフロー
- 画像を選定する — 「これで合っているか?」の判断に役立つ画像を選びます。直前に変更または承認されたベースライン、統合後の結果、比較対象がある場合は参照画像です。フォルダー内の PNG をすべて表示するのではなく、変更を判断できる最小限のセットを選びます。ユーザーが特定の画像を指定した場合は、その画像だけを開きます。
- ウィンドウは1つにする —
open -a Preview <path> <path> ...を1回実行して開きます。openの呼び出し1回で、すべてのファイルがサムネイルサイドバー付きの1つのウィンドウに表示されます。呼び出しを分けると、別々のウィンドウが開きます。 - キャプションを付ける — 画像ごとに1行で内容を説明し、ユーザーが何を切り替えて見ているのか分かるようにします。
ルール
- macOS のみ(
open)。絶対パスまたはリポジトリルートからの相対パスを指定します。 - ファイルは重要度の高い順に並べます。最初のファイルがプレビューを開いたときに表示されます。
- ライブの Chrome ではなく、レビュー用に保存された PNG/GIF の成果物を確認します。特に指定がなければ、正確なリグレッションキャプチャはヘッドレスで実行します。ユーザーがライブブラウザーを明示的に求めた場合、またはヘッドフルでのみ発生するバグを再現する場合に限り、Chrome を開きます。
- 一度に表示するのは1セットのみ。ウィンドウを増やしてはいけません。 新しいセットを開く前に、開いているウィンドウを閉じます:
osascript -e 'tell application "Preview" to close every window'。 - ユーザーの応答を待たずに先へ進む場合は閉じます。 確認を求めないレビュー用に画像を開いた後、ユーザーの応答を待たずに先へ進む場合は、その後にプレビューを閉じます:
osascript -e 'quit app "Preview"'。夜間の自律実行で、プレビューウィンドウが多数並んだ画面を見てユーザーが目を覚ますことがあってはなりません。開いているセットは最大1つとし、チェックポイントを過ぎたらウィンドウをすべて閉じます。
コメント
Markdown 対応