Communitygithub.com

故事板拼板

把任意故事、脚本、短剧段落拆成镜头单,逐格生成统一风格的分镜画面,自动拼成带镜头号与时长标注的故事板(多格拼板图)。当用户要求“生成故事板/分镜板/故事板九宫格/分镜图/镜头板”,或需要把文字故事、影视段落、AI 视频脚本做成可视化分镜预览时使用。

故事板拼板 とは?

故事板拼板是一个专为AI Agent(如Claude Code、Cursor、Codex等)设计的自动化分镜生成技能。它能够将任意文字故事、脚本或短剧段落自动拆解为逐格镜头单,然后调用图像生成模型生成统一风格的分镜画面,最后自动拼合为带有镜头号与时长标注的多格故事板(如九宫格)。该技能的核心价值在于通过严格的静态校验(validate-shots.ps1)、逐格质检和溯源回写机制,确保角色、场景、光线、站位等关键元素在整块故事板中保持绝对一致,避免最常见的“跨格变脸”问题。它支持Windows PowerShell环境,依赖System.Drawing库,无需额外安装。用户只需提供文字内容,AI Agent即可按照严格的八步流程执行:填写内容卡、拆解镜头单、静态校验、逐格生成、逐格质检、溯源回写、拼板叠字、整板终审交付。整个流程通过三道门控(校验不过不开图、单格不过不拼板、不回写不交付)保证输出质量。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/freedonplus/storyboard-sheet/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

故事板拼板 は何をしますか?

稳定的关键不是临场发挥,而是固定这条链路:内容卡 → 镜头单 → 静态校验 → 逐格生成 → 逐格质检 → 溯源回写 → 拼板叠字 → 整板终审交付。每一步的规格都写死,换故事只换内容,不换结构。三道门卡死质量:校验不过不开图、单格不过不拼板、原句不回写不交付。

执行流程

  1. 填内容卡。见 prompt-templates.md 的字段:片名与题材、角色锚点、场景、站位卡、空间蓝图与机位表、状态卡、光影与质感、画幅与格数、镜头单、禁止项。缺什么由 Agent 依据故事合理补全,不追问用户风格偏好。
  2. 拆镜头单。按内容事件拆,不按字数或画面美观度拆;一格一个主要动作变化。写成 assets/shots.example.json 同构的 JSON,字段与命名严格照抄。所有跨格复用的句子集中写进顶层 anchors 块(单一事实源):style/characters/blueprint/blocking/axis/lighting/props/negative,各格 Prompt 从这八句原句拼装,禁止各格自写变体。机位表写进 cameras,每格必须有 camera/in_state/out_state。
  3. 静态校验(不过不开图)。先跑 scripts/validate-shots.ps1:必填字段、格数容量、镜头号连续、时间区间首尾相接、in_state/out_state 逐字接力、每格 prompt 是否原句包含全部 anchors、机位引用是否存在、参考图链方向。任何一项 FAIL 都先修 JSON,不进入生图。
  4. 逐格生成分镜画面。一次 image_gen 调用内可提交同一场戏全部格的请求(request_list 多条),每格 1536×864。每格 Prompt 按 prompt-templates.md 的模板写:全局质感句 + 角色锚点句 + 场景句 + 站位锚点句 + 比例锚 + 状态卡 + 入格状态 + 本镜动作句 + 出格状态 + 禁止句,全部锚点句逐格原句复制。同一场戏按机位表顺序走参考图链:上一格成品作为参考图传给下一格,指令固定写“只参考空间布局、角色比例、地面关系与光线方向,不照抄构图”;换场断链重开首格。详见 continuity.md。
  5. 逐格质检(单格不过不拼板)。每出一格立即对照 prompt-templates.md 的十条清单过目:脸型/服装是否对锚点、站位是否在蓝图坐标上、左右是否符合轴线定则、比例是否合锚、灯态/状态卡是否符合真实语义、光位色温是否一致、入格状态是否接住了上一格、有无文字水印。不合格原地重出:改 Prompt 不重出锚点句,只修出错的一项;同格重出两次仍漂移,把首格成品一起传入做双参考,再不行就降级景别(近景比全景更稳)。
  6. 溯源回写(不回写不交付)。每格定稿后把四样写回镜头单 JSON 对应 shot:prompt(提交给生图模型的完整原句,一字不改)、seed(若工具返回)、ref(本格使用的参考图 id 链,如 "SH003" 或 "SH001+SH003")、qa(质检结论与备注)。这张 JSON 是唯一的溯源档案:任何人拿到它能逐格复现、定位穿帮责任句。
  7. 拼板叠字。用 scripts/build-board.ps1(参数化:spec JSON + 帧目录 + 输出路径),按 output-spec.md 的比例公式定格数与画布,镜头号、时长、镜头名一律后期叠在格底半透明条上,不让图像模型画任何文字。拼板前再跑一次 validate-shots.ps1 -PanelsDir <帧目录> -RequirePanels。
  8. 整板终审交付。拼完看一次整板:相邻格接不接得上、角色左右全板是否一致、场景固定物(停止线/缘石/门框等)形态全板是否一致、标题卡信息是否正确。发现问题回到第 5 步只重出有问题的那几格。交付拼板图本身(PNG 原图 + 便于查看的 JPG)与镜头单 JSON;用户要求时再单独交付单帧。

硬规则

  • 三道门:镜头单静态校验不过 → 不生图;单格质检不过 → 不拼板;prompt/seed/ref/qa 未回写 → 不交付。
  • n×n 网格 + 每格 16:9 = 整板严格 16:9。3×3 用 1280×720 拼 3840×2160;4 格用 2×2;6 格用 3×2(超宽)或 2×3(竖版);9 格用 3×3。非方阵整板比例 = (列数×16):(行数×9)。
  • anchors 单一事实源:角色、站位、蓝图、光位、状态卡、禁止项各只有一句原话,住在顶层 anchors 块里;各格 Prompt 从这里原句复制,禁止写“同上”“保持一致的造型”,禁止各格改写近义句。同一角色跨格变脸是拼板最常见的失败。
  • 站位以场景固定物为基准,逐格原句复制:停止线、第 N 条白线、缘石、桌沿、门框、护栏立柱。禁止用“前景/后景/画面左侧”描述角色位置——这些随景别和机位变化,是站位漂移的头号原因。位移只写相对锚点的方向与距离(“向前踏出一步、越过停止线”)。
  • 场景一致性三件套:蓝图(空间坐标)+ 状态卡(可变对象语义)+ 场景固定物形态(材质/颜色/数量),全组逐格原句复制;换场才允许换,换场在镜头单里标 scene_break: true 并断参考图链。
  • 光位句全组统一,只有叙事上确实换时段才改;改时在镜头单里注明。
  • 一格一个动作:起点状态 → 路径/接触点 → 可见结果。多步动作拆邻格。
  • 相邻格必须接力:每格 out_state 与下一格 in_state 逐字相等(位置/朝向/动作相位/接触点/表情强度五项),禁止“基本一致”;换场断链用 scene_break: true 显式声明,不允许默默断开。
  • 不越轴、按机位表移动:全组机位在同一侧,角色画面左右不互换;相邻机位夹角 ≤ 90°、高度差 ≤ 一个身位、景别不连跳两级。
  • 比例锚写进每格:给一个场景固定尺寸物(白条 45cm、缘石 15cm、桌宽 60cm),角色尺寸用锚换算,防忽大忽小。
  • 状态卡逐格原句复制,灯态必须符合真实语义:行人红灯=站立红人,行人绿灯=行走绿人,车辆灯=纯色圆盘;写清哪盏面向谁,并让车流与通行权一致。禁止圆盘里画人形、红灯配绿色数字这类混搭。
  • 切点写清接住什么:禁止“自然转场”“流畅衔接”。
  • 空词换实写:高级感、震撼、电影感、氛围拉满,一律替换为具体光线、材质、速度、距离、景别。
  • 禁止项固定包含:不出现文字、字幕、水印、编号、边框;按题材追加(如不出现血液喷溅、不出现现代枪械、不做卡通化)。
  • 少于 列×行 格且启用 title_cell 时,最后一格为标题卡;否则空格留深色底,不得为了凑数补无关镜头。

资源

文件职责
references/prompt-templates.md内容卡、单格 Prompt 模板、整板九宫格 Prompt、动作与运镜写法、单格质检门、失败清单
references/continuity.md衔接卡:空间蓝图、轴线规则、机位表、尾态首态接力、参考图链、比例锚、溯源回写、自查清单
references/output-spec.md格数与比例公式、分辨率、叠字版式、镜头单 JSON 字段规范(含 anchors 与溯源字段)
assets/shots.example.json镜头单 JSON 完整示例(8 格 + 标题卡,含 anchors/cameras/溯源字段)
assets/demo.jpg示例成品:上面这份镜头单拼出的整板预览(8 镜 + 标题卡,3×3,长边 2560 的 JPG)
scripts/validate-shots.ps1镜头单静态校验:字段、接力、锚点原句包含、机位引用、帧文件存在性
scripts/build-board.ps1拼板叠字:读取 JSON,输出整板 PNG 与 JPG 预览

两个脚本依赖 Windows 自带 PowerShell 与 System.Drawing,无需额外安装库。运行方式:

# 开图前:静态校验(不过不开图)
& "<skill-dir>\scripts\validate-shots.ps1" -SpecPath <shots.json>

# 拼板前:连帧文件一起校验(缺帧直接失败)
& "<skill-dir>\scripts\validate-shots.ps1" -SpecPath <shots.json> -PanelsDir <帧目录> -RequirePanels

# 拼板叠字
& "<skill-dir>\scripts\build-board.ps1" -SpecPath <shots.json> -PanelsDir <帧目录> -OutputPath <整板.png> -PreviewPath <预览.jpg>

拼板脚本按格子中心裁切填充(cover),不拉伸画面;帧尺寸与格子比例不一致时不会变形。

示例成品见 assets/demo.jpg:8 镜 + 标题卡的整板预览,对应镜头单是 assets/shots.example.json,先跑 validate-shots.ps1 通过后再按同一份 JSON 复现即可得到同结构的板。

関連スキル