Communitygithub.com

shot-list-schedule

指导AI Agent如何规划、构建或剪辑“镜头列表日程表”,最终产出节拍表和镜头列表。流程包括:镜头列表与日程表、1. 信息收集(始终在构建前进行)、2. 读取源文件。当有新的任务需求时使用。

shot-list-schedule 是什么?

该技能(Shot List & Schedule)专为需要从脚本或创意简报生成拍摄日程和镜头列表的AI Agent设计。它支持Claude Code、Cursor、Codex等工具,通过结构化的5步流程工作:先收集关键信息(拍摄时长、通告时间、地点等),再解析PDF、电子表格或JSON等源文件,然后将场景分解为具体镜头(遵循严格的镜头覆盖规则),接着规划拍摄日程(按场景分组并设定默认时长),最后输出结构化的JSON文件并生成Excel。其核心价值在于确保日程与镜头列表的完整性和一致性,能自动标记建议镜头、识别风险项(如儿童演员、动物、特技),并执行严格的审查流程——所有输出均需经过内部检查,确保无虚构信息、演员姓名或从历史项目继承的数据。最终交付物包含详细的节拍表和可编辑的Excel文件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thinkalim/ai-video-preproduction-skills/tree/HEAD/skills/shot-list-schedule

在你喜欢的 AI 中提问

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

文档

镜头列表与日程表

开工。一个实际可行的拍摄日。

1. 信息收集(始终在构建前进行)

用一条简短消息以清单形式询问。在所需项目得到答复前,切勿安排日程。 使用简报中已有的信息,仅询问缺失的部分。

必填

  1. 每日时长,从开工到收工,针对每一天(5、8、10、12小时,任何时长)。切勿假设。
  2. 每日通告时间。
  3. 拍摄天数,以及如果简报未说明,每天拍摄哪些剧本或场次。
  4. 地点:每天一个或多个地点,以及每个地点拍摄哪些场次。

询问相关项(跳过不适用项) 5. 每日日期。 6. 每个地点的地址和停车信息。 7. 剧组转场:地点之间的行车时间。 8. 演员:谁在哪天,以及发型和化妆需求。 9. 未成年人或动物在片场。 10. 摄影机:一台或多台(A、B机)。 11. 硬收工或固定时间:演员提前离开、地点可进入时间窗口、黄金时刻、客户电话。 12. 工作人员和演员姓名、电话、制片人、导演。 如果未提供,则填写待定。切勿编造或添加姓名。 除非此人主动为该拍摄提供姓名,否则切勿将运行本技能的人员列入任何工作人员、演员或制片人字段。切勿从之前的项目或保存的配置中沿用姓名或电话号码。电话号码仅当用户为此日程表输入时才会出现。

如果用户仅提供了每日时长,则根据简报构建日程表,其余项目使用待定,并在交接中列出仍然待定的项目。

2. 读取源文件

  • 来自预制作简报构建器的Spec JSON:直接使用。场景、旁白、文本、演员、服装和道具都在其中。
  • PDF:pdfplumber。电子表格:openpyxl。聊天中的简报文本:直接使用。
  • 每个场景提取:场次号、内景/外景和地点、动作、旁白、屏幕文本、角色、服装、道具。

3. 将场景分解为镜头

阅读每一帧,并在第一次遍历时确定其需要的覆盖方式。用户在此基础上进行剪辑。

每个场景都有一个主镜头(201)和至少一个其他尺寸或角度的覆盖镜头(201a)。

当帧包含以下内容时,添加更多镜头(每个成为201b、201c...):

  • 多于一个动作(“她打开抽屉,把连体衣放进去”):每个动作一个镜头。
  • 被特别提及的产品特性、屏幕、标签或细节:一个插入或大特写。
  • 故事板中的插入:行:始终有独立的镜头。
  • 两个或更多人互动:一个双人镜头加上每个人的单人镜头或过肩镜头。
  • 反应或情绪节拍:脸部的特写。
  • 揭示或拉远(“聚焦在垫子上,拉远揭示她”):开始和结束的构图,或注明运动。
  • 转场、匹配剪辑或分屏:两半部分都需要。
  • 空间中的移动(走进来、跑出去、推着东西穿过走廊):一个广角镜头来定位,以及一个跟拍或跟踪镜头。
  • 主角产品或尾板时刻:一个产品美拍加一个细节镜头。
  • ASMR或声音主导的时刻(啪、咔嗒、倒出):一个看到发声源的紧镜头。

保持精简。 不要添加帧不需要的覆盖。一个简单的纯产品镜头可以只保留两行。

标记每个添加的镜头。 在备注中,在旁白、文本和道具之后,添加一行: 建议:添加此镜头的原因(例如,单独动作、产品插入)。 主镜头和第一个覆盖镜头不需要标记。在交接中,给出建议镜头的数量,并说明可以删除或更改。

格式规则

  • 保持场景编号:剧本1 = 101,剧本2 = 201。
  • 镜头类型仅使用缩写:EWS WS MWS MS MCU CU ECU OTS POV OH INSERT。使用斜杠组合(MS/MCU)。
  • 描述:第一行场头(内景. 厨房 - 白天),下一行动作。
  • 演员:仅使用角色名称(妈妈, 爸爸)。日程表中绝不能出现演员姓名。 仅有手部:姓名 (手部)。无人:仅产品 或 无(静物板)。
  • 服装:仅限类别(休闲, 商务, 制服 + PPE)。分项造型在场景备注中。
  • 备注,每行一条,按此顺序: 旁白: "精确台词"(必须,无声时填写旁白: 无),文本: 屏幕上的文字,道具: 确切物品和颜色方案。 场景中的每个镜头都具有相同的旁白和文本。如果旁白到场景的映射不明确,请询问。
  • 纯图形场景放在图形块中,而不是日程表中。

4. 安排日程表

按地点和机位分组,而非按剧本顺序。先拍完一个机位的所有内容再移动。

每行默认时间(根据复杂性、儿童、动物、特技、设备调整):

行分钟
装台与布景60 到 90
安全会议15
简单镜头或插入15 到 20
带动作或对话的演员镜头30 到 45
主角产品、美拍或机位复杂镜头45 到 60
重置:[变化内容](重新布光、新场景)20 到 45
剧组转场30 到 60 加上行车时间
午餐30
收工清场45 到 60

规则:

  • 收工会精确落在通告时间加上每日时长。构建器会警告是否不匹配。
  • 超过6小时的拍摄日,在通告时间起6小时内安排30分钟的午餐。6小时及以内的拍摄日跳过午餐。
  • 如果镜头排不下,说明哪些有风险,并在删除任何内容前征询意见。
  • 交错安排演员通告时间。对于妆容较重的演员,允许最多90分钟做发型和化妆;妆容较轻的则少些。收工时间包含缓冲。
  • 尊重信息收集阶段获得的每一个硬收工和固定时间。将固定时间的镜头安排在其时间点,并围绕它们安排其他内容。
  • 标记供用户考虑,而非自行决定:片场有未成年人(工作时间规则因州和国家而异)、动物(增加一名动物管理员)、特技、车辆、水上场景、在公共场所拍摄需要许可证。

5. 构建

编写日程表JSON,然后运行:

python scripts/build_schedule.py schedule.json outputs/<项目>_日程表.xlsx

结构(完整示例见references/example_schedule.json):

{
  "title": "客户 - 项目",
  "producers": ["待定"], "director": "待定",
  "days": [{
    "label": "广告名称或地点", "date": "周一, 3月2日", "call": "上午7:00", "length_hours": 10,
    "locations": [{"name": "地点1", "address": "", "city": "", "parking": ""}],
    "rows": [
      {"type": "logistics", "label": "装台与布景", "minutes": 60},
      {"type": "shot", "shot": "101", "size": "广角", "camera": "A", "desc": "内景. 房间 - 白天\n动作。",
       "talent": "姓名", "wardrobe": "休闲", "location": "房间", "notes": "旁白: 无", "minutes": 30},
      {"type": "logistics", "label": "收工", "minutes": 0}
    ],
    "graphics": [{"shot": "110", "desc": "尾板", "notes": "旁白: 无\n文本: 标志"}],
    "crew": [{"role": "导演", "name": "待定", "phone": "", "call": "", "wrap": ""}],
    "talent": [{"role": "角色", "name": "待定", "call": "", "wrap": "", "notes": ""}]
  }],
  "set_notes": {
    "deliverable": ["30秒视频 (x1)"], "distribution": "", "client": "", "note": "",
    "product": {"About": "", "Key Features": [""], "Mood / Tone": ""},
    "set_notes": {"Wardrobe": [""], "Props": [""], "Open Items": [""]}
  }
}

构建器负责外观:Avenir字体、隐藏网格线、颜色编码的物流行(装台绿色、安全会议桃色、重置和转场蓝色、午餐黄色、收工清场和收工红色)、实时开始时间公式(编辑任何持续时间都会自动调整整日时间线)、以及自动行高。

审查通过(始终在展示前)

每个答案运行两次。用户永远不会看到初稿。

  1. 起草完整答案。
  2. 审查,以一个苛刻的创意总监和制片人的标准,对照以下检查清单和本技能中的每一条规则。阅读文案时,仿佛在客户会议上听到它。标记每一个失误。
  3. 修正每一个失误,然后仅呈现修订版本。
  4. 以一行结束:审查通过:<更改内容>,或审查通过:无需更改。

这适用于产生成果的每一个步骤:研究、选项、文案、规格和文件。对于文件,构建它、打开或渲染它、检查它,然后修正并重新构建,再交付。

检查清单

  • 构建器警告为零,或已向用户逐一解释。
  • 每个场景都有主镜头和覆盖镜头。每个镜头都带有其旁白。建议镜头已标记。
  • 持续时间适合动作。尊重午餐、收工和每一个硬收工时间。风险镜头已标记,绝不删除。
  • 演员仅按角色列出。没有编造的姓名,没有从过去项目沿用姓名或电话号码,除非用户自己为该拍摄提供姓名,否则从不列出用户。没有长破折号。

6. 检查,然后交接

  • 构建器输出警告。修正每一个,或告知用户为什么保留。
  • 每个场景至少有两个镜头。每个镜头都有一行旁白。日程表中没有演员姓名。
  • 没有用户未提供的姓名。没有长破折号。
  • 交接内容为3行:天数、镜头数及其中建议镜头数,然后标记(风险镜头、未成年人、动物、许可证、待办事项)。

Individual skills in this repo

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

相关技能