Communitygithub.com

Adobe 調整照片與影片尺寸

使用 Adobe 工具將照片和影片調整為精確的像素尺寸或長寬比。每當使用者想要調整、縮放或變更影像或影片檔案的尺寸時,請使用此技能。

Adobe 調整照片與影片尺寸 是什麼?

此技能「Adobe 調整照片與影片尺寸」專為 AI 代理程式設計,用於處理使用者對影像與影片尺寸調整、縮放或變更解析度的需求。它支援透過 `image_crop_and_resize` 處理照片,以及透過 `video_resize` 處理影片,能將檔案調整為精確的像素尺寸(如 1920×1080)、常見的命名尺寸(如 4K、HD、A4)、或指定的長寬比(如 16:9)。技能會引導代理程式執行完整的工作流程,包括初始化 Adobe 工具、檢查權限、多步驟收集使用者參數(類型、尺寸、適合模式、焦點等)、取得來源檔案(強調必須使用 `asset_add_file` 取得有效的預簽名 URL,而非 `/mnt/user-data/uploads/` 路徑),並依據檔案類型(圖片或影片)分流至對應的工作流程。對於圖片,它支援批次處理、預覽、上傳至 Creative Cloud 以及建立 Firefly 展示板;對於影片,則需輪詢 `resizeVideoPoll` 以取得完成狀態。此技能明確不應用於社群媒體平台尺寸組(請改用 `adobe-create-social-variations`)。

相容平台✓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 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Adobe 調整照片與影片尺寸 是做什麼的?

將影像或影片調整為使用者指定的尺寸、長寬比或命名的大小。 如需社群媒體平台尺寸組(Instagram、TikTok 等)→ 請改用 adobe-create-social-variations 技能。


工具參考

步驟工具備註
開啟檔案挑選器asset_add_file回傳 presignedAssetUrl、assetId 和 mediaType
在 CC 中尋找資產asset_search照片需透過 asset_add_file 重新暫存;影片可直接使用 id
渲染 PSD/AIdocument_render_vector調整大小前先轉換為 JPEG
調整圖片大小image_crop_and_resize每個尺寸呼叫一次;預設為 reframe
預覽輸出asset_preview_file所有輸出在一次呼叫中完成
上傳至 CC(開始)asset_initialize_file_upload區塊上傳管線的第一次呼叫
上傳至 CC(完成)asset_finalize_file_upload第二次呼叫;回傳用於展示板的預簽名 CC URL
建立 Firefly 展示板create_firefly_board傳遞包含完成 URL 的 import_adobe_storage
調整影片大小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」連接器已啟用,請交叉比對工具參考表格,檢查哪些工具可透過「Adobe for creativity」連接器使用。


立即執行動作

步驟 1: 如果參數遺失或不明確 → 執行多重步驟輸入(下方步驟 2)。 步驟 2: 如果尚未上傳檔案,請執行步驟 3(asset_add_file({}))。 步驟 3: 偵測圖片或影片,並路由到正確的工作流程(步驟 5 圖片/影片)。


步驟 2 — 多重步驟輸入

當使用者尚未提供完整參數(類型 + 尺寸 + 適合模式)時執行此操作。 如果使用者訊息已包含全部三者,則完全跳過。

使用 AskUserQuestion 逐步收集參數。

步驟 2a — 類型

AskUserQuestion([{
  question: "照片還是影片?",
  type: "single_select",
  options: ["照片", "影片"]
}])

步驟 2b — 尺寸

如果是照片(multi_select — 使用者可選一個或多個):

AskUserQuestion([{
  question: "尺寸 — 選取您需要的所有項目",
  type: "multi_select",
  options: [
    "1080 × 1080 — Instagram 正方形",
    "1080 × 1350 — Instagram 直式",
    "1080 × 1920 — 限時動態 / Reels",
    "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):」

如果使用者選取多個預設 → 每個尺寸皆執行一次 image_crop_and_resize, 每次都使用相同的來源 URI 和參數。最後一起預覽所有輸出。

如果是影片(multi_select — 使用者可選一個或多個):

AskUserQuestion([{
  question: "尺寸 — 選取您需要的所有項目",
  type: "multi_select",
  options: [
    "1080 × 1920 — Reels / 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: [
    "Reframe — 裁剪以填滿",
    "Pad — 信箱模式,不裁剪",
    "Extract — 隔離主體"
  ]
}])

如果是影片(single_select):

AskUserQuestion([{
  question: "適合模式",
  type: "single_select",
  options: [
    "Letterbox — 維持比例",
    "Crop — 填滿,無黑邊",
    "Stretch — 強制精確(扭曲)"
  ]
}])

步驟 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"
正確 ✅  呼叫 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 寬)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: "那輛車" }, { x:0.5, y:0.5 }
    quality: 7
  },
  outputFileType: "jpeg"  // 或 "png"(如果需要透明度)
})
// result.outputUrl → 用於預覽或串聯

焦點指引:

  • "subject" — 預設;全身偵測、風景、物體
  • "face" — 人像、頭像
  • "upper_body" — 胸部以上裁剪
  • { prompt: "標誌" } — 來自使用者表單輸入的命名物件
  • { x: 0.5, y: 0.5 } — 幾何中心(無明確主體)

步驟 8(圖片)— 批次

如果表單中選取了批次,或者使用者提供了多個檔案:

  1. 為每個檔案呼叫 asset_add_file() 以取得個別預簽名 URL
  2. 使用相同參數為每個檔案呼叫 image_crop_and_resize
  3. 收集所有 outputUrl 值
  4. 在一次呼叫中使用所有輸出呼叫 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,
    // ...
  ]
})

✅ 已確認可運作(Stage): 使用來自 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

影片工具需要 assetId,而非 URL。

來源如何處理
透過 asset_add_file 上傳使用回傳的 assetId
CC 儲存空間asset_search 搭配 filters.mediaType: "video/mp4" → 使用資產 id

步驟 6(影片)— 常見目標

名稱尺寸
4K / UHD3840 × 2160
1080p / HD1920 × 1080
720p1280 × 720
480p854 × 480
直式 9:161080 × 1920
正方形 1:11080 × 1080

步驟 7(影片)— 呼叫 video_resize

⚠️ resizeVideoPoll 是延遲工具 — 在嘗試輪詢前需先載入。 在未載入的情況下直接呼叫會失敗並顯示「未載入」錯誤。

video_resize({
  assetId: videoAssetId,
  width: targetW,
  height: targetH,
  mode: "letterbox"  // 預設;請參閱下方模式表格
})
// 回傳 { jobStatus: "pending", statusId }

模式 — 使用確切的 API 值(非使用者面向標籤):

使用者說法API 值行為
"適合", "維持比例", "信箱模式""letterbox"維持比例,加入黑邊(預設)
"填滿", "裁剪以填滿", "無黑邊""crop"裁剪邊緣以精確填滿目標
"拉伸", "強制精確""stretch"扭曲以符合精確目標

ℹ️ 影片的自動重構圖功能在 Claude 中尚不可用,但新工具一直在新增。如果您需要更多控制,請嘗試使用 Adobe Premiere。

輪詢: 在呼叫 resizeVideoPoll 之前先載入延遲工具 — 直接呼叫會失敗並顯示「未載入」。

// 步驟 1:載入延遲工具
// (實際載入方法取決於環境,請參考平台特定文件)

// 步驟 2:輪詢狀態
resizeVideoPoll({ statusId: previousStatusId })
// 回傳 { status: "done", outputAssetId: "..." } 或 { status: "in_progress" }

持續輪詢直到 status 為 "done"。如果 status 為 "failed",請告知使用者失敗並停止。


步驟 8(影片)— 預覽 + 交付 + Firefly 展示板

asset_preview_file({
  assets: [
    {
      name: "video_1920x1080.mp4",
      assetId: "video_output_asset_id"
    }
  ]
})

儲存至 CC + 建立 Firefly 展示板

對於影片,create_firefly_board 使用的 import_adobe_storage 需要 assetId,而非預簽名 URL。如果在步驟 5 中使用了 asset_add_file,請使用原始上傳的 assetId。

create_firefly_board({
  import_adobe_storage: [
    "video_output_asset_id"
  ]
})

如果展示板建立失敗,請省略展示板連結。


步驟 9(影片)— 完成

✅ 完成!已調整 [N] 部影片的尺寸並就緒。

📥 下載:
• resized_1920x1080.mp4 → <cc_storage_url>

🎨 在 Firefly 展示板中檢視 → <board_url>   ← 若展示板建立失敗則省略

常見邊緣案例

情境處理方式
使用者說「使其適合 16:9」使用 output: "16:9" 呼叫 image_crop_and_resize,搭配預設的 reframe
使用者說「需要相同尺寸的多份拷貝」為每個拷貝使用相同參數重複呼叫 image_crop_and_resize / video_resize
單一請求中包含圖片和影片先處理所有圖片,然後處理所有影片 — 不要混合
使用者附加了 .heic 檔案由 asset_add_file 處理;轉換會自動發生
使用者詢問「哪種尺寸效果最好」引導他們使用步驟 2 中的預設,或解釋目標平台(YouTube、Instagram 等)
image_crop_and_resize 回傳錯誤檢查 imageURI 是否有效(不是 /mnt/user-data/uploads/ 路徑)並重試
video_resize 回傳錯誤確認 assetId 有效且影片格式為 video/mp4

相關技能