Communitygithub.com

adobe/skills — 写真と動画のリサイズ

Adobeツールを使って、写真や動画を正確なピクセル寸法やアスペクト比にリサイズします。

skills — 写真と動画のリサイズ とは?

このスキルは、ユーザーが画像や動画ファイルのリサイズ、スケーリング、寸法変更を要求した際に、Adobe Creative Cloudツールを介してこれを実行します。「1920×1080にリサイズ」「4Kにして」「アスペクト比を16:9に変更」などの自然言語での指示を解釈し、画像には`image_crop_and_resize`、動画には`video_resize`という専用ツールを適切に呼び出します。画像ワークフローはリフレーム(切り抜き)、パッド(レターボックス)、抽出(被写体分離)のフィットモードと、被写体、顔、上半身、名前付きオブジェクトを中心にしたスマートフォーカスをサポートします。動画ワークフローはレターボックス、クロップ、ストレッチモードをサポートし、複数の解像度(4K、1080p、720pなど)にリサイズ可能です。また、バッチ処理やCreative Cloudへの保存、Fireflyボードの作成も統合されており、クリエイティブ資産の一括管理・共有を効率化します。A4印刷用の300DPI設定や、カスタム寸法にも対応し、プロフェッショナルなワークフローに幅広く利用できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adobe/skills/tree/HEAD/plugins/creative-cloud/adobe-for-creativity/skills/adobe-resize-photos-and-videos

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Adobe 写真と動画のリサイズ

画像や動画を、ユーザーが指定した寸法、アスペクト比、または名前付きサイズにリサイズします。 ソーシャルメディアプラットフォーム向けセット(Instagram、TikTokなど)の場合は、代わりに adobe-create-social-variations スキルを使用してください。


ツールリファレンス

ステップツール備考
ファイルピッカーを開くasset_add_filepresignedAssetUrl、assetId、mediaType を返す
CC内のアセットを検索asset_search画像の場合は結果を asset_add_file で再ステージング;動画の場合は id を直接使用
PSD/AIをレンダリングdocument_render_vectorリサイズ前にJPEGに変換
画像をリサイズimage_crop_and_resize寸法ごとに1回呼び出し;デフォルトで reframe
出力をプレビューasset_preview_fileすべての出力を1回の呼び出しで
CCにアップロード(開始)asset_initialize_file_uploadブロックアップロードパイプラインの最初の呼び出し
CCにアップロード(完了)asset_finalize_file_upload2回目の呼び出し;ボード用の署名済みCC URLを返す
Fireflyボードを作成create_firefly_boardimport_adobe_storage に最終URLを渡す
動画をリサイズvideo_resizeポーリング用の statusId を返す
動画リサイズをポーリングresizeVideoPoll遅延ツール — 呼び出し前にロードする

ワークフロー

ステップ 0 — Adobeツールの初期化

最初に adobe_mandatory_init を呼び出します。これにより、以降のワークフローに必要なファイル処理ルールとツールルーティングガイダンスが返されます。

{ "skill_name": "adobe-resize-photos-and-videos", "skill_version": "1.1.0" }

ステップ 1 — エンタイトルメントチェック

adobe_mandatory_init によって「Adobe for creativity」コネクタが有効であることが確認されたので、上記のツールリファレンステーブルと照合して、どのツールが利用可能かを確認します。


即時対応必須

ステップ 1: パラメータが不足しているか曖昧な場合 → マルチステップ intake(以下のステップ 2)を実行します。 ステップ 2: ファイルがアップロードされていない場合 → ステップ 3(asset_add_file({}))を実行します。 ステップ 3: 画像か動画かを判別し、適切なワークフロー(ステップ 5 画像/動画)にルーティングします。


ステップ 2 — マルチステップ Intake

ユーザーが完全なパラメータ(タイプ + 寸法 + フィットモード)を提供していない場合に実行します。 ユーザーのメッセージにこれらすべてがすでに含まれている場合は完全にスキップします。

AskUserQuestion を使用して、パラメータを段階的に収集します。

ステップ 2a — タイプ

AskUserQuestion([{
  question: "写真ですか、動画ですか?",
  type: "single_select",
  options: ["写真", "動画"]
}])

ステップ 2b — 寸法

写真の場合(multi_select — ユーザーは1つ以上選択可能):

AskUserQuestion([{
  question: "寸法 — 必要なものをすべて選択してください",
  type: "multi_select",
  options: [
    "1080 × 1080 — Instagram 正方形",
    "1080 × 1350 — Instagram ポートレート",
    "1080 × 1920 — ストーリー / リール",
    "1920 × 1080 — YouTube / ランドスケープ",
    "1280 × 720 — YouTube サムネイル",
    "1200 × 675 — X / Twitter 投稿",
    "1200 × 630 — Facebook / OG画像",
    "1080 × 566 — LinkedIn 投稿",
    "2560 × 1440 — YouTube バナー",
    "3840 × 2160 — 4K / UHD",
    "400 × 400 — プロフィール / アバター",
    "2480 × 3508 — A4 印刷 (300 dpi)",
    "カスタム — 自分で入力する"
  ]
}])

ユーザーが「カスタム」を含める場合 → フォローアップ:「カスタム寸法を入力してください(例:1500×800):」

ユーザーが複数のプリセットを選択した場合 → 同じソースURIとパラメータを使用して、寸法ごとに image_crop_and_resize を1回実行します。最後にすべての出力をまとめてプレビューします。

動画の場合(multi_select — ユーザーは1つ以上選択可能):

AskUserQuestion([{
  question: "寸法 — 必要なものをすべて選択してください",
  type: "multi_select",
  options: [
    "1080 × 1920 — リール / TikTok / ストーリー",
    "1920 × 1080 — YouTube / ランドスケープ",
    "1080 × 1080 — 正方形投稿",
    "1280 × 720 — YouTube 720p",
    "3840 × 2160 — 4K / UHD",
    "854 × 480 — SD / 480p",
    "カスタム — 自分で入力する"
  ]
}])

ユーザーが複数の動画プリセットを選択した場合 → 寸法ごとに個別の video_resize ジョブを送信し、それぞれ完了するまでポーリングし、すべての出力をまとめてプレビューします。

ステップ 2c — フィットモード

写真の場合(single_select):

AskUserQuestion([{
  question: "フィットモード",
  type: "single_select",
  options: [
    "リフレーム — 埋めるように切り抜き",
    "パッド — レターボックス、切り抜きなし",
    "抽出 — 被写体を分離"
  ]
}])

動画の場合(single_select):

AskUserQuestion([{
  question: "フィットモード",
  type: "single_select",
  options: [
    "レターボックス — 比率を維持",
    "クロップ — 埋める、黒帯なし",
    "ストレッチ — 強制的に正確に(歪みあり)"
  ]
}])

ステップ 2d — スマートフォーカス(写真のみ)

AskUserQuestion([{
  question: "スマートフォーカス — 切り抜きの中心をどこにしますか?",
  type: "single_select",
  options: [
    "被写体",
    "顔 / ポートレート",
    "上半身",
    "中央(幾何学的)",
    "名前付きオブジェクト — 説明する"
  ]
}])

ユーザーが「名前付きオブジェクト」を選択した場合 → フォローアップ:「オブジェクトを説明してください(例:「赤い車」、「ロゴ」):」

ステップ 2e — オプション(写真のみ)

AskUserQuestion([{
  question: "追加オプションはありますか?",
  type: "multi_select",
  options: [
    "バッチ — 複数の画像",
    "出力: JPEG",
    "出力: PNG"
  ]
}])

ステップ 2f — ソース(動画のみ)

AskUserQuestion([{
  question: "動画はどこにありますか?",
  type: "single_select",
  options: [
    "デバイスからアップロード",
    "Creative Cloud から"
  ]
}])

ステップ 3 — ソースファイルを取得

重要 — /mnt/user-data/uploads/ パスは使用可能なURLではありません。 ユーザーがファイルを添付し、コンテキスト内で /mnt/user-data/uploads/ パスに表示されている場合でも、このパスをAdobeツールに渡すことはできません。asset_add_file() を呼び出してファイルをステージングしてください — /mnt/user-data/uploads/ パスはAdobeツールで取得できません。

間違い ❌  imageURI: "/mnt/user-data/uploads/photo.jpg"
間違い ❌  imageURI: "file:///mnt/user-data/uploads/photo.jpg"
正解   ✅  call asset_add_file() → ピッカーコンテキストから presignedAssetUrl を使用

ファイルがまだない場合 → すぐにピッカーを開く:

asset_add_file()

返された mediaType からタイプを判別:

  • image/* → 画像ワークフロー
  • video/* → 動画ワークフロー

ステップ 4 — ターゲット寸法を解決

ユーザーの入力解決先
1920×1080, 1920x1080width: 1920, height: 1080
4K3840 × 2160
HD, 1080p1920 × 1080
720p1280 × 720
480p854 × 480
A4 印刷2480 × 3508 (300 DPI ポートレート)
Letter 印刷2550 × 3300 (300 DPI ポートレート)
16:9, 1:1, 4:5, 9:16比率文字列 → output: "16:9" として渡す
squareoutput: "1:1"
幅のみ (800px wide)width: 800、比率文字列を使用してアスペクト比を維持

フォームでターゲットが指定されておらず、ユーザーのメッセージにもない場合 → 質問:

「どのような寸法が必要ですか?(例:1920×1080、A4、16:9)」


画像ワークフロー

ステップ 5(画像) — 有効なURIソース

imageURI として機能するのは以下のみ:

  • asset_add_file() からの presignedAssetUrl ✅
  • 以前のツール呼び出しからの outputUrl ✅
  • ユーザーが提供した公開HTTPS URL ✅

imageURI として使用不可:

  • /mnt/user-data/uploads/ パス ❌
  • asset_search からの renditionURL を直接 ❌
  • file:// URI ❌
ソース解決方法
アップロードされたファイルasset_add_file() → presignedAssetUrl
CCストレージアセットasset_search → asset_add_file() で再ステージング → presignedAssetUrl
以前のツール出力outputUrl を直接使用
PSD / AIファイルdocument_render_vector (JPEG, 300 DPI) → outputPresignedUrl

ステップ 6(画像) — フィットモード

意図モード備考
「WxHにリサイズ」 / デフォルトreframeターゲット比率で最大の切り抜き、中央配置 — 歪みなし
「切り抜きなし」、「レターボックス」、「内側に収める」pad空きスペースを白で塗りつぶす
「被写体を分離」、「タイトに切り抜き」extract検出された領域の周りをタイトに切り抜き

デフォルト: reframe。 ユーザーが明示的に指定した場合のみ変更します。

⛔ fit: "extract" は明示的な { width, height } と互換性がありません — 画像が引き伸ばされます。比率文字列を使用するか、output を省略してください。


ステップ 7(画像) — image_crop_and_resize の呼び出し

image_crop_and_resize({
  imageURI: presignedAssetUrl,
  options: {
    output: { width: 1920, height: 1080 },  // または "16:9"
    fit: "reframe",
    focus: "subject",  // または "face"、"upper_body"、{ prompt: "the car" }、{ x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // または透明度が必要な場合は "png"
})
// result.outputUrl → プレビューまたは連鎖に使用

フォーカスガイド:

  • "subject" — デフォルト;全身検出、風景、オブジェクト
  • "face" — ポートレート、ヘッドショット
  • "upper_body" — 胸から上のクロップ
  • { prompt: "the logo" } — ユーザーのフォーム入力からの名前付きオブジェクト
  • { x: 0.5, y: 0.5 } — 幾何学的中心(明確な被写体がない場合)

ステップ 8(画像) — バッチ

フォームでバッチが選択された場合、またはユーザーが複数のファイルを提供した場合:

  1. 各ファイルに対して asset_add_file() を呼び出し、個別のpresigned URLを取得
  2. 同じパラメータで各ファイルに対して image_crop_and_resize を呼び出し
  3. すべての outputUrl 値を収集
  4. すべての出力を1回の呼び出しで asset_preview_file を呼び出し

この環境では呼び出しは順次実行されます。10枚を超える画像の場合は、開始前にユーザーに確認してください。

ターン間のページネーション(バッチ >20): 大規模なバッチの場合、すべての画像が処理される前に会話コンテキストがいっぱいになり、Claudeがバッチの途中で一時停止することがあります。これは想定内であり、エラーではありません。発生した場合:

  • 完了した数と残りの数を伝えます(例:「20 / 24 完了 — 残りを続行するには「続けて」と入力してください」)
  • ユーザーが確認してから再開します
  • 再開時には、次の未処理の画像から続けて最後まで処理します
  • 最終画像が完了した後にのみ、すべての出力をまとめてプレビューします

ステップ 9(画像) — プレビュー + 納品 + Fireflyボード

asset_preview_file({
  assets: [
    { name: "photo_1920x1080.jpg", presignedAssetUrl: result.outputUrl },
    // 成功したすべての出力
  ]
})

CCに保存 + Fireflyボードを作成

プレビュー後、ブロックアップロードパイプライン(asset_initialize_file_upload → PUTチャンク → asset_finalize_file_upload)を使用して、各出力をCCストレージにアップロードします。

次に、最終出力URLを使用してfireflyボードツールを呼び出します:

create_firefly_board({
  import_adobe_storage: [
    final_output_url_1,
    final_output_url_2,
    // ...
  ]
})

✅ (ステージで確認済み): asset_finalize_file_upload からの署名済みURLを使用した import_adobe_storage は、ボードを正常に作成します。

❌ 機能しません: CCアセットID (urn:aaid:sc:US:...) を使用した import_generic_assets — USSインデックス作成の遅延により空白のボードが発生します。

ボードの作成に失敗した場合、またはURLが不正な形式の場合は、ボードリンクを省略します(再試行しても役に立ちません)。

ボードステップの後に完了サマリーを投稿します:

✅ 完了! [N] 枚の画像をリサイズして準備完了です。

📥 ダウンロード:
• resized_1920x1080.jpg → <cc_storage_url>
[N ≤ 3 の場合は個別にリスト表示、N > 3 の場合は単一のフォルダリンク]

🎨 Fireflyボードで表示 → <board_url>   ← ボード作成に失敗した場合は省略

動画ワークフロー

ステップ 5(動画) — アセットIDを取得

動画ツールにはURLではなく assetId が必要です。

ソース方法
asset_add_file でアップロード返された assetId を使用
CCストレージfilters.mediaType: "video/mp4" を指定して asset_search → アセット id を使用

ステップ 6(動画) — 一般的なターゲット

名前寸法
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
縦型 9:161080 × 1920
正方形 1:11080 × 1080

ステップ 7(動画) — video_resize の呼び出し

⚠️ resizeVideoPoll は遅延ツールです — ポーリングする前に最初にロードしてください。 ロードせずに直接呼び出すと、「not loaded」エラーで失敗します。

video_resize({
  assetId: videoAssetId,
  width: targetW,
  height: targetH,
  mode: "letterbox"  // デフォルト;以下のモード表を参照
})
// 戻り値: { jobStatus: "pending", statusId }

モード — ユーザー向けラベルではなく、正確なAPI値を使用:

ユーザーの入力API値動作
「フィット」、「比率を維持」、「レターボックス」"letterbox"比率を維持し、黒帯を追加(デフォルト)
「埋める」、「埋めるように切り抜き」、「黒帯なし」"crop"エッジを切り抜いて正確にターゲットに合わせる
「ストレッチ」、「強制的に正確に」"stretch"正確なターゲットに歪める

ℹ️ 動画の自動リフレームはClaudeではまだ利用できませんが、新しいツールが常に追加されています。より詳細な制御が必要な場合は、Adobe Premiereをお試しください。

ポーリング: 遅延ツール resizeVideoPoll を呼び出す前にロードしてください — 直接呼び出すと「not loaded」で失敗します。

// ステップ 1: 遅延ツールをロード
const pollTool = await loadTool("resizeVideoPoll");

// ステップ 2: ポーリング
const pollResult = await pollTool({ statusId: jobStatusId });

ステップ 8(動画) — プレビュー + 納品 + Fireflyボード

すべての動画リサイズジョブが完了したら、asset_preview_file を使用して結果をまとめてプレビューします。画像ワークフローと同じブロックアップロードパイプラインとFireflyボードの手順に従います。

プレビュー後、画像ワークフローと同様にCCストレージにアップロードし、最終URLをFireflyボードに追加します。


原則

  1. 常にツールを優先: 手動の指示やユーザーへの質問ではなく、利用可能なAdobeツールを使用します。
  2. ファイルURLは直接使用しないでください — 常に asset_add_file() を使用してアップロードしてください。
  3. バッチはまとめてプレビュー: 複数の出力がある場合は、常に1回の呼び出しで asset_preview_file を使用します。
  4. 即座に行動: 可能な限り即座にアクションを実行します。複数の選択肢が必要な場合にのみ質問します。
  5. アクション後に結果を表示: アクションを実行した後は、常に結果を表示するか、何が行われたかをユーザーに知らせます。

関連スキル