Communitygithub.com

/edit — 剪辑 → 成片,在故事所指的软件中完成

将渲染好的片段在指定剪辑软件(如 DaVinci Resolve、Premiere Pro 等)中合成为最终影片,或使用 ffmpeg 独立完成剪辑。

edit — 剪辑 → 成片,在故事所指的软件中完成 是什么?

这是一个用于将影片片段在专业剪辑软件中合成为最终成片的核心技能。它根据 `config.json` 中的 `editor.id` 配置来决定工作方式:若为 `none`,则直接调用 `assemble` 技能通过 ffmpeg 完成剪辑;若指定了具体软件(如 DaVinci Resolve、Premiere Pro、Final Cut Pro、CapCut 等),则会利用该软件的 MCP 服务器进行精确操作,同时借助计算机屏幕使用能力进行视觉验证,确保每一步操作都是正确的。该技能要求先验证所有片段是否存在且时长正确,然后严格按顺序放置到时间线上,为每个片段添加标记,输出 `renders/final/film.mp4`。它特别强调“不能被 MCP 的成功消息欺骗”的原则,每一步操作后都必须通过截图确认结果。它支持多种工作模式组合(MCP + 计算机使用、仅 MCP、仅计算机使用、导出 EDL),并明确声明不会生成媒体素材、不会添加音乐,为作者保留音乐轨道。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

edit — 剪辑 → 成片,在故事所指的软件中完成 是做什么的?

影片在作者将继续工作的剪辑软件中完成剪辑。config.json 中指明了位置:

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
Key含义
idnone — 你独自使用 ffmpeg 剪辑。或指定软件:davinci_resolve, premiere_pro, final_cut_pro, capcut, 或作者给出的其他名称。
mcp当该软件的 MCP 服务器已安装并在你的客户端中连接时,设为 true。
computer_use当你可以操控屏幕时(Claude 的计算机使用能力,或你工具的等价功能),设为 true。
notes可选的自由文本:软件的版本、版本号、项目位置。

没有 editor 键等同于 { "id": "none" }。

第 0 步 — 验证所有片段(每个路径都要做)

无论使用何种剪辑软件,先执行 assemble 技能的第 1 步:每个模块都有一个片段,按顺序,以其实际时长存在。基于缺失模块剪辑而成的影片,就是一部有洞的影片。

路径 A — editor.id: "none":你即是剪辑师

遵循 assemble 技能。输出是 renders/final/film.mp4。这就是整个阶段的全部。

路径 B — 指定软件:在软件中剪辑

B1. 检查你可触及的范围,然后告知作者

在接触任何内容之前,确认 config.json 中的声明是否真实:

  • MCP: 调用该软件服务器上的一个只读工具(对于 DaVinci Resolve,是项目或时间线列表)。如果失败,打印 config.json mcp_servers 中该服务器的安装命令(npx storyseam mcp --agent <yours>;对于 Resolve,是 npx davinci-resolve-mcp setup)并等待。只有在作者确认该服务器不打算存在之后,才将 editor.mcp 设为 false。切勿自行安装。
  • 计算机使用: 截取一张屏幕截图,确认软件已打开,或者可以打开。

然后用一句话告诉作者你将采用哪种模式工作,并且在接管屏幕之前必须请求许可:计算机使用会控制他们的鼠标和键盘。

B2. MCP 与计算机使用协同工作

两者单独使用都不够,在每一步同时使用两者能获得最佳效果:

  • MCP 执行精确、可重复的工作: 以故事的分辨率和帧率创建项目和时间线,按模块顺序导入 renders/clips/block_NN.mp4,将每个片段在 V1/A1 上首尾相连地放置,根据 shotlist/shotlist.json 为每个模块添加标记,设置渲染设置,并启动渲染。精确无误,无错点。
  • 计算机使用是你的眼睛,也是你在 API 触及不到之处的手: 在每一步 MCP 操作后截图,确认它确实完成了所报告的操作;在查看器中逐帧检查每个拼接点,查看两侧的画面;检查音频表;并处理 MCP 无法暴露的任何内容(对话框、面板、拖拽操作、没有 API 的设置项)。
  • 绝不要信任你未曾亲眼查看过的 MCP 成功消息。 以错误帧率导入的片段、以错误分辨率创建的时间线、或空的渲染队列,都会报告成功。

当只有一种能力可用时:

mcpcomputer_use工作方式
truetrue两者并用,如上所述。这是默认且最佳的方式。
truefalse仅使用 MCP。告知作者剪辑结果未经肉眼验证,请他们亲自检查拼接点。
falsetrue仅使用计算机使用。这会更慢,所以告知作者,并保持每一步操作很小,每次操作后截图。
falsefalse你无法操作该软件。编写 renders/edit/timeline.edl(CMX 3600 格式,根据 shotlist.json 和片段的实际时长,按顺序每个模块一个事件),告诉作者如何导入它,并通过 assemble 技能同时生成 renders/final/film.mp4,以便无论哪种方式都能有一部影片。

B3. 剪辑步骤

  1. 项目以 storyseam.md 的 title 命名,使用片段的实际分辨率和帧率(使用 ffprobe 检查一个片段,不要假设)。
  2. 一条时间线。模块按顺序放在 V1 上,其音频放在 A1 上,无间隙,无重叠。
  3. 每个模块一个标记,以其模块 ID 和第一个镜头命名。
  4. 为作者留出一条空白的音乐轨道(A2)。切勿添加音乐。 配乐是作者的工作,应放入 assets/audio/music/。
  5. 渲染输出到 renders/final/film.mp4(H.264 视频编码,AAC 音频编码,时间线的分辨率),并将软件自身的项目文件保存在其默认位置。将该路径记录在 editor.notes 中。

B4. 软件说明

  • DaVinci Resolve. 其 MCP 服务器驱动 Resolve 的脚本 API。外部脚本仅限 Studio 版;在免费版上,应用内桥接(工作区 › 脚本)是入口,而在免费版 21.1+ 中,Python 脚本已移除,因此预期将更多依赖计算机使用。在剪辑页面上处理时间线,在交付页面上进行渲染;在开始渲染之前,通过截图确认渲染队列。
  • 任何其他软件。 首先寻找其 MCP 服务器。如果没有,就属于上面 mcp: false 的情况。不要自行安装软件、插件或 MCP 服务器;告诉作者需要什么帮助,让他们来做。

最后一步 — 报告

报告内容:影片的路径、实际运行时长和分辨率、软件的项目文件、你采用的工作模式(MCP + 计算机使用、其中一种、或 EDL)、任何你无法通过肉眼验证的内容,以及影片设计上不包含音乐。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能