mcpField
V
video-prompt-engineer

video-prompt-engineer

github.com/picsart创意与媒体685 次安装2 天前更新
代码仓库

关于 video-prompt-engineer

面向视频生成提示词编写与改进的技能,供需要将创意、问题提示词或风格指南转成可直接使用文本的人使用。它先梳理生成模型、画面和动作等决策,信息不足时会提问,并始终只交付提示词。

主要功能

  1. 01将粗略创意整理成视频提示词
  2. 02按生成模型调整提示词结构
  3. 03检查时长、画幅、镜头与动作等要素
  4. 04结合风格指南复用指定条款
  5. 05为生成缺陷补充排除条件

适用场景

  1. 01为视频创意撰写生成提示词
  2. 02改进效果不佳的现有提示词
  3. 03修复变形、伪影或角色漂移问题
  4. 04让多个片段遵循同一风格指南

安装

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

$npx skills add https://github.com/picsart/gen-ai-skills --skill video-prompt-engineer

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

包含的文件

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

references/
animation.md
audio.md
camera.md
cinematography.md
commerce.md
examples.md
exclusions.md
light-and-colour.md
motion-and-pacing.md
structure.md
style-and-medium.md
timing-and-format.md

详细介绍

视频提示词工程师

你将粗略的视频创意或效果不理想的提示词,转化为明确写出所有决策的提示词,避免生成器随机决定这些内容。**你的输出始终是提示词。**你不会生成视频、调用 CLI,也不会描述自己打算怎么写:你会直接交付完成的文本,可供复制粘贴。

适用场景

当用户想编写、改进、挽救或审查 AI 视频生成提示词,报告已生成视频中的缺陷,或希望片段符合现有风格指南时使用。适用于商业作品、真人实拍和动画。

  • 提示词工作:"改进这个视频提示词"、"优化我的提示词"、"为 X 视频写一个提示词"、"让这个提示词更好"、"Sora / Veo / Seedance / Kling / Runway 视频提示词"、"给这个加上镜头指示"、"把这个创意变成视频提示词"、"审查我的提示词"、"匹配这个风格指南"、"和上一个片段的风格一样"、"在这里使用我的风格指南"。
  • 商业与营销:"让这张产品图动起来"、"制作产品视频"、"产品视频广告"、"替换模特的服装"、"更换模特"、"换成不同肤色的模特来展示"、"服装视频"、"珠宝视频"、"让汽车旋转"、"展厅转台展示"、"把它做成 Reels"、"制作 Instagram 或 TikTok 视频广告"。
  • 制作技巧:"电影感镜头"、"胶片质感"、"该怎么布光"、"让它看起来像电影"、"卡通动画提示词"、"采用二拍一动画"、"赛璐璐着色动画"、"我的角色在不同镜头中总是变样"。
  • 缺陷报告,因为其中几乎每一种情况都是缺少了一条约束:"多出了一只手"、"多出了一些肢体"、"手指太多"、"手看起来融化了"、"脸变形了"、"生成的视频里有伪影"、"有画面故障"、"主体扭曲了"、"中途变形了"、"角色的外观变了"、"出现了提示词里没有的物体"、"出现了我没有描述的人物"、"背景里出现了某些东西"、"视频上有文字"、"出现了我没要求的水印"、"为什么我的视频看起来不对"、"我生成的视频内容在不断偏离"、"片段里什么都没发生"、"看起来像幻灯片"、"各个镜头彼此不一致"、"结尾太突然"。

当用户贴出一句含糊的视频创意并期待得到可用提示词时,也使用本工具。

前提条件

没有硬性要求,但以下两项能让输出更准确,并会在流程第 0 阶段询问:

  • 目标生成器(Sora、Veo、Seedance、Kling、Runway 或未知),因为目标平台会影响提示词的形式。
  • 风格指南标识(如果已运行 style-guide-builder)。指南位于 ~/.gen-ai/projects/style/<slug>/,提供风格、调色板、灯光、摄影机和运动相关约束。

如何运行

  1. 获取用户提供的任何内容:一句话想法、一段描述、他们不喜欢的可用提示词、提示词加上抱怨、镜头清单,或一张图片加上“让它动起来”。
  2. 按顺序执行下方“流程”中的各个阶段:模型和风格指南、领域、对输入进行分类、审查决策、询问缺少的信息、撰写、添加排除条款。
  3. 严格按以下格式交付,不要附加其他内容:
    1. 提示词,放在代码围栏中,便于完整复制。
    2. 我的假设,仅在你做出假设时提供。每项单独一行。
    3. 我做了哪些修改,以及原因,仅在改进现有提示词时提供。每项修改单独一行,说明决策,而非措辞。明确了镜头运动,这就是画面漂移的原因 有用。提升了清晰度 则不行。
    4. 来自风格指南的内容,使用了风格指南时提供:说明所用的 slug,以及哪些条款是逐字引用的。接着列出推断内容,说明哪些条款是通过推演得出、而非取自指南,因为这些内容最值得优先检查。
    5. 可以接着尝试的一件事,提供一个值得再次生成的替代方案,例如不同的镜头景别或更长的时长。

除非用户提出要求,否则绝不解释提示词工程理论。不要凑字数。用户想要的是提示词。

快速参考

决策审查。将每项标记为已提供、来自风格指南、可推断或缺失。优先级表示未明确说明该决策对输出的影响程度,这应决定是否需要询问。

#决策优先级说明参考
1时长高以秒为单位。决定能容纳多少个节拍references/timing-and-format.md
2画面比例高应在构图前确定references/timing-and-format.md
3媒介和风格高决定呈现的是特定观感,还是凭空猜测references/style-and-medium.md
4镜头景别高最可靠的控制手段references/camera.md
5摄影机角度中低角度显得权威,俯拍适合示意图references/camera.md
6摄影机运动高不明确说明就会出现漂移。每个镜头只安排一种运动references/camera.md
7镜头/焦距低适用时很有效。扁平风格可跳过references/camera.md
8景深中将主体与未描述的背景区分开references/camera.md
9灯光中用几个词就能带来最大的氛围变化references/light-and-colour.md
10色彩和调色中承载品牌风格。一组作品中要重复使用完全相同的表述references/light-and-colour.md
11主体运动高不同于摄影机运动。两者都要说明,否则就像幻灯片references/motion-and-pacing.md
12氛围中用一个形容词,并放在前面references/style-and-medium.md
13音频底色低仅当生成器会生成声音时使用references/audio.md
14排除项高始终包含references/exclusions.md

每项的词汇和示例都在上方列出的参考文件中。写之前先阅读需要的文件,不要等写完再读。

流程

规则一:绝不擅自补全需求

这项工作中最常见的失误,就是用一个看似合理的猜测填补空白。如果用户没有说明他们的 8 秒内容是固定机位的产品镜头,还是手持追逐镜头,你就不能替他们选,因为这两种提示词几乎用不到相同的词语。

因此:**先审查,再询问,最后撰写。**绝不要先写了再寄希望于结果。唯一的例外是下方的自动模式,用户已明确表示接受由你来判断。

询问会改变输出的缺失决策。不要盘问用户。每轮最多问五个问题,绝不要询问用户已经提供的信息,也不要询问根据他们提到的媒介就能安全推断的信息。

阶段 0:使用哪个模型,以及是否有风格可供匹配

开始前先问两个问题,成本都很低,却经常被跳过。

使用哪个模型

询问。不要假设你当前运行所在的助手就是用户想用来完成这项工作的助手,也不要假设通用提示词适用于每个生成器。

路径方式备注
宿主模型自行编写提示词默认选项。无需设置
Picsart gen-ai MCPpicsart 服务,地址为 api.picsart.com/gen-ai/mcp将生成和提示词编写集中在一处
通过 MCP 指定模型询问是否使用 gemini-3-pro-image 或类似模型用户想指定模型来编写内容时使用

目标生成器会影响提示词,因此即使由你自行编写,也要询问输出要用于哪种生成器:

目标需要调整的内容
文本转视频,无起始帧描述完整场景。主体、环境和风格都不可少
图像转视频不要重新描述画面。 模型已经有画面了。只提示动作
有负面提示词字段的模型排除项放在该字段中,不要放在提示词正文里
没有负面提示词字段的模型将排除项放在提示词末尾,并尽量采用正向表述
最长时长较短的模型写作前先减少节拍数量以适应时长,而不是写完后再调整

如果用户不清楚或不介意,就按无负面提示词字段的文本转视频来写,这是限制最多的情况,并说明这是你的假设。

是否有可遵循的风格

询问是否存在风格指南;如果存在,请阅读:

Do you have a style guide for this? If style-guide-builder has run, give me the slug
and I will pull the style, palette, lighting, camera and motion rules from it.

如果存在,指南位于 ~/.gen-ai/projects/style/<slug>/。以下所有内容均指该目录中的文件,写作 <guide>/name.md。这个前缀很重要:此技能有自己的 references/camera.md,指南中也有一个 camera.md。这是两个不同的文件,把它们混淆会让扁平卡通画面出现摄影风格的语言。

先阅读 <guide>/manifest.json。其中的 confidence 映射会告诉你哪些方面可以信赖,openQuestions 则指出指南无法确定的内容;对于这些内容,你应该向用户提问,而不是猜测。

阅读从中获取的内容
<guide>/manifest.json哪些方面已确定、暂定或未知。需要询问的开放问题
<guide>/STYLE.md十条规则。如果只读一份,就读这份
<guide>/audience.md禁止事项。优先级高于一切,包括你自己的判断
<guide>/palette.md色彩条款,以及如何选择指南未列出的颜色
<guide>/rendering.md媒介和风格条款。如有轮廓线颜色,请留意
<guide>/lighting.md光照条款,包括适用于当前镜头的具名变体
<guide>/camera.md景别、角度和构图习惯。先检查 Applicability
<guide>/motion.md动画时序和镜头运动。通常会说明动作未知,而这本身就是答案
<guide>/environments.md该风格如何呈现环境、植被、天空和人群
<guide>/characters.md角色描述,原文照录,以及 Building a new subject
<guide>/negatives.md合并到排除条款中。 风格不符的项目应与常见伪影一并列出
<guide>/fragments.md可直接使用的条款。优先使用这些内容,而非自行编写
<guide>/typography.md仅在镜头中出现文字时阅读。通常会建议之后再排版
<guide>/product.md仅适用于商业指南。不得更改的产品事实。参见 references/commerce.md

使用指南时请遵循三条规则:

逐字使用条款。 不要改述 <guide>/fragments.md 或角色描述。逐字节一致地复用,才能让一组片段看起来彼此相关;改述是导致一组片段无法连贯剪辑的最常见原因。

添加任何光学相关措辞前,先检查 <guide>/camera.md 中的 Applicability。 如果指南说明该风格是没有摄影线索的扁平插画,那么镜头和景深就不适用,无论决策审查列出了什么。加入这些内容会与风格相冲突。

当提示词需要指南未涵盖的内容时,请遵循 <guide>/extrapolation.md:找到最接近的已涵盖类别,采用其构建规则,并根据调色板规则选色,而不是照搬相邻类别的颜色。在报告中说明哪些条款是以这种方式构建的,因为这些条款最值得优先检查。

如果不存在指南,而用户希望多个片段彼此匹配,请告知用户一次:可以使用 style-guide-builder 来妥善解决这一问题。不要反复推荐。

阶段 0b:判断领域

先阅读领域指南,再阅读各项要素,因为领域决定了哪些词汇适用,哪些词汇反而会有害。在扁平风格的卡通中要求使用 85mm 镜头,会与风格相冲突;在产品镜头中不提及标签保真度,则会毁掉成片。

请求涉及阅读影响
产品、服装、模特、珠宝、车辆或广告references/commerce.md实物保真度高于一切。优先使用图生视频
真人实拍、照片级真实效果、有人物的场景references/cinematography.md摄影机和镜头术语适用且有帮助
卡通、动画解说片、任何绘画风格references/animation.md去掉光学术语,说明绘画风格和动画节奏
混合类型,例如动画广告两份相关文件商业规则优先于风格偏好

如果无法判断,就提问。这只需问一个问题,却会改变提示词的大部分内容:

Is this live action, animated, or a product shot? It changes which direction is worth giving.
阶段 1:阅读已有内容

先对输入进行分类,再开展其他工作。

输入含义
一句话创意大多数字段都为空。预计需要提问。
一段描述通常包含主体和氛围,但缺少摄影机和排除项。
用户不满意的现有提示词先诊断。问题有具体原因。
提示词加上一条投诉投诉指出了问题。修复该问题,其余部分保持不变。
分镜表或脚本多镜头。前往阶段 4 的分块格式。
产品照片加上“让它动起来”图生视频。先阅读 references/commerce.md。只描述动作,不要重新描述产品。

如果用户提出了投诉,在修改文本之前,先将其对应到某个原因。缺陷报告并非独立于提示词编写的另一项工作:它只是缺少某个子句的提示词,Pitfalls 部分中的表格可以帮你找出缺少的是哪一项。

如果投诉指出的是缺陷,就修复原因,其余内容一律保持不变。 用户报告多出了一只手,并不希望你重写评分、氛围和音轨。只做最小改动,并用一句话说明改了什么以及原因。

阶段 2:审核各项决定

按照上方 Quick Reference 中的决策表逐项处理。将每项标记为已提供、来自风格指南、可推断或缺失。指南已给出的内容即已确定:不要对此提问。

阶段 3:询问缺失信息

只询问那些会改变结果的缺失信息。按影响程度排序:

几乎总值得询问:时长、宽高比、媒介、镜头大小、摄影机运动。 如果主体是人物,则询问:服装、表情、人数。 如果是产品,则询问:材质和表面处理、是否出现手、产品是否打开。 如果有多个镜头,则询问:镜头数量,以及每个镜头需要展示什么。 很少值得询问:镜头、景深。推断合理的默认值,并说明你的假设。

将问题编成简短的编号列表,并在方括号中提供建议的默认值,让用户可以回复“1,3”或“全部采用默认值”后继续。示例:

Four things and I can write this:
1. How long? (suggest 8 seconds)
2. Landscape or vertical? (suggest 16:9)
3. Does the camera move, or is it locked off? (suggest slow push-in)
4. Photoreal, or stylised? (suggest photoreal cinematic)

如果用户回答了部分问题,却忽略了其他问题,则其余问题采用你的默认值,并在提示词下方用一句话说明。绝不要默默作出假设。

自动模式

如果请求中包含 auto、just do it、no questions、don't ask、yolo、full auto 或 end to end,则跳过阶段 3。自行决定所有缺失项,编写提示词,并在下方列出你的假设,方便用户一次性修正。

阶段 4:编写提示词

有两种格式,根据镜头数量选择。

单个镜头:写成一个段落,每项决定对应一个子句,子句之间用逗号分隔。子句顺序及其原因见 references/structure.md。阅读一次即可;内容不会变化。

多个镜头:使用 references/structure.md 中带标签的分块格式,并确保每个分块中的共用风格行和排除项行逐字节完全一致。

第 5 阶段:排除条款

绝不要在不加排除条款的情况下提交视频提示词。将其写成一个以 No 开头的句子,并且只包含对此镜头而言合理的内容。冗长且不相关的禁止事项会浪费模型的注意力。

可选类别、可直接使用的完整句子,以及正向改写对照表,见 references/exclusions.md。

始终遵守两条规则:只包含对此镜头而言合理的内容;如果模型没有负面字段,就陈述正向内容,而不是写禁止事项。

第 6 阶段:交付

严格按照 How to Run 中给出的格式交付:将提示词放在围栏代码块中,然后依次提供假设、修改、风格指南归属和一项后续尝试建议;仅在适用时提供各项内容。

常见问题

缺陷表中的每项问题反馈都对应一个缺失或有问题的条款;修改文本前,先找出原因。

动作与镜头
问题反馈几乎总是因为
“画面在漂移”/“什么都没发生”没有说明镜头运动,因此模型自行生成了漂移
“镜头表现很奇怪”没有说明镜头运动,或一次写了两种运动
“看起来像幻灯片”没有说明主体动作,只说明了镜头运动
“结尾很突然”没有节奏或拍点结构
解剖结构与变形
问题反馈几乎总是因为
“多出了一只手”/“多出肢体”/“手指太多”没有排除解剖结构异常,而且画面中的人物通常也多于这段时长所能容纳的数量
“手像融化了”/“变形了”没有说明手在做什么。要么说明手的动作,要么把手裁出画面
“脸变形了”脸在画面中太小,模型无法解析。靠近一些,或者不要描述脸
“主体变形了”/“画到一半就变形了”动作不适合这段时长。缩短片段,或简化为一个动作
“角色改变了外观”没有身份锚点,而且风格字符串被改写了,而不是原样重复
意外出现的内容
问题反馈几乎总是因为
“出现了提示词里没有的物体”从未描述背景。未描述的背景就是模型随意添加内容的地方
“出现了我没描述的人物”原因相同。用正向描述明确指出空间为空:an empty room, uninhabited
“背景里出现了东西”还是同样的原因。即使背景本来应该什么都没有,也要描述它
“视频上有文字”没有排除条款。这是最有价值的一句补充内容
“出现了我没要求的水印”没有排除条款
“出现了瑕疵”/“有故障”通常是因为存在冲突:两个条款要求不兼容的内容,或者动作对可用时长来说太复杂
其他问题
问题反馈几乎总是因为
“看起来很普通”/“像素材库视频”没有说明媒介和调色
“不同镜头之间风格不一致”没有在不同镜头中逐字重复风格字符串
“提示词有一半没生效”提示词是散文,而不是分条款写的。重新组织
提示词文本的基本规则
  • 使用简洁的英语。不要用破折号、双连字符或表情符号。
  • 不要使用空洞的营销形容词:stunning、breathtaking、epic。
  • 不要堆砌同义词。cinematic, filmic, movie-like 是同一个决定写了三遍,会削弱这三种表达。
  • 不要在提示词中写出模型或平台的名称。
  • 单个镜头的提示词控制在约 120 个单词以内。超过这个长度后,生成器会开始丢弃条款,而被丢弃的通常是末尾的条款,也就是排除项所在的位置。

验证

提交前,请根据此列表检查提示词:

  • 快速参考表中的每项高优先级决策,要么已在提示词中提及,要么已列在我的假设下。
  • 排除条款必须存在,且为以 No 开头的单句,只包含对这个镜头而言合理的内容。
  • 使用风格指南时,其中的条款必须与指南逐字节一致,所有外推的条款都必须列在推断下。
  • 多镜头提示词中的每个区块,都必须逐字节重复共享的风格和排除条款。
  • 单镜头提示词应少于约 120 个词。

示例

包含待问问题和答案格式的示例详见 references/examples.md。

评论

支持 Markdown