mcpField
S
shot-prompt

shot-prompt

github.com/machina-exm创意与媒体16174 次安装11 周前更新
代码仓库

关于 shot-prompt

shot-prompt 是一项创作技能,可将镜头卡和已锁定的资产护照转为带版本的文生视频提示词。它采用固定的 15 个区块,并原样保留资产描述和对白。

主要功能

  1. 01固定顺序的 15 个提示词区块
  2. 02要求资产护照已锁定
  3. 03沿用镜头卡中的调度信息
  4. 04生成版本且不覆盖旧稿
  5. 05记录生成过程并评估成片

适用场景

  1. 01准备可用于生成的镜头提示词
  2. 02在资产缺失或为草稿时阻止镜头
  3. 03每轮生成仅修改一行提示词

安装

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

$npx skills add https://github.com/machina-exm/film-studio-skills --skill shot-prompt

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

详细介绍

镜头提示词

将一张镜头卡及其已锁定的资产护照整理成一份带版本号的提示词。 按以下固定顺序保留全部十五个区块。

开始

  1. 阅读项目 CLAUDE.md 或 AGENTS.md 中的 ## AI film studio 部分。
  2. 仅将配置的视频模型作为最终提示词的目标。
  3. 如果缺少该部分,请告知用户先运行 setup。
  4. 如果用户要求继续,请询问他们使用哪种视频模型,以及如何提交提示词。
  5. 在 /prompts/、/docs/registry.md、/docs/breakdown.md 中查找镜头卡,并查阅 /assets/ 下每个入镜资产的护照。
  6. 如果缺少 /prompts/ 或 /docs/,请提出在工作室目录中创建所需文件夹。
  7. 询问要编写哪一个场景和镜头。

整个过程中,每次只问一个问题。

执行资产门槛

列出镜头卡中提到的所有角色、状态变体、地点和道具。 将每个精确标签和版本与 /docs/registry.md 对照。 生成可直接使用的提示词前,要求每一项都处于 locked 状态。 如果有任何资产缺失或处于草稿状态,指出该资产,保持镜头受阻,并引导用户使用 asset-passport 或 stress-test。 不得擅自替换为其他版本或基础资产。

阅读每本已锁定的护照。 逐字复制每条有效的规范描述。 不得在提示词中缩短、改述或润色描述。

解析镜头卡

沿用镜头卡中的身份、方向以及摄影机/剪辑轨道。 确认片段只包含一个动作,时长为 10–15 秒。 将任何标牌、屏幕、标题或其他入镜文字移至 /docs/text-tasks.md;生成内容中不得包含这些文字。 每次只向用户询问一个缺失字段。

编写十五个区块

使用编号标题,并严格按照以下顺序:

  1. 场景背景 — 以 EXACT N CHARACTERS — NO DUPLICATES 开头,并使用精确数量。说明场景、镜头目标和一个动作。
  2. 有效参考 — 逐字粘贴每项入镜资产的描述,并标明其未更改的参考文件。
  3. 地点示意图 — 给出位置和以米为单位的距离。说明摄影机绝不越过的线。
  4. 首帧调度 — 在首帧中安排每个角色、道具和摄影机的位置。开头说明所有人都已就位,镜头随即开始。
  5. 格式模式 — 说明所需的画幅格式,以及配置的工作流是从文本还是图像开始。
  6. 光学 — 整个镜头使用一个镜头焦段。只有在硬切时才改变视野。
  7. 摄影机机身 — 将摄影机描述为实体机身:位置、高度、角度、支撑方式、运动、路径和停止点。
  8. 动作时序 — 将单一动作拆分为贯穿整个片段、每段 0.3–0.8 秒的节拍。
  9. 物理效果 — 说明持续存在的物理后果。损坏须保持可见,碎屑须留在落地的位置。
  10. 灯光 — 使用地点护照中的光线特征和色彩。描述来自实际光源的塑形光。
  11. 音频 — 包含环境音、入镜声音,以及每句逐字引用并加上准确引号的台词。
  12. 角色表演 — 指导每个角色的姿势、手势、呼吸、视线、反应和灵动的眼部表现。
  13. 风格前缀 — 应用已锁定的视觉风格,并给出 60:30:10 主色、次要色和点缀色的配比说明。
  14. 质量标准 — 说明参考匹配、解剖结构、材质、运动、连续性、口型同步和瑕疵控制的要求。
  15. 正向约束 — 将每项禁令改写为可见内容,再针对镜头的已知风险添加具体的失败条件。

不得添加负面提示词区块。 保留镜头卡中完全一致的引号内台词。 区块内容须具体到足以核验最终成片。

保存版本

按照项目现有的命名模式,在 /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/,绝不使用原始生成内容。

完成

报告提示词路径和版本、使用的已锁定角色档案、任何尚未解决的问题,以及下一步生成日志操作。

评论

支持 Markdown