mcpField
V
video-prompting

video-prompting

github.com/square-zero-labs创意与媒体188614 次安装4 天前更新
代码仓库

关于 video-prompting

video-prompting 可将用户意图整理为视频模型提示词,或用于角色设定表的图像模型提示词。它按模型和输入模式引导流程,并规定提示词结构与输出规则。

主要功能

  1. 01按模型提供视频提示词指南
  2. 02角色设定表提示词流程
  3. 03按模型和输入模式分流
  4. 04最少必要澄清问题指南
  5. 05提示词格式与校验规则

适用场景

  1. 01为指定视频模型拟定提示词
  2. 02制作可复用的角色参考表
  3. 03根据图像锚点准备图生视频提示词

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/square-zero-labs/video-prompting-skill --skill video-prompting

安装后在 Claude Code 中输入/video-prompting确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/models/ltx2-3/
prompting.md
references/models/ltx2-5/
prompting.md
references/models/ltx2/
prompting.md
references/models/ltx2/example_prompts/
ltx2_examples.md
references/models/minimax-h3/
prompting.md
references/models/minimax-h3/example_prompts/
full_reference_performance_transfer.md
motion_graphics_trailer.md
references/models/ovi/
prompting.md
references/models/ovi/example_prompts/
gpt_examples_10s_i2v.csv
gpt_examples_10s_t2v.csv
gpt_examples_i2v.csv
gpt_examples_t2v.csv
references/models/seedance2-5/
prompting.md
references/models/seedance2/
prompting.md
references/models/seedance2/example_prompts/
seedance2_examples.md
references/models/veo3/
prompting.md
references/models/wan-animate-2/
prompting.md
references/models/wan22/
prompting.md
references/workflows/
character-sheets.md

详细介绍

视频提示词

概述

将用户的意图转化为以下内容之一:

  • 强大且符合模型要求的视频提示词,或
  • 强大的图像模型提示词,用于生成角色设定表,之后可借此确保图像转视频的一致性。

特定模型的视频指南位于 references/models/。角色设定表指南位于 references/workflows/character-sheets.md。 本文件是入口:将请求引导至正确的路径,提出最少的澄清问题,然后按预期格式起草提示词。

模型索引

  • Ovi:references/models/ovi/prompting.md
  • Veo 3 / 3.1:references/models/veo3/prompting.md
  • Wan 2.2:references/models/wan22/prompting.md
  • Wan Animate 2:references/models/wan-animate-2/prompting.md
  • Seedance 2.0:references/models/seedance2/prompting.md
  • Seedance 2.5:references/models/seedance2-5/prompting.md
  • MiniMax H3:references/models/minimax-h3/prompting.md
  • LTX-2:references/models/ltx2/prompting.md
  • LTX-2.3:references/models/ltx2-3/prompting.md
  • LTX-2.5:references/models/ltx2-5/prompting.md

工作流索引

  • 用于保持角色一致性的角色设定表:references/workflows/character-sheets.md

之后添加新模型:创建 references/models/<model>/prompting.md,然后将其添加到此索引。

之后添加新工作流:创建 references/workflows/<workflow>.md,然后将其添加到工作流索引。

全局视频提示词规则

这些规则适用于所有视频模型参考:

  • 除非所选模型要求的提示词格式明确包含时间信息,否则最终提示词文本中不得包含模型名称、模型版本、时长、宽高比、分辨率或 API/控制参数名称。MiniMax H3 对齐说明和镜头时间戳是此规则的例外。
  • 除此之外,时长仅作为内部规划信息,用于判断提示词可以支持多少个动作节拍。
  • 如果用户询问参数,或模型要求提供参数,请在提示词之外另起一行给出建议参数。
  • 对于图像转视频,应将图像视为视觉锚点。除非用户要求分析图像,或需要更改某项细节,否则不要详细描述图像。重点描述动作、镜头、情绪/表演和音频。

工作流

步骤 1 — 为请求选择路径

判断用户想要的是:

  • 视频生成提示词,或
  • 用于图像模型的角色设定表提示词

如果用户想要可重复使用的参考表、转面图、表情表、服装表、摄影身份设定表,或用于较长图像转视频项目的一致角色起点,则将请求引导至角色设定表工作流。

如果用户两者都需要,则按以下顺序处理:

  1. 角色设定表
  2. 场景静帧/锚点帧
  3. 视频提示词
步骤 2 — 如果这是视频提示词,确定模型和输入模式

如果用户没有指定模型,请询问他们使用的是哪个模型(或从 Model Index 中提供受支持的选项)。

然后确认输入模式。先从文生视频(t2v)或图生视频(i2v)开始,并使用所选模型指南支持的任何其他关键帧或完整参考模式。

对于 MiniMax H3,请区分 T2VA、I2VA、首尾帧生成视频(FL2VA)、尾帧生成视频(L2VA)和完整参考模式。如果最终帧对齐或定时剪辑需要,请询问有效时长。

对于 Seedance 2.5,请区分文生视频、图生视频、参考图生视频、编辑和延长。如果需要多段时间线,请询问有效时长;对于较长或对连续性要求较高的镜头,请询问预期的结束状态。建议选择足以呈现动作的最短时长,而不是默认采用模型的最长时长。

如果是 i2v:请用户分享图片(可选,但这有助于生成更好的提示词)。根据所选模型的指南,将图片用作锚点(例如,保持身份、服装和构图稳定;在文本中重点描述动作、镜头运动和变化)。

如果所选模型有版本、时长限制或必需参数,请提出选择正确格式所需的最少问题(见模型指南)。 具体来说,对于 LTX-2.3:如果未提供时长,默认将外部时长设置为 10 秒,并询问用户是否想要更短或更长的时长;根据该时长调整动作复杂度。不要在提示词本身中写入时长。

具体来说,对于 LTX-2.5:区分连续的单镜头、原生多镜头场景、剧本式对话、Dub-It 语音替换和 Video Editing IC-LoRA。用户询问设置时,如果不要求固定时长且界面支持,建议将外部时长设置为自动。如果提供了末帧条件,则使用固定的外部时长。不要在提示词本身中写入时长或设置名称。

步骤 3 — 加载正确的参考资料并遵循其格式

对于视频提示词:打开 Model Index 中该模型的 prompting.md,并严格遵循其中的规则。

对于角色设定表:打开 references/workflows/character-sheets.md 并严格遵循其结构。将其视为图像模型提示词,而不是视频模型提示词。

步骤 4 — 按照正确的形式起草提示词

根据步骤 3 中所选 Markdown 文件的结构和约束起草提示词。

对于视频提示词:严格遵循所选模型的 prompting.md,包括其首选章节顺序、对话/音频格式以及任何镜头结构指南。 返回视频提示词前,删除提示词内部对模型名称/版本、片段长度、宽高比、分辨率或生成设置的任何引用,但所选模型提示词格式要求的时间信息除外。

对于角色设定表:严格遵循 references/workflows/character-sheets.md,包括布局、一致性约束和表情行指南。

第 5 步 — 输出

默认:仅输出最终提示词文本。 默认格式:将提示词输出为单行,不换行,除非用户明确要求使用多行格式,或所选模型指南要求采用结构化的多行格式。MiniMax H3 是此规则的例外:保留其要求的字段名称、行顺序和空行分隔。Seedance 2.5 在复杂的定时镜头或参考驱动镜头方面也是例外:保留指南中的制作说明章节和时间线换行。对于 LTX-2.5,如果多行剧本格式有助于清晰呈现对白或节拍,则保留该格式;默认情况下,单镜头、图生视频和多镜头的描述均使用单段文字。

如果用户要求提供选项:提供 2–3 个不同的提示词变体,每个变体都必须完整、自成一体,并符合模型的格式要求。

如果模型使用必需的 API 参数(例如时长/尺寸),仅当用户已指定这些参数或明确提出要求时,才添加简短的“推荐参数”行。

如果用户需要完整的一致性工作流,则在角色设定表提示词之后,还需提供:

  • 一个以角色设定表为参考的首个场景静帧提示词;以及
  • 一个后续的图生视频镜头提示词

评论

支持 Markdown