short-drama-storyboard

短剧分镜与冻结关键帧

把剧本和视觉事实转成有镜头职责、空间连续性和可冻结起点的 剧集/<EP>/分镜.md。 每镜使用二级标题 ## SHOT-...，同镜下用 ### 冻结关键帧提示词 写起始帧正文； 需要时另加 ### 收尾关键帧提示词 写终点正文。

Quick Start

用 $short-drama-storyboard 完成 EP001 的正式分镜和每镜冻结关键帧

入口

当前剧本加必要视觉事实即可直接进入。资产图片提示词与分镜是兄弟分支，不互相等待。只有关键场次 真的存在多个成立导演方案时，才在上下文比较覆盖方案；普通场次直接设计。

创作者可读说明跟随项目语言；冻结关键帧的可复制正文跟随 short-drama.json#/format/prompt_language。没有 short-drama.json 时正文默认使用 en。 分配镜头时长前读取 short-drama.json#/creator_authority/production_profile/choices/native_duration_seconds。已声明目标模型但 没有原生时长时先补这一个选择；目标模型也未声明时照常按叙事节奏设计，不猜供应商限制。 同时读取 short-drama.json#/creator_authority/rhythm_profile：status 为 accepted 时，镜长按 镜长从哪来 由声音事件与 target_avg_shot_seconds 推出， 全集近景类镜头占比不低于 close_shot_share_min；档案缺失或未接受时不核对这些数值。

冻结关键帧成稿后，再按画面中的可见内容填写视觉依据、图片提示词项和输入参考图， 避免只按镜头意图列资产而漏掉实际入画的人物或物件。

用户没有手工点名参考图，不等于选择文生视频。冻结关键帧后先根据本镜可见人物、地点、关键道具与 起始构图判断一致性需求，再检查项目中已有的真实图片。只有当前可读、内容与用途可核对的图片才能自动绑定； 文件名像某个角色但内容未核对时，仍视为未准备好。

项目里没有所需图片时，一次向创作者说明三条可选路径：把手上已有的图片放进项目再绑成 REF-...；在自己的工具里出图、本轮先用 PLAN-... 写出挂图计划；或者明确改走文生视频。用本套件的生产技能出图只是第一条路的一种做法， 需要项目外的 adapter 与凭据，不是唯一入口。

开始分镜前读 剧集/<EP>/剧本.md 的当前内容。创作者说「剧本已确认采用」指的是那个文件， 不是对话里更早的草稿；两者不一致时以文件为准，并把差异说出来。

工作流

1. 读取已接受的目标模型原生时长区间，再确认每个场景动作、对白、声音、画面文字和转折由哪些镜头承载。

2. 确定观众何时知道什么、对齐谁、空间如何揭示、转折落在哪个可见动作。 剧本或 Brief 用“前半段 / 后半段 / 前三分之一 / 最后 N 秒”等相对时间限定首次出现、释放或禁止时， 先用已接受集长换成明确时间边界再分镜；例如 60 秒作品的“后半段首次出现”不得早于 30 秒。

3. 每镜写清唯一职责、来源、时长、景别/机位、运镜、起点、唯一主要动作、终点和声音；用 起点 → 唯一动作 → 终点 直接说明人物、双手与持物怎样完成本镜状态转换。三条依据留到第 6 步。 数一下这一镜要观众看清的事，按镜长判断每件有没有足够的时间被看清；放不下时先删、合并或拆镜，见 短镜头的动作量：视频模型不会删掉多出来的动作，而是把它们压到看不清。 「运镜」按本镜目的逐镜选，写行为和理由，固定也写理由，见 运镜逐镜选。 有对白、VO 或 OS 时，先按原文和人物说话方式估算完整发声时间，再安排不能重叠的动作、停顿与 末尾反应；把估时依据简写在本镜「声音」里。具体做法见 对白估时。 对白场先按 对白覆盖默认 放切点；镜长不按剧本字数折算。

4. 一场戏拍成多镜时，先在《分镜.md》开头写这场的「场景站位」：固定锚点、各人相对锚点与彼此的位置、轴线与 working side、哪一镜改变站位。再逐镜锁定朝向、位置、视线、持物、出入口和必要状态，与「场景站位」一致；起点、终点里的位置写锚点和人物关系，视线写看向谁或什么；冻结关键帧再把它翻成本镜机位下的前后景、朝向、中间隔着什么和画面左右，见 站位先写锚点和关系。上游已有会限制动作空间的持续关系时，把关系投影进本镜起点与终点。

5. 冻结关键帧只投影镜头起点；删除终点才出现的文字、动作、姿态或道具状态。 镜头的职责落在收尾那一下时，另写 ### 收尾关键帧提示词 投影终点——同一格画面的 另一端，规则完全对称：删除起点才有、终点已经不在的东西。它是可选的，写法与取舍见 首尾成对。

6. 关键帧成稿后，先从成稿正文读出这一格里需要保持身份、造型或地理的人物、地点和道具， 再用同一份清单一次填满三条依据：

   • 视觉依据：清单里每一项写成《视觉设定.md》的条目引用，这是必写字段；
   • 图片提示词项：清单里已有合适 IMG-... 条目的写上，没有的留「无」；
   • 输入参考图：按清单在用户提供的输入、剧集/<EP>/制作成果/ 和文档已指向的其他可见媒体中查找匹配图片； 命中就写入 REF-...。一张都没命中时写「无（待补参考图：<本镜缺失的起始帧、人物、地点、道具>）」； 只命中一部分时，在已有 REF-... 后追加「；待补参考图：<仍缺的图片>」，缺口之间只用 、 分隔。 创作者说图片由他自己在别处准备时，把这份清单写成 PLAN-... 槽位，本镜即告就绪； 只有创作者明确表示不用图时，才写「无（创作者已明确选择文生视频）」。

   三条依据读的是同一格画面，所以不能互相矛盾：关键帧里点名的人物或道具，一定出现在视觉依据里。 目标模型的参考槽位有上限（Seedance 2.0 全模态参考最多 9 张图）时，输入参考图按失去它的代价从高到低保留：起始帧、正在说话或做主要动作的人物、必须认得出的道具、地点、其余入画人物、定调图；放弃的那些写明，必要事实进关键帧正文。

7. 整集请求完成整集，末端一次报告覆盖、节奏和真实未决选择。

镜头要求

• 每镜有唯一职责、明确来源、可见起止状态和合理时长。「来源」以《剧本.md》里真实存在的场景 ID 开头， ID 之后可以跟必要短引文，跨场次的镜头用 、 连写多条；creator_markdown_check.py 会核对每个 ID 都解析得到。

• 「来源」短引文应对应本镜承担的动作或声音。正文提到画外人物时，可在视觉依据写 ；画外：<类别>「<名称>」；这只声明其不在画面，不能代替必要动作的落实。 需要看见的动作应另有镜头承载，或说明为何省略。

• 剧本里的每个场景都要有镜头承载。确实决定不拍某一场时，在《分镜.md》正文开头写一行 - 未拍场次：<场景 ID>（理由：……），多项用 ； 连接。省略理由必须留在成稿文档中，供下游区分有意省略与遗漏（SHT-01）。

• 已声明原生时长时，每镜照常有自己的唯一职责、起止边界和冻结关键帧，镜长先按叙事需要定。短于最短秒数 的镜头，向创作者提议把同场相邻的几镜装进一个多镜容器；创作者同意后由 $short-drama 在生产档案里写入 multi_shot_containers: true；目标方言要求时，容器的每一切 都要有已接受的关键帧图片，能否装、怎么装由 $short-drama-video-prompts 的方言决定。创作者没有声明 多镜容器、或方言不支持时，镜头落在最短秒数内，动作完成后保持终点。长于上限的动作按可见状态闭合点拆镜， 拆出的每镜仍各有唯一职责与可信交界。目标模型只收整数秒（如 Seedance 2.0 手动时长）时，单独生成的镜头写 整数秒；准备装进同一个多镜容器的短镜可以写半秒，但同一容器的成员加起来必须是整数秒，在分镜阶段就排好， 不留到视频提示词阶段分组时才发现凑不齐。

• 「唯一动作」写从本镜起点到终点的那条可见状态链；涉及交接、换手、放置或取回时，把接触者、 接触方式和物件落点写在同一链里，不能让合法终点之间靠镜外瞬移衔接。

• 切镜必须带来信息、权力、情绪、空间或节奏变化；同义重复镜头删掉。

• 相对时间词约束的是事件首次可见或可听的时刻，不因前置动作已经完成就提前释放；分镜时间轴直接 写出该边界，不把“稍后”“交接后”等叙事顺序当成数值时间的替代。

• 同一动作不跨镜重复发生，峰值处声明过的冲击重复除外；终点应能成为下一镜可信起点。

• 关键信息的可读性优先于装饰性运镜，竖屏构图优先保证主体和反应可见。

• 复杂群戏先在「场景站位」里锁空间锚点、人物位置和轴线，再决定景别变化。

• 起终边界除了逐人姿态，还要写清本镜依赖的身体—物件—空间关系。关系在镜内不变时两端都保留；确需改变时，过程与终点必须有剧本依据。

• 冻结关键帧只写该瞬间能看见的内容；文字、手指、反射和遮挡要可生成。

• 近景类关键帧挂着地点板生成时，图片常被拉宽成中远景；正文写具体取景（画面切在哪、脸在画面哪里、机位距离），出图仍偏宽就这一镜不挂地点板，把背景写进正文。

• 一集的关键帧要像同一部片：每条正文用同一句画风（写实就写写实，不混用「漫剧」「插画」这类会把一部分图拉向插画脸的词），每个场景写同一句光与色温；生成时先出该场景一张中远景作定调图并接受，其余镜头把它作为最后一张参考、只取色调、光线与质感，不取构图。

• 《视觉设定.md》的连续性锁在生效镜头上原样写进冻结关键帧正文；锁面不因“参考图会交代”而省略。

• 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。镜头块里的「视觉依据」是本镜的依据字段，不属于额外覆盖表。

視覚的根拠と画像

• IMG-... は《画像提示词.md》内のプロンプト項目 IDであり、画像が生成済み、提供済み、または利用可能であることを意味しません。
• 《图片提示词.md》があり、このショットでその項目が必要な場合は、「画像プロンプト項目」を記載します。ID は同文書の見出しレベル 2 の表示タイトルと一致させ、中国語名と、その項目が制御するアイデンティティ、造形、地理、構図、その他の範囲も記載します。ID は検索にのみ使用し、英語の slug に意味を担わせないでください。
• 《图片提示词.md》がない、または適切な項目がない場合は、「画像プロンプト項目：なし」と記載し、《视觉设定.md》の人物、場所、または小道具の項目と制御範囲を中国語で示します。これは通常の直接参照先です。ストーリーボードを続けるために ID を捏造したり、別の段階を補作したりしないでください。
• 「視覚的根拠」は各ショットに必須の項目です。フリーズしたキーフレームの完成後、実際の画面を照合し、アイデンティティ、造形、または地理の一貫性を保つ必要がある、画面内に見える人物、場所、小道具を必ず個別に次の形式で記載します。 《视觉设定.md》·<人物|造型|地点|道具>「<名称>」（控制：<范围>）。複数ある場合は ； でつなぎます。名称は《视觉设定.md》に同名の見出しがある必要があります。 背景や小さく映る人物でも、身元を識別する必要があるなら対象に含めます。画面外の声や識別不能な部分は含めません。このショットに該当する項目が本当にない場合は、「視覚的根拠：なし」と記載します。
• キーフレーム本文に項目名が出ていても、その項目が実際にはこのショットの画面内にない場合（所有者がすでに退場している、名前が画面上の文字にだけ出ている、ある語と同じ表記であるなど）は、「視覚的根拠」の末尾に ；画外：<类别>「<名称>」 を追加します。この記載は名前が言及されていることだけを示し、人物や物品が画面内に映っていることを意味しません。
• 項目名が本文中で確実に特定できない場合（道具「手机」 が「手机店」と衝突する、人物「小雨」 が「下着小雨」と衝突するなど）は、視覚設定を担当するスキルがその項目に 画面代称：无 と記載します。機械的な照合では名前による検索を行わなくなります。このショットに映っているかどうかは、引き続き「視覚的根拠」で事実どおりに回答します。
• 3種類の根拠はいずれも、現在のキーフレーム内で見える内容だけを記述します。「制御」には、この一コマで担保できる範囲だけを記載します。手の甲のクローズアップに「本編の造形」とは書かず、画面と指一本しか映らないショットに「体格」とは書きません。キャラクターが同じ場面にいるというだけで、前のショットの紐付けを次のショットに引き継がないでください。
• キーフレーム本文で名前を明示された人物、場所、または小道具（《视觉设定.md》の項目名、または同文書で宣言された「画面代称」）は、このショットの「視覚的根拠」に記載する必要があります。 creator_markdown_check.py がこのルールを機械的に照合します。照合するのは名前が明示された対象だけです。本文で名前を挙げずに説明した場合（"a boy in a hooded jacket" など）、機械チェックは何も指摘しません。画面に誰が映っているかは、この段階で自分で読み取る必要があり、エラーが出るのを待ってはいけません。
• 一貫性を保つ必要があるものの、《视觉设定.md》にまだ項目がない、画面内に見える物品（複数ショットに登場する小道具は特に該当します）について、「視覚的根拠に書けない」ことを理由に一貫性が不要だと考えてはいけません。4つのショットすべてに登場するペン1本や上着1着も同じ問題です。次の2つを行ってください。 本文ではショットごとにまったく同じ説明を使って固定し、今回の最後の報告でそれを明示して、$short-drama-assets で項目を追加するよう提案します。 自分で《视觉设定.md》に項目を追加したり、既存項目であるかのように「視覚的根拠」に含めたりしないでください。
• 「入力参照画像」は独立した別の軸です。クリエイターが提供した、または制作済みで現在読み取り可能であることを確認済みの実画像を、IMG-... とは異なる安定した REF-... スロットで参照します。各スロットには明示的な順序、/ のみで区切ったプロジェクト相対パス、中国語名、「用途」、「制御」、「制御してはならない範囲」を同時に記載します。該当画像がない場合は、「参照画像を追加予定」と「クリエイターがテキストから動画を生成することを明確に選択済み」を区別する必要があります。一部だけ用意できている場合は、既存の REF-... を残し、「；参照画像を追加予定：……」を追加します。プロンプト項目、未生成の画像、または会話中の説明を REF-... として記載してはいけません。REF-... は「ファイルが今この時点でプロジェクト内にある」ことを意味します。 生成時にクリエイター自身が添付する画像は、以下の PLAN-... を使用します。これもファイルが存在するとは主張せず、このショットにどの画像を添付するかだけを明確にします。
• 各 REF-... は、次の唯一の形式に一字一句従う必要があります。REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）。「顺序：」の後の全角コロンと、パスの前の中点 · に注意してください。フィールドの区切りに / を使ってはいけません。複数画像は中国語のセミコロン ； だけでつなぎます。一部の画像が不足している場合は、最後の完全なスロットの後に ；待补参考图：<缺口> を追加し、不足項目どうしは 、 で区切ります。記載後、提出前にこの形式に照らして一度読み直してください。
• 用途 に指定できるのは、身份、造型状态、地理、构图、尺度、效果、起始帧、结束帧、风格 のいずれかだけです。それぞれが制御できる内容は、$short-drama の《参考角色》を参照してください。 このショットの開始画面画像には 用途：起始帧、人物画像には 用途：身份 または 造型状态、シーン画像には 用途：地理 を指定します。小道具の状態画像は、その画像が決定する対象に応じて指定します。 1枚の画像が2つの役割を担う場合は、スロットを2つに分けます。1ショットにつき 起始帧 と 结束帧 はそれぞれ最大1つです。结束帧 を記載する場合は、同時に 起始帧 も必要です。 下流の動画プロンプトは 用途 によって「このショットで送るストーリーボードの開始フレームと、どの人物／小道具／シーン画像か」を判断します。そのため、用途 がないスロットは準備済みとして扱われません。
• このショットの開始画面画像がまだない場合、選択肢は2つあります。クリエイターがこのツールキットで制作する場合、用途：起始帧 の画像は $short-drama-produce がこのショットのフリーズ済みキーフレーム本文から生成します。job の source には 剧集/<EP>/分镜.md、source_entry にはこのショットの SHOT-... を記載し、生成物は 剧集/<EP>/制作成果/images/ に保存します。実ファイルを取得後、REF-... に紐付けます。クリエイターが自分のツールで制作する場合は、フリーズ済みキーフレーム本文をコピーして画像を生成し、ファイルをプロジェクトに入れて REF-... に紐付けるか、このラウンドでは次のように記載します。 PLAN-SHOT-START（顺序：<n>）· <本镜 SHOT-...>《本镜冻结关键帧》（用途：起始帧；……）。 どちらも行っていない場合は、引き続き「参照画像を追加予定」の項目として扱います。
• クリエイターがプロジェクト外で画像を生成し、画像をプロジェクトに入れない場合は PLAN-... スロットを使用します。構文は REF-... と一字一句同じで、プロジェクト相対パスだけを IMG-... または SHOT-... の項目 ID に置き換えます。IMG-... の中国語名は《图片提示词.md》のタイトルと一致していなければなりません。 これは「この画像を生成時にクリエイターが指定の順序で添付する」ことを示すものであり、プロジェクト内にファイルがあるとは主張しません。そのため「追加予定」にはならず、制作にも使用できません。実ファイルがプロジェクトに入ったら REF-... に書き換えます。2種類のスロットは混在可能で、「顺序」は連番に統一します。
• 自動紐付けは、すべての画像を1つのショットに詰め込むことではありません。このショットで見えるもののうち、アイデンティティ、造形、地理、重要な小道具の状態、または開始時の構図を実際に安定させる必要がある画像だけを選びます。それぞれについて、用途、制御できる内容、制御してはならない内容を明記します。
• 2つの軸は独立して組み合わせられます。有効な画像プロンプト項目がある場合でも、入力参照画像は「追加予定」またはクリエイターが明確に選択したテキストからの動画生成にできます。クリエイターが実際の参照画像を提供した場合でも、画像プロンプト項目は「なし」にできます。

必要に応じて参照する知識

デフォルトでは、この SKILL、現在の脚本、必要な視覚的事実のみを読みます。該当する問題に遭遇した場合に限り、対応する資料を1つだけ開きます。

• 段階の境界とルールの階層：阶段契约
• ショットの役割、カットの理由、ショット尺の導出、セリフのカバー範囲と境界：镜头手艺
• 実制作で必要となるショット文法：生产镜头语法
• 重要な場面における監督案の比較：场次视觉计划
• 原文のすべてに画面上の表現があるかの確認：Coverage Audition
• 複数人、集団、複雑な空間の動線設計：调度手册
• 誰をどう照らすか、実行可能な書き方：光的设计
• 凍結する瞬間、視線の中心、読み取りやすさ：关键帧手艺
• 漫画ドラマ／2D 漫画形式で共有する画風用語：漫剧关键帧词表
• 脚本からキーフレームまでの完全な例：剧本到关键帧
• ショットの分割、統合、安定したショット ID：镜头修订身份
• 完了前の連続性チェック：审查与示例

修訂

影響を受けないショット ID は維持します。ショットを分割・統合したり、ショットの役割を変更したりする場合は、どの下流の動画プロンプトを更新する必要があるかを説明します。ただし、ユーザーが指定していないファイルを自動的に書き換えてはいけません。

完了

指定範囲の原文すべてにショットが割り当てられ、各ショットの役割が重複せず、空間と状態に連続性があり、開始点と終了点が制作可能で、キーフレームをフリーズできること。各ショットの「来源」が《剧本.md》内の実在するシーンに解決でき、脚本内のすべてのシーンにショットが割り当てられているか、「未拍场次」に記録されていること。さらに、各ショットのキーフレーム内に見える人物、場所、小道具がすべて、そのショットの「視覚的根拠」に記載されていること。画面に必要だが《视觉设定.md》にまだ項目がない可視物品は、末尾の報告で個別に明示します。今回の依頼で《图片提示词.md》と《分镜.md》を同時に変更する場合は、同じラウンドで影響を受けるショットの参照を更新します。カバレッジ表は別途作成しません。 動画プロンプト、制作、レビューは、ユーザーが指定した場合に限り開始します。 この段階の文書を書き終えた後、$short-drama に進んで部分的な機械チェックを実行できます（既存文書のみをチェック）。5つすべてが揃った後に、完全なチェックを実行します。内容の品質は引き続きクリエイターが確認します。