adobe-edit-quick-cut

Adobe Edit Quick Cut

根据用户的原始请求，生成一个 AI 编辑的精彩片段剪辑。不追问——根据用户已提供的信息推断意图和时长；如果用户没有说明，则采用合理的默认值，并交付一个预览。

**界面说明：**默认流程使用 Adobe 的 MCP App 小组件——asset_add_file 文件选择器（步骤 2）和 asset_preview_file 预览（步骤 5）。仅当当前界面不支持某个小组件时，才使用对应步骤的无小组件备用方案——根据小组件是否可用来判断，而非客户端名称。

---

Quick Cut 的工作方式及设计注意事项

video_create_quick_cut 是一款 AI 粗剪工具。其 user_prompt 应描述视频内容和期望效果（例如“为社交募捐制作的非营利组织访谈”），而非列出节奏指示。它会自行选择片段。以下是主要限制及对应规则：

Quick Cut 的行为／限制	影响	此技能的处理方式
user_prompt 描述视频是什么／用途是什么	模糊的氛围形容词本身作用不大	提供清晰描述；如果用户有自己的表述，则将其融入其中（步骤 3）
target_duration 是软性目标，而非硬性裁剪时长	输出可能超出目标时长	始终传入一个数字——用户指定的时长（如有），否则使用默认值 30s（步骤 3）
输出是临时预签名 URL，而非 CC 资源	URL 会过期；无法直接传给 video_resize	完成后立即预览（步骤 5）；调整尺寸前需重新导入（参见已知限制）
相同提示词往往会生成相似剪辑	重新运行几乎不会带来变化	只有在意图或时长不同时才提供另一个剪辑（步骤 6）
video_create_quick_cut 异步运行（status: "working" → 完成后返回结果）	收到“working”状态就继续会跳过真正的结果	等待小组件的完成事件——绝不要对“working”状态采取操作（参见下文的异步处理）

异步处理（video_create_quick_cut）：status: "working" 响应表示仍在等待——不是失败，也不是缺少输出；绝不要将其视为失败或缺少输出。轮询由小组件管理——等待其完成事件；不要自行调用任何轮询工具。只有在结果已完成（或发生终止性失败）后，才能读取输出或应用备用方案。

---

工具参考

工具	用途
adobe_mandatory_init	必需的初始化；返回文件处理规则和工具路由信息。
asset_add_file	文件选择器；确认后，小组件会将所选 CC assetId 注入上下文——等待此操作完成，不要轮询。
asset_initialize_file_upload	无小组件暂存备用方案（第 1 步）；开始上传本地文件。
asset_finalize_file_upload	无小组件暂存备用方案（第 2 步）；完成上传并返回 assetId。
video_create_quick_cut	创建精彩片段剪辑（调用一次）。异步——可能返回 status: "working"；任务完成后会收到最终剪辑（由小组件跟踪）。
asset_preview_file	完成后立即渲染最终剪辑。
video_resize	仅在重新导入已下载的剪辑后用作调整尺寸的变通方案。
video_render	用于 Quick Cut 无法完成的编辑——精确时间戳裁剪，以及添加／替换音乐、音频或图像。

---

工作流

步骤 0 — 初始化 Adobe 工具

首先调用 adobe_mandatory_init。

{ "skill_name": "adobe-edit-quick-cut", "skill_version": "3.1.0" }

---

步骤 1 — 权限检查

adobe_mandatory_init 会确认“Adobe for creativity”连接器已启用。确认 video_create_quick_cut 和 asset_preview_file 可用。如果当前界面不支持 asset_add_file 或 asset_preview_file，请使用对应步骤的无小组件备用方案。如果工具结果包含 importantNote 或“Asset Storage & Display”指导，则以其为准，覆盖此处的呈现默认设置。

---

步骤 2 — 获取源视频

如果用户的消息中已引用 Creative Cloud 资源（CC assetId），请直接使用。否则——包括原始聊天上传的文件或本地文件（在上传到 Creative Cloud 之前都无法使用）——请先通过选择器获取文件（或使用下方的无组件暂存回退方案）：

“我们来制作一段视频集锦。首先，请选择你的文件：”

asset_add_file()

从组件上下文中提取 assetId（CC 资源 ID）——组件会在确认时注入该 ID，因此请等待，不要轮询。

video_create_quick_cut 需要 CC 资源 ID（assetId），而不是 presignedAssetUrl。

无组件回退方案 (仅当此界面不提供 asset_add_file 时) — 从文件所在位置获取 assetId。已在 Creative Cloud 中的文件可直接通过其 CC assetId 引用。若要暂存本地文件，请使用 adobe_mandatory_init 为此界面指定的上传路径（不同界面可能不同——它可能会指定专用于该界面的上传工具，也可能指定 asset_initialize_file_upload → PUT → asset_finalize_file_upload 序列）。暂存需要外发网络连接——请先通过 adobe_mandatory_init 检查外发连接状态；如果外发连接已禁用且此处没有选择器，请告知用户无法暂存。对于初始化/完成序列：获取文件大小和 MIME 类型，调用 asset_initialize_file_upload({ path, media_type })，将字节 PUT 到返回的 URL，然后调用 asset_finalize_file_upload({ filename, transfer_document }) 并提取 assetId。

---

步骤 3 — 根据原始请求构建意图（不提问）

不要向用户提问。根据他们的原始消息推导这两个输入。

user_prompt — 从通用意图开始，仅当用户提供了具体要求时，才融入他们自己的措辞：

• 用户未提供具体细节时的通用意图（默认值）：

  制作一段引人入胜的视频集锦，保留视频中最精彩、最有活力、最具视觉吸引力的时刻，以有力的开场和自然流畅的节奏呈现，可直接分享到社交媒体。

• 用户提供了意图或输出细节（内容、场合、用途、例如“关于定价的部分”这样的主题重点，或“电影感”“充满活力”“用于我们的募捐活动”这样的风格）——将他们的描述放在前面，并保留集锦的定位：

  <用户的描述>。剪辑成一段引人入胜的视频集锦，保留最精彩、最吸引人的时刻，节奏自然流畅，适合分享到社交媒体。 将用户提到的风格形容词（如“电影感”“活力十足”）融入句子。如果用户自己的描述已完整说明所需输出，则原样使用。

target_duration（秒）——始终传入一个数字：

• 用户指定了时长 → 使用该数字。这只是一个软性目标——Quick Cut 会尽量达到该时长，但可能略微超出。若用户提出时长上限（例如“不到一分钟”），则将目标设定为比上限短几秒（例如约 50 秒），并说明这是近似值；如果用户需要严格限制时长或精确时长，请改用 video_render。
• 用户未指定时长 → 默认使用 30 秒。

注意（API 缺口）： Quick Cut UI 提供 Duration: Auto 选项，但 MCP video_create_quick_cut 要求 target_duration 为数字，因此请传入用户指定的时长，或默认的 30 秒。

第 4 步 — 执行一次快速剪辑，然后等待完成

video_create_quick_cut({
  assetIds: [assetId],
  target_duration: <stated_length_or_30>,
  user_prompt: "<generic-or-merged intent>"
}) // → taskId

简短确认：“正在为你制作高光剪辑，完成后我会立即预览。”

video_create_quick_cut 也是异步的（会返回 status: "working"）。请等待结果完成后再预览（参见上文的异步处理），不要对 working 状态采取操作。完成后，保存 outputUrl（已完成的 presignedAssetUrl）。该 URL 有时效限制，请立即预览。

**如果始终没有收到完成事件：**不要停滞不前，也不要编造状态——最后已知状态是处理中。如果存在追踪器但运行缓慢，请告知用户剪辑仍在处理中，完成后就会显示预览；如果此界面完全没有异步追踪器，请告知用户剪辑已提交且正在处理中，但当前会话无法获取结果，并建议使用支持小组件的客户端，例如 Adobe Express。

---

第 5 步 — 预览结果（必做，请先执行此步骤）

任务一完成，**下一步就调用 asset_preview_file，然后再撰写任何摘要。**不要只用文字描述视频而不预览——必须立即实际调用该工具，否则 URL 可能会过期。

asset_preview_file({
  assets: [
    {
      name: "Highlight cut.mp4",
      presignedAssetUrl: outputUrl,
      mediaType: "video/mp4",
      source: "acp"
    }
  ]
})

请包含 mediaType 和 source，否则小组件可能无法渲染视频。

无小组件时的备用方案（仅当此界面无法使用 asset_preview_file 时）—直接显示 URL（Highlight cut.mp4 → <outputUrl>）。UI 客户端会内嵌渲染媒体 URL；如果无法内嵌渲染，请使用原生文件下载工具将媒体文件下载到工作区，把 <outputUrl> 保存为 highlight_cut.mp4，然后引用该本地路径。如果 asset_preview_file 出错，请立即改为发布 URL 链接。

---

第 6 步 — 总结并询问是否需要另一个版本

预览显示后，用一句话概述制作的内容（如果实际时长超过用户要求的时长，也要如实说明）。然后询问：

“想要另一个版本吗？告诉我一个不同的重点（例如某个具体时刻或氛围）或不同的时长——这才会真正改变剪辑内容。我也可以针对特定平台调整尺寸，或者你可以从上方的预览中下载。”

如果用户要求另一个版本，请根据新的意图／时长返回第 4 步。重复运行相同的意图通常会得到非常相似的剪辑，因此请引导用户调整需求。

---

⚠️ 已知限制 — 输出无法直接传递给下游视频工具

video_create_quick_cut 返回的是临时预签名 URL，而不是 CC 存储的资源 ID。video_resize 和 media_enhance_speech 需要 CC 资源 ID，因此**无法直接串联 Quick Cut → Resize / Enhance。**如需调整 Quick Cut 输出的尺寸：请告知用户先下载文件，再严格按照第 2 步的方式重新导入（asset_add_file() 或暂存备用方案），然后使用新的 assetId 运行 video_resize。如果用户要求调整 Quick Cut 输出的尺寸或增强音频，请主动说明这一点。

---

Quick Cut 不支持的操作

Quick Cut 会为你选择最相关的片段：当视频中有足够的语音时，会根据视频的转录文本／对话内容进行处理（你可以指定主题，例如“关于定价的部分”或“给狗洗澡的部分”）；语音较少时，则会改为根据视觉内容（分段添加了说明文字的画面）进行处理。它始终会生成高光剪辑。它不支持：

• 删除重复内容或语塞（“um”“uh”），也不支持执行你指定的其他确定性转录文本剪辑操作——它会选择高光片段，而不是进行精确编辑。
• 按特定时间戳裁剪（“从 0:30 剪到 1:15”），也不支持添加／替换音乐、音频或图片——这些操作由 video_render 工具完成（精确裁剪以及添加音乐／音频／图片时请使用该工具）。

---

错误处理

• video_create_quick_cut 返回 403（权益限制）：不要重试。告诉用户，其当前 Adobe 套餐不包含 Quick Cut，并建议升级套餐，或在 Premiere Rush / Premiere Pro 中手动剪辑。

• 任何工具返回 401（未通过身份验证）：请用户通过 Adobe OAuth 重新进行身份验证，然后重试。

• 输出超出用户要求的时长：这是预期情况，target_duration 只是一个宽松的目标。请如实说明。如果用户希望时长更短，可用更短的时长重新运行一次；如需精确时长，请使用 video_render。

• 作业首次尝试时出现其他错误：只有在确认是暂时性 5xx 错误（500/502/503/504）时，才重试一次。遇到 429 时，等待 Retry-After 指定的时间（或短暂退避）后，重试一次。对于其他 4xx 响应，切勿盲目重试，应向用户说明情况。如果提交超时，且作业可能已被接受，请等待现有作业的完成事件，而不是再次提交（第二个作业会浪费一次成本高昂的异步运行）。如果获准的重试仍失败，请说明情况并建议重新上传源视频。

• 进度长时间停滞在同一百分比：告知用户，并建议重新上传源视频。

• 用户误上传了图片：根据 mediaType 检测；如果它不是 video/*，请说明这一点并重新打开选择器（或重新运行暂存备用流程）。

---

约束

• 绝不向 video_create_quick_cut 或任何其他视频工具传递原始本地文件系统路径。本地文件必须先上传到 Creative Cloud——通过 asset_add_file 选择器，或使用 asset_initialize_file_upload → PUT → asset_finalize_file_upload 暂存备用流程；只有由此生成的 assetId 才有效。
• video_create_quick_cut 需要 assetId（CC 资源 ID），而不是 presignedAssetUrl。
• 每个请求只生成一个剪辑。绝不并行触发多个 video_create_quick_cut 作业——只有在用户提出要求时（步骤 6），才逐个创建其他版本。
• 不要向用户提出澄清问题——根据原始请求和一般意图处理。