Skip to content
Back to search

script-to-shootable-storyboard

"将剧本、故事梗概、对白稿、已有分镜或视频生成提示转换、检查并优化为可拍、可剪、适合 Seedance、真人或混合制作的原子分镜。用于剧本转分镜、分镜可拍化、后续场景开发、反馈驱动迭代、不连贯诊断与修复、心理描写视觉化、单镜主导景别拆分、短剧钩子与节奏、台词和声音时长、人物道具连续性、Seedance Generation Task、生成风险与失败降级;默认忠实转换,未获授权不得改写剧情。"

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zyz254009-crypto-script-to-shootable-storyboard/badge.svg)](/listings/zyz254009-crypto-script-to-shootable-storyboard)

HTML

<a href="/listings/zyz254009-crypto-script-to-shootable-storyboard"><img src="/api/listings/zyz254009-crypto-script-to-shootable-storyboard/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

需要 Git 和 Node.js 18 或更高版本。项目脚本只使用 Node.js 内置模块,无需安装 npm 依赖。

将项目克隆到 Codex Skills 目录:

git clone https://github.com/zyz254009-crypto/script-to-shootable-storyboard.git "$env:USERPROFILE\.codex\skills\script-to-shootable-storyboard"

重新打开 Codex 任务后,可通过 `$script-to-shootable-storyboard` 调用。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 226 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: script-to-shootable-storyboard
  3. description: "将剧本、故事梗概、对白稿、已有分镜或视频生成提示转换、检查并优化为可拍、可剪、适合 Seedance、真人或混合制作的原子分镜。用于剧本转分镜、分镜可拍化、后续场景开发、反馈驱动迭代、不连贯诊断与修复、心理描写视觉化、单镜主导景别拆分、短剧钩子与节奏、台词和声音时长、人物道具连续性、Seedance Generation Task、生成风险与失败降级;默认忠实转换,未获授权不得改写剧情。"
  4. ---
  5. # 剧本转 Seedance 可拍分镜
  6. 把输入编译成摄像机、演员、声音、剪辑和 Seedance 能执行的镜头方案。优先保证剧情保真、画面可见、动作可执行、镜头原子化、声音可定位、连续性可追踪和失败可降级。
  7. ## 先锁定任务
  8. 1. 识别输入类型:`script`、`scene_draft`、`synopsis`、`dialogue_draft`、`existing_storyboard`、`seedance_prompt` 或混合输入。
  9. 2. 建立 JobSpec;从 [project-input-template.yaml](assets/project-input-template.yaml) 起步。
  10. 3. 锁定修改权限:
  11. - `faithful`:默认;只拆分、画面化和最小必要补全。
  12. - `visual`:可增强动作、构图、道具、声音和环境反应,但不新增剧情事实。
  13. - `pacing`:可拆合镜头、压缩和局部调序,但不改变核心因果。
  14. - `story`:仅在用户明确授权和提供授权范围后改写剧情。
  15. 4. 选择 `live`、`seedance`、`hybrid` 或逐镜决策。
  16. 5. 冻结原稿、版本、来源范围、锁定事实、假设和未知项。
  17. 读取 [workflow-modes.md](references/workflow-modes.md) 处理输入分流、权限和已有分镜优化。不得把“优化分镜”自动解释为“改写剧情”。
  18. ## 最小读取路径
  19. - 剧本转分镜:先读 [workflow-modes.md](references/workflow-modes.md)、[script-analysis.md](references/script-analysis.md)、[abstract-to-visible.md](references/abstract-to-visible.md)、[atomic-shot-rules.md](references/atomic-shot-rules.md) 和 [storyboard-template.md](assets/storyboard-template.md)。
  20. - 已有分镜优化:先读 [workflow-modes.md](references/workflow-modes.md)、[atomic-shot-rules.md](references/atomic-shot-rules.md)、[blocking-and-continuity.md](references/blocking-and-continuity.md) 和 [existing-storyboard-repair-template.md](assets/existing-storyboard-repair-template.md)。
  21. - 后续开发或反馈迭代:先读 [iterative-storyboard-refinement.md](references/iterative-storyboard-refinement.md)、[script-analysis.md](references/script-analysis.md)、[story-bible.md](references/story-bible.md)、[blocking-and-continuity.md](references/blocking-and-continuity.md)、[editing-and-coverage.md](references/editing-and-coverage.md) 和 [existing-storyboard-repair-template.md](assets/existing-storyboard-repair-template.md)。
  22. - Seedance 生成适配:再读 [model-registry.yaml](references/model-registry.yaml)、[prompt-compiler.md](references/prompt-compiler.md)、[generation-risk-and-repair.md](references/generation-risk-and-repair.md) 和 [generation-task-template.md](assets/generation-task-template.md)。
  23. - 交付或审查:再读 [schema-index.md](references/schema-index.md)、相关 Schema、[quality-report-template.md](assets/quality-report-template.md)、[rights-safety-compliance.md](references/rights-safety-compliance.md) 和 [source-catalog.md](references/source-catalog.md)。
  24. ## 执行主流程
  25. 按顺序执行,不要让下游补丁掩盖上游错误:
  26. 1. 冻结来源并建立 Source Manifest、Fact Ledger 和字段级 provenance。
  27. 2. 解析 Scene、人物、地点、时间、道具、对白和声音。
  28. 3. 建立 Story Bible,锁定人物身份、关系、外观锚点、知情范围和世界规则。
  29. 4. 按行动、信息、权力关系或局势变化拆 Beat;不要按句号或台词数量拆。
  30. 5. 从原剧情提取钩子;建立“承诺—观众问题—风险—延期—兑现”契约。
  31. 6. 把心理解释、作者评价和抽象氛围改成可见或可听证据。
  32. 7. 先设计人物站位、路线、动作相位、道具和轴线,再设计摄影机。
  33. 8. 标记必须看到、必须听到和可跨镜延续的事件。
  34. 9. 建立 must-have Coverage 和临时 Shot Intent,再规划 Camera Setup。
  35. 10. 冻结原子 Shot,计算动作、对白、反应、摄影机和声音的关键路径时长。
  36. 11. 写入镜头间物理连续性状态,并执行叙事连贯性与镜头序列复核。
  37. 12. 逐镜选择真人、Seedance 或混合制作,并设置备用方案和切换条件。
  38. 13. 将每个 Seedance Shot 编译为 Generation Task;默认一镜一任务,多次 Attempt。
  39. 14. 执行质量门禁;按责任阶段定向修复,最多三轮最小补丁。
  40. 15. 输出分镜表、Seedance 任务表、差异报告、质量报告和风险/降级说明。
  41. ## 强制可拍规则
  42. 每个正式 Shot 默认必须同时满足:
  43. - 只有一个连续时空。
  44. - 只有一个主导景别;不得在同一镜号中同时写全景、近景和特写。
  45. - 只有一个主要视觉行动单元和一个主要叙事目的。
  46. - 只有一个主要摄影运动;复杂运动必须有完整路径和必要性。
  47. - 明确主体、开始状态、可见动作和结束状态。
  48. - 动作、对白、反应和运镜能在镜头时长内完成。
  49. - 能追溯到原文事实或明确授权。
  50. - 上一镜 `end_state` 能承接下一镜 `start_state`。
  51. 出现以下任一情况时拆镜:
  52. - 主导景别明显跨级。
  53. - 出现“切到、再切至、转到另一边”等隐含剪辑。
  54. - 机位、方向、注意力中心、时空或独立信息结果改变。
  55. - 反应或证据需要独立读取。
  56. - 动作链、主体数、口型、手部、物理交互或运镜负载过高。
  57. 只有用户明确需要连续长镜头且方案可执行时,才设置 `long_take_exception: true`,并写出起止构图、摄影机路径、人物路径、失败点和拆镜备用方案。
  58. 读取:
  59. - [shot-unit-contract.md](references/shot-unit-contract.md):对象边界、ID、关系和字段级来源。
  60. - [atomic-shot-rules.md](references/atomic-shot-rules.md):原子镜头、主导景别、拆镜触发器和长镜头例外。
  61. - [editing-and-coverage.md](references/editing-and-coverage.md):Coverage、编辑闭环和切镜理由。
  62. ## 把空话变成画面
  63. 删除不能被摄像机或麦克风记录的解释,但保留其剧情信息。优先转译为:
  64. 1. 有结果的身体动作。
  65. 2. 人物与道具的状态变化。
  66. 3. 人物距离、站位或空间关系变化。
  67. 4. 明确、可重复表演的面部或手部变化。
  68. 5. 环境的物理反应。
  69. 6. 沉默、呼吸、脚步、物件声或必要对白。
  70. 不要写:
  71. > 她终于不再隐忍,这个冷笑不是得意。
  72. 改写为:
  73. > 她摘下工牌,压在辞职信上,把两样东西推到经理面前。
  74. 不得用“电影感、压迫感、宿命感、高级感”替代构图、光线、动作或声音。读取 [abstract-to-visible.md](references/abstract-to-visible.md)。
  75. ## 保持人物和空间连续
  76. 建立并逐镜更新:
  77. - 人物左右位置、面朝方向、视线目标、姿势和动作相位。
  78. - 服装、头发、妆容、污渍、伤势和表演强度。
  79. - 道具位置、状态、持有手和移动路径。
  80. - 门窗、灯光、屏幕内容、天气、时间和轴线状态。
  81. - 对白、环境声、音乐和声画桥的跨镜状态。
  82. 先读取 [script-analysis.md](references/script-analysis.md) 与 [story-bible.md](references/story-bible.md),再读取 [blocking-and-continuity.md](references/blocking-and-continuity.md)。
  83. ## 继续开发并修复不连贯
  84. 用户要求继续开发后续场景、下一集或优化已有分镜,或者反馈“前后接不上、动作跳了、镜头有点散、节奏断了”时,读取 [iterative-storyboard-refinement.md](references/iterative-storyboard-refinement.md)。
  85. 必须:
  86. 1. 冻结最近一个已接受版本与用户原始反馈,不从空白状态重做。
  87. 2. 按剧情信息、Scene/Beat、调度空间、Shot/剪辑、声音节奏、生成装配六层诊断最早根因。
  88. 3. 对目标镜头同时检查前一镜和后一镜,比较 `end_state`、`start_state`、动作相位、画面方向、道具和声音。
  89. 4. 从责任层实施最小补丁,并标记受影响的下游 Shot、Task、Asset 和 Clip。
  90. 5. 后续 Scene 继承上一个相关 Scene 的出口快照、未兑现 Hook、人物知识状态和连续性锚点。
  91. 6. 用同一证据窗口复核修复前后结果;默认最多三轮最小补丁。
  92. 不得把“不连贯”自动解释为需要新增人物动机、冲突、反转或剧情事实。需要改变核心因果时停在建议区并请求 `story` 授权。
  93. ## 设计短剧钩子、节奏和台词
  94. - 首屏尽快给出可见冲突、异常、证据、风险或未完成动作。
  95. - 钩子必须来自原剧情;需要新增剧情时升级到 `story` 并记录授权。
  96. - 每个钩子必须有兑现、合法延期或明确撤销,不得只堆悬念。
  97. - 爽点必须表现为权力、信息、目标或物理状态的可见变化。
  98. - 台词必须可说、可回应、可计时;不要让人物朗读作者解释。
  99. - 同期长对白、多人精确口型或复杂抢话优先真人拍摄或分离声音生产。
  100. 按题材和平台读取:
  101. - [hook-and-platform-profiles.md](references/hook-and-platform-profiles.md)
  102. - [genre-profiles.md](references/genre-profiles.md)
  103. - [timing-and-audio.md](references/timing-and-audio.md)
  104. ## 编译 Seedance 任务
  105. 不要把官方“支持某能力”写成稳定成功保证。先读取 [model-registry.yaml](references/model-registry.yaml),再根据实际入口、地区、账号和构建记录运行快照。
  106. 每个 Generation Task 至少包含:
  107. - 对应 Shot、时长、画幅和模型档案。
  108. - 角色、场景、服装、道具和参考素材 ID。
  109. - 首帧状态、单一主导景别、分段动作时间线和尾帧目标。
  110. - 摄影机状态或一个简单连续运动。
  111. - 对白、环境声和音效的时间点。
  112. - 连续性目标、负面约束、验收条件、风险分数和降级路径。
  113. 默认策略:
  114. ```text
  115. 1 Atomic Shot → 1 Generation Task → 多个 Generation Attempt
  116. ```
  117. 多人长对白、复杂手部小道具、多阶段物理交互、复杂运镜和多镜头内部剪辑均提高风险。失败时依次减少主体、缩短动作、锁定机位、拆镜、分离声音、切换模型、改真人或混合制作。
  118. 读取:
  119. - [prompt-compiler.md](references/prompt-compiler.md)
  120. - [generation-risk-and-repair.md](references/generation-risk-and-repair.md)
  121. - [cost-complexity.md](references/cost-complexity.md)
  122. ## 权利、安全和来源
  123. 未知的素材权利、肖像、声音、未成年人同意、隐私、平台政策或地区限制不得被自动修复为“已通过”。把这些问题路由给人工审核。
  124. 读取 [rights-safety-compliance.md](references/rights-safety-compliance.md) 和 [source-catalog.md](references/source-catalog.md)。对快速变化的模型规格、价格和平台政策重新核验,不沿用过期结论。
  125. ## 使用模板和 Schema
  126. 优先复制而不是重建:
  127. - [storyboard-template.md](assets/storyboard-template.md) 或 [storyboard-template.csv](assets/storyboard-template.csv)
  128. - [existing-storyboard-repair-template.md](assets/existing-storyboard-repair-template.md)
  129. - [generation-task-template.md](assets/generation-task-template.md)
  130. - [quality-report-template.md](assets/quality-report-template.md)
  131. - [rights-manifest-template.yaml](assets/rights-manifest-template.yaml)
  132. 机器输出按 [schema-index.md](references/schema-index.md) 与 `references/schemas/` 中的 JSON Schema 组织。对象关系、字段名或枚举不确定时,读取对应 Schema,不自行创造近义字段。
  133. ## 执行审查梯队
  134. 按以下顺序审查;任一阻断项退回责任阶段:
  135. 1. 结构审:对象、ID、Schema、引用和流程顺序。
  136. 2. 人设与连续性审:身份、关系、外观、站位、轴线、道具和状态。
  137. 3. 爽点与节奏审:冲突启动、信息差、钩子承诺、延期和兑现。
  138. 4. 台词审:可说性、时长、回应关系、口型和声音生产。
  139. 5. 格式审:字段、表格、模板、提示词和机器可读性。
  140. 6. 一致性审:Source → Beat → Shot → Task → Attempt/Asset → Timeline。
  141. 运行:
  142. ```powershell
  143. node scripts/validate-all.mjs --input <project.json> --pretty --require-validators
  144. node scripts/run-regression-tests.mjs
  145. node scripts/build-repair-plan.mjs --report <quality-report.json> --project <project.json> --pretty
  146. node scripts/estimate-cost.mjs --input <project.json> --pretty
  147. ```
  148. 不要自动应用修复计划。禁止自动修改锁定事实、授权、权利、隐私、同意和合规状态。
  149. ## 交付门禁
  150. 只在以下条件全部满足时声明“方案通过”:
  151. - 锁定事实保留率 100%,未授权新增事实为 0。
  152. - 所有抽象来源均已转为可见或可听证据,抽象语言审查无 Error/Blocker。
  153. - 正式 Shot 原子结构通过率 100%。
  154. - must-have Coverage、相邻镜头连续性、关键声音、台词测时、钩子与爽点因果全部闭环。
  155. - 每个 must-preserve Beat 均有镜头覆盖;不存在孤立 Shot、无触发结果、提前知情或未经授权调序;每对相邻镜头都有明确承接或合法转场。
  156. - 人物知识状态、当前目标、关系有效区间、说话方式和行为锚点无冲突。
  157. - 分镜、提示词、连续性、模型档案和制作方式互相一致。
  158. - 阻断级权利、安全、隐私和合规遗漏为 0。
  159. - 所有默认值、推断、调序、压缩和授权新增均出现在差异报告中。
  160. - 全部适用验证器的 Blocker 与 Error 均为 0。
  161. 缺少真实生成、真人走戏或剪辑装配证据时,只能声明“方案通过”,不得声明“成品发布通过”。
README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Script to Shootable Storyboard
  2. 将剧本、故事梗概、对白稿、已有分镜或视频生成提示,转换为忠实、可拍、可剪,并适合 Seedance、真人或混合制作的原子分镜。
  3. 这个项目以 Codex Skill 的形式提供一套完整的影视预制作工作流:从来源冻结、剧情分析和心理描写视觉化,到镜头拆分、场面调度、连续性管理、声音计时、生成任务编译、风险评分和交付检查。项目同时包含可复用模板、JSON Schema、命令行验证器与回归测试。
  4. 本 Skill 使用 Codex 开发,围绕 Codex 的 Skill 机制与工作流进行优化,因此在 Codex 中运行效果最佳。项目采用模块化设计,可直接使用,也可用于剧本转分镜、AI 视频预制作及其他影视智能工作流的二次开发。
  5. ## 核心能力
  6. - 忠实转换:默认只进行拆分、画面化和最小必要补全,未经授权不改写剧情。
  7. - 原子镜头:约束每个镜头的连续时空、主导景别、主要动作和摄影运动。
  8. - 可拍与可剪:检查动作、对白、反应、运镜、声音、Coverage 和镜头时长是否闭环。
  9. - 连续性管理:追踪人物站位、视线、轴线、服装、道具、环境与声画状态。
  10. - Seedance 适配:将镜头编译为一镜一任务的 Generation Task,并配置验收条件和失败降级路径。
  11. - 真人/生成/混合制作:支持逐镜选择制作方式,并管理混合制作交接要求。
  12. - 权利与安全:对素材来源、肖像、声音、隐私、同意和平台合规设置人工审核门禁。
  13. - 机器可验证:提供 40 余个 JSON Schema、多组验证器、成本估算和修复计划工具。
  14. ## 适用场景
  15. - 剧本或故事梗概转专业分镜
  16. - 已有分镜的可拍化、原子化与连续性修复
  17. - 心理描写、抽象氛围和作者评价的视觉化
  18. - 竖屏短剧的首屏钩子、节奏、爽点与台词时长设计
  19. - Seedance 视频生成任务拆解与提示词编译
  20. - 真人拍摄、AI 生成和混合制作的前期规划
  21. - 分镜方案的结构、时长、版权、安全与交付质量审查
  22. ## 工作流程
  23. ```text
  24. 输入冻结
  25. → 剧情与人物分析
  26. → Story Bible / Beat Sheet
  27. → 抽象内容视觉化
  28. → Blocking 与 Coverage
  29. → 原子 Shot
  30. → 真人 / Seedance / 混合制作决策
  31. → Generation Task
  32. → 质量验证与风险降级
  33. → 分镜表、任务表和质量报告
  34. ```
  35. ## 安装
  36. 需要 Git 和 Node.js 18 或更高版本。项目脚本只使用 Node.js 内置模块,无需安装 npm 依赖。
  37. 将项目克隆到 Codex Skills 目录:
  38. ```powershell
  39. git clone https://github.com/zyz254009-crypto/script-to-shootable-storyboard.git "$env:USERPROFILE\.codex\skills\script-to-shootable-storyboard"
  40. ```
  41. 重新打开 Codex 任务后,可通过 `$script-to-shootable-storyboard` 调用。
  42. ## 快速开始
  43. 1. 复制 [项目输入模板](assets/project-input-template.yaml),填写原稿类型、制作方式、画幅、时长、修改权限和来源信息。
  44. 2. 在 Codex 中附上剧本或已有分镜,并使用类似提示:
  45. ```text
  46. 使用 $script-to-shootable-storyboard,把这份剧本转换为忠实、可拍、可剪的原子镜头与 Seedance 生成任务。
  47. ```
  48. 3. 根据交付目标选用项目模板:
  49. - [Markdown 分镜模板](assets/storyboard-template.md)
  50. - [CSV 分镜模板](assets/storyboard-template.csv)
  51. - [已有分镜修复模板](assets/existing-storyboard-repair-template.md)
  52. - [Seedance 生成任务模板](assets/generation-task-template.md)
  53. - [质量报告模板](assets/quality-report-template.md)
  54. 4. 使用验证器检查生成的项目数据:
  55. ```powershell
  56. node scripts/validate-all.mjs --input <project.json> --pretty --require-validators
  57. ```
  58. ## 常用命令
  59. ```powershell
  60. # 检查 Skill 目录结构和内部链接
  61. node scripts/check-skill-structure.mjs
  62. # 运行完整回归测试
  63. node scripts/run-regression-tests.mjs
  64. # 验证项目数据
  65. node scripts/validate-all.mjs --input <project.json> --pretty --require-validators
  66. # 根据质量报告生成最小修复计划(不会自动修改项目)
  67. node scripts/build-repair-plan.mjs --report <quality-report.json> --project <project.json> --pretty
  68. # 估算制作成本与失败成本
  69. node scripts/estimate-cost.mjs --input <project.json> --pretty
  70. ```
  71. ## 目录结构
  72. ```text
  73. .
  74. ├── SKILL.md # Skill 主入口与完整工作流
  75. ├── agents/openai.yaml # Codex 界面元数据
  76. ├── assets/ # 输入、分镜、任务和报告模板
  77. ├── references/ # 方法论、规则、模型档案和制作规范
  78. │ └── schemas/ # 机器可读的 JSON Schema
  79. └── scripts/ # 验证、测试、风险评分、成本和修复工具
  80. ```
  81. ## 设计原则
  82. - 剧情事实必须可追溯到原稿或明确授权。
  83. - 摄像机和麦克风无法记录的解释,必须转换为可见或可听证据。
  84. - 一个原子镜头默认对应一个 Generation Task,并允许多次生成尝试。
  85. - 生成失败时优先降低复杂度,而不是偷偷改变剧情。
  86. - 未知的权利、隐私、同意和合规状态必须交给人工审核。
  87. ## 验证状态
  88. 当前版本已通过:
  89. - Skill 结构与内部链接检查
  90. - 102 项回归测试
  91. - 全部 JavaScript 文件语法检查
  92. ## 贡献
  93. 欢迎提交 Issue 或 Pull Request。提交前请运行结构检查和回归测试,并确保新增 Schema、模板、引用文档和验证规则之间保持一致。
  94. ## 许可证
  95. 本项目采用 [MIT License](LICENSE) 开源。
  96. > 本项目中的权利、安全与合规检查用于辅助制作决策,不构成法律意见。模型能力、价格和平台政策可能变化,实际制作前请重新核验。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.