关于 shot-prompt
shot-prompt 是一项创作技能,可将镜头卡和已锁定的资产护照转为带版本的文生视频提示词。它采用固定的 15 个区块,并原样保留资产描述和对白。
主要功能
- 01固定顺序的 15 个提示词区块
- 02要求资产护照已锁定
- 03沿用镜头卡中的调度信息
- 04生成版本且不覆盖旧稿
- 05记录生成过程并评估成片
适用场景
- 01准备可用于生成的镜头提示词
- 02在资产缺失或为草稿时阻止镜头
- 03每轮生成仅修改一行提示词
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ machina-exm/ film-studio-skills --skill shot-prompt安装后在 Claude Code 中输入/shot-prompt确认已加载。
详细介绍
镜头提示词
将一张镜头卡及其已锁定的资产护照整理成一份带版本号的提示词。 按以下固定顺序保留全部十五个区块。
开始
- 阅读项目
CLAUDE.md或AGENTS.md中的## AI film studio部分。 - 仅将配置的视频模型作为最终提示词的目标。
- 如果缺少该部分,请告知用户先运行 setup。
- 如果用户要求继续,请询问他们使用哪种视频模型,以及如何提交提示词。
- 在
/prompts/、/docs/registry.md、/docs/breakdown.md中查找镜头卡,并查阅/assets/下每个入镜资产的护照。 - 如果缺少
/prompts/或/docs/,请提出在工作室目录中创建所需文件夹。 - 询问要编写哪一个场景和镜头。
整个过程中,每次只问一个问题。
执行资产门槛
列出镜头卡中提到的所有角色、状态变体、地点和道具。
将每个精确标签和版本与 /docs/registry.md 对照。
生成可直接使用的提示词前,要求每一项都处于 locked 状态。
如果有任何资产缺失或处于草稿状态,指出该资产,保持镜头受阻,并引导用户使用 asset-passport 或 stress-test。
不得擅自替换为其他版本或基础资产。
阅读每本已锁定的护照。 逐字复制每条有效的规范描述。 不得在提示词中缩短、改述或润色描述。
解析镜头卡
沿用镜头卡中的身份、方向以及摄影机/剪辑轨道。
确认片段只包含一个动作,时长为 10–15 秒。
将任何标牌、屏幕、标题或其他入镜文字移至 /docs/text-tasks.md;生成内容中不得包含这些文字。
每次只向用户询问一个缺失字段。
编写十五个区块
使用编号标题,并严格按照以下顺序:
- 场景背景 — 以
EXACT N CHARACTERS — NO DUPLICATES开头,并使用精确数量。说明场景、镜头目标和一个动作。 - 有效参考 — 逐字粘贴每项入镜资产的描述,并标明其未更改的参考文件。
- 地点示意图 — 给出位置和以米为单位的距离。说明摄影机绝不越过的线。
- 首帧调度 — 在首帧中安排每个角色、道具和摄影机的位置。开头说明所有人都已就位,镜头随即开始。
- 格式模式 — 说明所需的画幅格式,以及配置的工作流是从文本还是图像开始。
- 光学 — 整个镜头使用一个镜头焦段。只有在硬切时才改变视野。
- 摄影机机身 — 将摄影机描述为实体机身:位置、高度、角度、支撑方式、运动、路径和停止点。
- 动作时序 — 将单一动作拆分为贯穿整个片段、每段 0.3–0.8 秒的节拍。
- 物理效果 — 说明持续存在的物理后果。损坏须保持可见,碎屑须留在落地的位置。
- 灯光 — 使用地点护照中的光线特征和色彩。描述来自实际光源的塑形光。
- 音频 — 包含环境音、入镜声音,以及每句逐字引用并加上准确引号的台词。
- 角色表演 — 指导每个角色的姿势、手势、呼吸、视线、反应和灵动的眼部表现。
- 风格前缀 — 应用已锁定的视觉风格,并给出
60:30:10主色、次要色和点缀色的配比说明。 - 质量标准 — 说明参考匹配、解剖结构、材质、运动、连续性、口型同步和瑕疵控制的要求。
- 正向约束 — 将每项禁令改写为可见内容,再针对镜头的已知风险添加具体的失败条件。
不得添加负面提示词区块。 保留镜头卡中完全一致的引号内台词。 区块内容须具体到足以核验最终成片。
保存版本
按照项目现有的命名模式,在 /prompts/ 中创建提示词。
如果没有命名模式,则使用 <scene>-<shot>-prompt-v<version>.md。
保留先前版本,不得覆盖。
记录提示词使用的已锁定护照版本。
有针对性地迭代
每次生成后,在 /docs/generation-log.md 末尾追加一行:
| shot id | prompt version | what changed | result | verdict |
下一版提示词只修改一行,其余每一行都保持原样。 再次尝试前,记录输出路径和评定结果。 如果经过 10–15 次迭代仍未成功,就停止润色措辞。 与用户一起选择一项结构性简化:将镜头拆成两段、删掉一个动作,或更改角度。
接受或拒绝镜头
只有通过所有检查后才接受:
- 角色和地点与参考内容一致;
- 手、牙齿、物体和表面没有瑕疵或随机文本;
- 摄影机运动符合镜头卡;
- 表演和口型同步保持稳定;
- 眼神方向、轴线、画面大小和光线与相邻镜头匹配;
- 整体世界的色彩调板一致。
将通过的镜头以最终名称保存到 /selects/sc<NN>/。
将原始输出保留在 /generations/sc<NN>/。
剪辑人员只使用 /selects/,绝不使用原始生成内容。
完成
报告提示词路径和版本、使用的已锁定角色档案、任何尚未解决的问题,以及下一步生成日志操作。