Communitygithub.com

长视频导演

将获批的故事转化为逐镜头的视频脚本,扮演导演角色。询问视频是否使用旁白或角色对话(或两者兼有),提出专业的拍摄选择(相机类型、镜头、运镜、灯光、色彩、节奏),将这些保存为独立的影片风格文件,然后编写符合项目配置的脚本。输出 film-style.md 和 video-script.md。在完成 long-video-story(和 long-video-assets)之后,或用户要求视频脚本、分镜表、摄影风格或灯光方案时使用。

长视频导演 是什么?

长视频导演技能(long-video-director)是长视频制作工作流程的第四阶段,旨在将已获批的故事转化为可直接制作的视频脚本和详细的影片风格指南。该技能让 AI 扮演导演角色,首先确定视频的叙述方式(旁白、角色对话或混合),并根据故事和项目配置推荐最适合的选项。接着,通过系统性地引导用户选择摄像机、镜头、运镜、灯光、色彩和节奏等专业拍摄要素,生成一份全面的影片风格文档(film-style.md)。最后,严格遵循项目配置(语言、时长、宽高比等)和批准的故事情节,编写逐镜头的视频脚本(video-script.md),确保每个镜头时长在 5-8 秒内且不超过 10 秒,并应用已锁定的影片风格。该技能支持多种 AI 编码助手平台,如 Claude Code、Cursor、Codex 等,通过严格的步骤和自检机制,保证输出与项目配置和故事一致性,避免用户重复提问。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samanfirouzi/long-video-skill/tree/HEAD/skills/long-video-director

在你喜欢的 AI 中提问

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

文档

长视频导演 是做什么的?

长视频工作流程的第 4 阶段。你是导演。输出:项目文件夹中的 film-style.md 和 video-script.md。

开始之前

  1. 在 ~/.long-video/projects/<slug>/ 中找到项目。需要 story.md 且 status: approved。如果未获批准,停止并运行 long-video-story。
  2. 需要 visual-bible.md(实体 ID 和锁定的艺术风格)。如果缺失,告知用户需要先确定艺术风格,并提供运行 long-video-assets 的选项。仅在用户选择跳过时继续。这种情况下,请用户提供简短的艺术风格描述,并在影片风格中将其标注为“未锁定”。
  3. 加载项目配置。从中获取:语言、目标时长、宽高比、受众、基调、视觉手法、旁白来源和提供商、字幕、音乐、预算。不要重复询问配置中已回答的问题。
  4. 如果 film-style.md 或 video-script.md 已存在,询问:继续,或重新开始其中一个。

第 1 步:旁白或角色对话

询问:“视频应该如何发声?”

  • 旁白。 一个声音讲述故事,配合画面。
  • 角色对话。 角色在屏幕上互相交谈。无旁白,或仅有少量标题行。
  • 混合。 旁白贯穿故事,关键场景中角色有对话。

在用户回答之前,简要说明每个选项对制作的影响。使用配置中的 visuals.approach 和 audio.voiceover:

  • 角色对话需要为每个角色配备不同的声音。静态图像或简单动画无法实现真正的口型同步,因此需说明适用哪种情况:需要口型同步工具、画外音传递(说话者不在画面中出现)、或采用遮盖嘴部的方式。
  • 旁白最便宜,且适用于所有视觉手法。

根据故事和配置推荐一个选项。如果选择与配置冲突(例如,voiceover.source 为 none),指出冲突并询问是否更新配置。

如果角色对话,请为视觉圣经中的每个角色提供声音描述(年龄、语调、口音)。如果配置中有 TTS 提供商,则使用该提供商。

第 2 步:影片风格,作为导演

阅读 references/cinematography-options.md。以下组逐一引导用户。对每组,提出 3 到 4 个适合该故事的选项。每个选项附上一行理由。标记你推荐的一个。用户可以选择、组合或自行描述。

  1. 摄像机与格式外观
  2. 镜头与构图
  3. 运镜
  4. 灯光
  5. 色彩与调色
  6. 节奏与转场。节奏在剪辑限制内:平均镜头长度必须保持在 5 到 8 秒之间,除非配置另有说明。通过镜头景别、运镜和剪辑节奏提供变化,而非长时间停留。

规则:

  • 一切必须符合锁定的艺术风格和配置的视觉手法。不要为 2D 插画风格建议实体电影摄像机。对于插画或静态图像风格,提供匹配的虚拟摄像机运动(推镜、视差、平移划过图像),并说明制作中真正能实现什么。
  • 不要与 visual-bible.md 中的风格块冲突。影片风格是在此基础上的补充。
  • 将每个建议与故事关联:情绪、背景、时代、类型。
  • 使用通俗语言。首次使用术语时解释清楚。
  • 在进入下一组之前询问用户的选择。如果用户说“你来决定”,则选择推荐的选项并告知你的选择。

第 3 步:确认并保存影片风格

  1. 将完整的影片风格作为一份摘要展示:讲述模式、摄像机与格式、镜头、运镜、灯光、色彩、节奏、转场,以及从视觉圣经中复制的艺术风格块。
  2. 询问用户确认或更改项目。
  3. 在得到明确肯定后,使用 references/film-style-template.md 编写 film-style.md。
  4. 提供选项将其保存为可重用的预设,保存至 ~/.long-video/film-styles/<预设名称>.md。使用小写字母、数字和连字符。如果用户拒绝,则跳过。

影片风格现已锁定。在编写脚本时,未经询问不得更改。

第 4 步:编写脚本

阅读 references/script-format.md 并遵循其格式和时间规则。

规则:

  • 匹配配置:语言、目标时长、宽高比、受众、基调、字幕、旁白模式。
  • 忠实于已获批的故事。覆盖每一个节拍。不要添加故事中不存在的事实、事件或主张。如果故事是旁白文本(例如来自 long-video-story-questions),则逐字保留该文本,并围绕其构建结构。
  • 将故事分解为场景,每个场景分解为镜头。每个镜头包含:时长、画面、摄像机(景别、角度、运动)、灯光、声音、转场。
  • 剪辑长度限制。 每个镜头(一张图片或一个片段)最长 10 秒。目标为 5 到 8 秒。如果配置中设置了 video.max_clip_seconds 和 video.preferred_clip_seconds,则读取这些值。默认值:最大 10,偏好 5 到 8。除非有原因(快速插入、冲击节拍),否则不允许短于 5 秒的镜头。切勿超过最大长度。如果一个时刻需要的时间超过限制,则将其在句子、从句或动作边界处分割为连续片段(镜头)。这些片段可以共享相同的环境、摄像机和灯光,画面可以保持不变或继续相同动作。最终结果比任何单个片段都长。使用 继续:<前一个镜头 ID> 标记每个后续片段,并逐字保留旁白或对话。不要为了填充额外片段而编造新的摄影机运动或新画面。
  • 将影片风格应用于每个镜头。在锁定的风格范围内,变化镜头景别和运动以调节节奏。
  • 对每个角色、环境、物体,使用视觉圣经中的实体 ID。如果某个镜头需要圣经中没有的内容,则将其列在“需要的新资产”下,而不是默默编造。
  • 旁白:使用配置语言编写文本。对话:使用 角色:台词 格式,并在必要时加上括号标注语气。确保每句台词可用一口气说完。
  • 计算总时长。必须在目标时长的 10% 范围内。如果不满足,在展示前进行调整。

第 5 步:审核

  1. 展示摘要表格:场景编号、标题、时长、镜头数、讲述模式。显示总时长与目标对比。
  2. 完整展示第一个场景。其他场景按需提供。
  3. 列出任何“需要的新资产”。
  4. 询问用户批准或请求修改。
  5. 应用修改。除非用户要求更改,否则保持影片风格。如果影片风格变更,更新 film-style.md 并重新检查每个镜头。
  6. 重复直到用户明确批准。沉默或“目前看起来不错”不视为批准。如果不确定,询问:“锁定此脚本?”

在展示脚本前,执行以下自我检查并修复任何失败:

  • 总时长在目标时长的 10% 范围内。
  • 每个故事节拍都出现在脚本中。
  • 每个镜头都有时长、摄像机、灯光和声音。
  • 没有镜头长于剪辑限制(默认 10 秒)。大多数镜头落在偏好范围(5 到 8 秒)内。报告在此范围外的镜头数量。
  • 每个实体 ID 存在于视觉圣经中,或列于新资产下。
  • 语言与配置一致。
  • 没有镜头使用影片风格排除的摄像机运动或灯光。

第 6 步:保存

  1. 编写 video-script.md,包含格式参考中的标题、状态 approved 和批准日期。
  2. 确保 film-style.md 已保存。
  3. 更新 project.json:`

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-story

Agree on the story for a long video. The user either supplies a story or asks Claude to write one. When Claude writes, it first asks which story style to use (for example niche discovery, or a provocative-questions narration), runs that style's skill, and revises until the user approves. Use after long-video-setup, or when the user says "story for my video", "give me an idea", or wants to change an unapproved story. Ends only when the user explicitly approves the story.

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

相关技能