SHILIU · 创作资源
DaVinci Resolve 安全剪辑操作 · 创作技能
在已批准蓝图前提下,通过davinci-resolve-mcp或官方Python API操作Resolve Studio:连接确认、写入契约、帧率换算、源范围放置、LUT与效果授权、交付回读验证。强调不把失败或旧时间线报告当交付。
这个技能解决什么问题
在已批准蓝图前提下,通过davinci-resolve-mcp或官方Python API操作Resolve Studio:连接确认、写入契约、帧率换算、源范围放置、LUT与效果授权、交付回读验证。强调不把失败或旧时间线报告当交付。
适用任务
依据已批准的剪辑蓝图,在DaVinci Resolve Studio中创建或修订项目与时间线、导入素材、按源入出点放置片段、在授权范围内应用LUT/效果、准备渲染,并回读验证间隙、轨道、源范围、帧原点与实际写入结果。
需要的输入
已批准的edit-blueprint.json(含源路径、源入出点、时间线入出点、轨道角色、用途);Resolve Studio已打开且外部脚本设为Local;MCP服务已注册或官方Python API可用;项目实际帧率;用户对LUT、音频、字幕、渲染的明确授权。
交付内容
新建或复制的时间线;按轨道的条目清单;回读报告:活动项目与时间线名、各轨条目数、起始帧/原点、间隙与重叠、一帧误差、每段源路径与源范围、源组占比、相邻重复源、离线媒体、LUT/效果属性回读、渲染设置与任务状态(如请求);供上游比对脚本的时间线信息导出。
任务示例
用已批准的 /runs/trip/blueprint/edit-blueprint.json 在Resolve里新建项目 TripCut、时间线 v1,按蓝图放V1和A1,不加LUT不渲染;完成后回读各轨条目数和源范围给我。
输出示例
示意:连接确认(get_version返回版本号);写入前声明项目名TripCut、时间线v1、涉及V1/A1;构建后回读报告列出V1条目数与每段源路径/源入出点/时间线入出点、A1条目数、时间线起始帧、发现的间隙或重叠、离线媒体清单;未授权项(LUT、渲染)标注为未执行。以上为结构示意,非实际结果。
来源与使用
作者 liuluhaixiu;许可 MIT。已核对来源与包结构,未据此宣称完成运行实测。
机器可读详情 · 读取 SKILL.md · 下载完整技能包
技能说明全文
--- name: davinci-resolve-editor description: Safe DaVinci Resolve Studio editing through davinci-resolve-mcp or the official Resolve Python API. Use when Codex must inspect Resolve state, create or revise projects and timelines, import approved media, place source ranges, apply authorized LUTs or effects, prepare rendering, and verify gaps, tracks, source bounds, frame origin, and actual write success. --- # DaVinci Resolve Editor Operate only from an approved blueprint. Read `references/mcp-operations.md` for the tool map and `references/verification.md` before delivery. For deeper operations, load only the relevant bundled reference: - `references/compound-tool-reference.md` - `references/prompt-patterns.md` - `references/page-capabilities.md` - `references/keyboard-shortcuts.md` ## Connect 1. Confirm Resolve Studio is open and external scripting is set to `Local`. 2. Call `resolve -> get_version`. 3. If the tool is unavailable, distinguish missing registration from a server failure. An MCP config file alone is not proof of connection. 4. Offer blueprint-only delivery or the official Python API fallback. Install the upstream MCP server when the user approves configuration: ```bash npx davinci-resolve-mcp setup ``` ## Write Contract Before changing Resolve, state: - project and timeline name - tracks to create or modify - media and derivative paths - color, audio, subtitle, and render operations Obtain explicit approval. Use a new project or duplicated timeline for substantial revisions. Preserve existing user tracks, audio, grades, and manual work unless the user explicitly authorizes modification. ## Build - Import only blueprint media. - Convert seconds to frames using the actual project FPS. - Set source in/out and record frame deliberately. - Keep source ranges within probed bounds. - Use explicit track roles rather than assuming A1/A2/A3 universally. - Add BGM, LUTs, stabilization, retiming, audio processing, and renders only when the current request authorizes them. - Apply LUTs to verified camera/color-space groups and read back the node LUT. ## Resolve API Boundaries - Resolve writes are stateful; wait and retry in a fresh project/timeline when a batch partially fails. - Derive frame origin from actual timeline items. - Still-image duration may differ by Resolve version; use approved pre-rendered still video for frame-exact delivery. - Resolve 19 may reject item volume writes and does not expose complete Fairlight sidechain automation. Measurement is not a successful write. - Never report an unsupported or rejected operation as completed. ## Verify Read back and report: - active project and timeline - item counts by track - timeline start frame/origin - gaps, overlaps, and one-frame errors - each source path and source range - source group/camera duration ratios - adjacent repeated source, including section boundaries - missing or offline media - LUT/effect/property readback - render settings and job status, when requested A failed report or a report for an older timeline is not delivery. Export or report enough timeline information for the parent pipeline to compare the finished cut with the approved script: clip time ranges, source paths, track roles, markers, captions, and narration/dialogue placement. Do not make pickup-shot recommendations from the blueprint alone when a finished timeline exists.
技能是任务材料,不会自动授予账户权限、付费授权或其他系统权限。请让 Agent 按说明核对依赖,再在授权范围内使用。