@lemoncat7/dsh-partner 2.4.2 → 2.7.0

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: short-drama-video-prompts
+description: 把短剧分镜和冻结关键帧写成可直接复制的视频提示词 Markdown，也可按用户要求写时间线配乐/主题曲意图。用户提到文生/图生视频动作、人物表演、运镜、口型、环境运动、镜头时长、起止状态、把分镜转成视频提示词或写配乐提示词时使用；不生成媒体、不创作歌词、不改分镜边界。
+license: MIT
+---
+
+# 短剧视频与时间线音乐提示词
+
+把已确认镜头和起始帧写成有边界、可生成、可直接复制的 `剧集/<EP>/视频提示词.md`。
+每镜使用 `MOTION-...` 标题并引用对应 `SHOT-...`。
+
+## Quick Start
+
+```text
+用 $short-drama-video-prompts 把 EP001 分镜逐镜写成可直接复制的视频提示词
+```
+
+## 入口与边界
+
+有当前分镜、冻结关键帧和必要视觉事实即可检查参考准备；图片提示词不是已有图片的证明。运动提示词拥有从已确认
+起点到终点的变化：表演动作、道具状态、运镜、节奏和声音提示。先按分镜的「输入参考图」选择路径：
+
+- 有可读的真实 `REF-...` 图片时是**图生视频**；原样携带分镜中的槽位、顺序、项目相对路径、
+  中文名称、用途、控制与不得控制范围，静态身份、造型、地点和构图可由参考帧与视觉设定共同拥有。
+  这一行就是本镜的素材清单：路径回答「送哪一张」，`用途` 回答「它在本镜负责什么」，`顺序` 回答
+  「在可复制正文里叫哪个标签」。回答不了这三问的槽位不算准备好。
+- 「输入参考图：无（创作者已明确选择文生视频）」时才是**文生视频**；视频文档必须写非空「静态视觉锚点」，且把它原样纳入
+  可复制正文，让提示词本身交代人物、造型、地点、构图和光线中本镜必要的事实。不得只写
+  `preserve/keep/保持已有外观`，因为执行端没有收到可供保持的图片。
+- 有 `PLAN-...` 槽位时同样是**图生视频**：图片由创作者在生成时自行挂载，本套件没有文件可送。
+  正文照常按图生视频写，`顺序` 就是创作者挂图的次序，`用途` 说明每一张在本镜负责什么。
+  这些镜头不能转 `$short-drama-produce`；要投产就先把真实文件放进项目、改写成 `REF-...`。
+- 「输入参考图：无（待补参考图：……）」、已有 `REF-...` 或 `PLAN-...` 后仍带「；待补参考图：……」，或普通的「无」都表示**未准备好**，不是文生视频授权。先自动查找可用真实图片并请分镜 owner
+  刷新绑定；仍有缺失时，列出镜头、缺失图片及对应 `IMG-...` 或冻结关键帧，不写最终《视频提示词.md》。
+
+创作者可读说明跟随项目语言。开始前读取目标模型档案里的版本、执行模式、提示词方言、原生时长和
+参考方式；这些选择同时约束上游分镜和下游 adapter，不能只在正文阶段临时猜。创作者在本次请求里点名
+目标模型（例如“按 MiniMax H3 写”）而项目档案还没有这一项时，先转 `$short-drama` 把这个选择写进
+`short-drama.json` 的 `production_profile`，再回到本阶段；一句会话里的点名如果没有落到档案上，
+下一轮就会退回通用路径，方言、原生时长和参考方式又要重猜。没有项目配置的独立任务把点名的模型
+和已解析的方言写在本文档开头一行，供下游核对。视频可复制正文优先跟随
+`short-drama.json#/creator_authority/production_profile/choices/video_prompt_language`；未声明时回退到
+`short-drama.json#/format/prompt_language`。没有 `short-drama.json` 时，根据用户点名的目标视频模型
+确认正文语言；目标模型也未声明时沿用用户当前语言，不固定为英文。对白、VO、OS 的口语语言仍由
+剧本和声音方向决定，不能从提示词正文语言推断。
+
+目标为 `seedance-2.0` 时按 [Seedance 2.0 方言](references/seedance-2.0.md) 写，目标为
+`seedance-2.5` 时按 [Seedance 2.5 方言](references/seedance-2.5.md) 写，目标为 `minimax-h3` 时按
+[MiniMax H3 方言](references/minimax-h3.md) 写。只读命中的一份。其他目标或版本不
+套用相近模型的语法，继续按 [目标模型能力档案](references/target-model-profile.md) 的通用路径写。
+
+沿用 creator-first 既有骨架：`## MOTION-... · 中文名`，字段名依次使用「分镜、时长、生成方式、
+输入参考图、静态视觉锚点、起始帧、状态链、终点」，正文标题使用 `### 可复制提示词`。静态视觉锚点
+跟随本镜已解析的视频提示词语言并原样进入正文；正文每个非空行都以 `>` 组成 Markdown 引用块。
+重写内容不能改名、另造替代字段或改成普通段落。
+
+## 工作流
+
+1. 先检查每镜「输入参考图」。用户未手工点名图片时，根据本镜冻结关键帧和可见人物、地点、关键道具的一致性需求，在用户输入、
+   「制作成果」和文档已指向媒体中查找真实图片。内容和用途核对后才自动绑定；不靠相似文件名猜图。
+2. 已有匹配图片时，在当前请求内先让分镜 owner 原地刷新受影响镜头的 `REF-...` 槽位，再回到本阶段；只绑本镜真正需要保持的图，不按资产数量凑槽位。
+   同一次刷新里，如果这些镜头还缺「视觉依据」这个必写字段（旧文档常常没有），一并按已成稿的冻结关键帧回填——
+   两者读的是同一格画面，分开两轮只会让绑了图的镜头仍然说不清画面里有谁。
+   新槽位必须逐字使用 `REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途：<用途>；控制：<范围>；不得控制：<范围>）`；`用途` 取 `身份|造型状态|地理|构图|尺度|效果|起始帧|结束帧|风格` 之一，不得自创斜杠分隔写法。多图只用 `；` 连接，写完后先按格式回读，再复制到视频文档。
+3. 仍有必要图片缺失时，一张都没有就把分镜写成「无（待补参考图：……）」；只缺一部分则保留已核对的 `REF-...`，并在末尾追加「；待补参考图：……」。一次列出缺失镜头、图片用途和对应的 `IMG-...` /冻结关键帧，然后停在视频提示词之前。
+   不伪造路径，不把图片提示词当成图，不静默降级为文生视频。
+   报告缺口时把创作者真正有的三条路一起说清楚，不要只给「生成参考图」和「改成文生视频」：
+   把已有图片放进项目绑成 `REF-...`；由创作者在自己的工具里出图、本轮先写成 `PLAN-...` 挂图计划；
+   或者明确改走文生视频。缺口清单本身就是那份挂图计划的草稿，逐镜写清要哪几张、每张管什么。
+4. 只有创作者明确选择不用参考图时，才把分镜记为「无（创作者已明确选择文生视频）」。准备闭合后原样抄入分镜的「输入参考图」，据此标明
+   「生成方式：图生视频」或「生成方式：文生视频」。该字段只写这两个精确值，不追加模型名、方言或 full-reference 等说明；模型说明留在正文结构中。
+   具体走首帧、首尾帧还是多槽参考，由各槽位的 `用途` 组合读出：只有一张 `起始帧` 走首帧，`起始帧` 加 `结束帧` 走首尾帧，
+   `起始帧` 与人物/地点/道具图同时存在或只有这些图时走多槽参考。命中的模型方言负责把这个组合翻成它自己的素材 role 与正文结构；
+   多槽参考与首/尾帧在同一请求内互斥的模型，起始帧也随整组走多槽参考，不拆成两套输入。
+5. 核对本镜时长落在目标模型档案的原生区间内；不在区间内就回到分镜修订，不能写完提示词后留给
+   adapter 报错，也不能在正文里暗自改变时长。
+   有对白、VO 或 OS 时，同时核对分镜「声音」中的估时依据与实际可用发声窗口；缺少依据就按
+   [对白预算](references/performance-action-timing.md#对白预算) 补做判断。秒段加总正确不代表台词说得完。
+6. 写不能动的边框：图生视频以参考帧和视觉设定锁定；文生视频把必要静态事实写入「静态视觉锚点」和可复制正文。
+7. 原样读取分镜的「起点 → 唯一动作 → 终点」，确认人物、双手和持物的状态转换都发生在镜内。
+8. 写“静态锚点 → 起点 → 唯一动作（触发、接触、落点）→ 次级反应 → 运镜 → 声音 → 终点”，
+   必要时用秒数分段；下一镜从这个终点继续，不另造镜外转换。
+9. 只在真实参考帧已经说明静态外观时删除重复描述；《视觉设定.md》连续性锁的锁面不在可删之列。
+10. 把限制动作空间的已确认关系写成贯穿本镜的正向可见状态，只安排关系允许的动作通道；只有分镜明确改变关系时才写变化过程。优先用可见状态说明边界，必要时保留明确的排除条件。
+11. 逐镜读取文字义务。除非剧本或创作者明确要求，正文用本镜已解析的视频提示词语言直接写明任何时刻都不生成非画内字幕、caption 和对白文字叠加，不能只写抽象的“文字层为空”；这条默认与旗帜、标牌、屏幕等画内文字独立。画内 `exact_readable` 逐字写明字符、语言、承载面和位置，不能用全局 `no-text` 覆盖。
+12. 声音同轨时，把允许的发声按来源、说话人、口语语言和顺序写成完整时间线；每句从原文首字到末字，
+   且逐字对白在单镜可复制正文中只出现一次。视觉动作段只按时间和说话人引用该声音事件，不再抄一遍
+   台词。事件外回到已声明的环境声或静默。Brief、剧本或声音方向已经明确禁止外语前导、语气词、
+   额外人声或重复时，把这些**已确认的发声边界**在完整时间线末尾合并写一次；不靠“只包含”让执行端
+猜，也不自行扩充新的禁用类别。时间线总结只列本镜实际有的声音层。
+   无对白镜写清底声或静默及其覆盖区间；嘴部动作按剧本表演，不默认强制闭嘴。
+   非画内配乐按目标方言声明，有需要时明确写空。
+13. 成稿时检查动作、声音和限制条件是否清楚且相容。正面状态有助于表达目标，必要的否定条件
+   可以保留；不按否定句数量判错。确认不跨下一镜、不要求互斥动作、不让人物或道具瞬移变形。
+
+14. 用户要整集就完成整集，镜头组只是内部批次。
+15. 同一连续时空中相邻正式生成段、且目标档案支持续接时，默认选择“从上一段生成结果续接”；
+    一镜一生成只决定每次装一个镜头，不等于各镜独立文生。只有创作者明确要求独立重生成，或上游
+    已接受时间/地点跳变时才重新起链。选择续接后，这就是该链唯一正式执行路由。第二段起同时绑定上一段
+    **实际视频**和从该视频取得的
+    **实际尾帧**：视频负责动作、节奏和声音连续，尾帧负责下一段的可见起点。具体素材 role 和续写措辞
+    由命中的模型方言决定，不能把通用职责直接翻译成供应商字段。未取得真实产物时，后续段在
+    `视频提示词.md` 标为“待续接、不可提交”，写明缺少这两项真实输入并保留下一段内容草案；不得把它
+    降级成独立文生视频，也不用计划尾帧、关键帧提示词或文字描述冒充接力输入。逐镜 `MOTION-...`
+    仍是成员边界和内容依据，不是与正式容器路由并列的另一套提交方案。
+
+## 提示词要求
+
+- 从可见起点开始，以可验证终点结束。
+- 可复制正文完整实现分镜的「起点 → 唯一动作 → 终点」；交接、换手和道具落位不跨镜省略。
+- 主体、动作对象、方向、幅度、速度和先后关系明确。
+- 表演写动作与反应，不写无法执行的抽象结果。
+- 运镜与人物动作不争夺注意力；复杂运镜必须有叙事理由。
+- 声音只写该镜需要的对白、画外音、环境或转场职责，不擅自补歌词。
+- 非画内字幕、caption 和对白文字叠加默认不生成；正文直接声明全镜任何时刻都不生成这些内容，不用抽象工作流术语代替执行指令。只有剧本或创作者明确要求才开启。画内精确文字是独立允许集合，不因关闭字幕而消失，也不让未批准文字混入。
+- 同轨对白/VO/OS 同时写逐字文本、口语语言和发声边界；不添加来源没有的声源或重复限制。
+- 无对白镜同样说明底声或静默；时间线总结与实际声音层一致。H3 无非画内配乐时写 `non_diegetic_music: N/A`。
+- 正文里被引号或 `<d>` 包起来的中文必须逐字来自《剧本.md》，画内标牌文字可来自《视觉设定.md》；
+  分镜自己写下的画内文字与声音同样算数。`creator_markdown_check.py` 会核对四字以上的引文（VID-25）。
+  台词不在剧本里就回到写作技能改剧本，不在提示词里改。
+- 上游持续关系用贯穿状态和允许动作通道表达，避免重复限制或冲突动作。
+- 本镜命中的连续性锁，锁面原样出现在可复制正文里；颜色、材质、形制这类跨镜不变事实不靠模型记忆。
+- 正文可直接复制，不含占位符、流程说明、文件路径或 QA 结论。
+
+## 按需知识
+
+默认只读本 SKILL、当前分镜和必要视觉事实。遇到对应问题时只打开一份：
+
+- 阶段边界与规则分级：[阶段契约](references/stage-contract.md)
+- 单镜运动正文的最小配方：[运动配方](references/motion-recipe.md)
+- 外部执行需要的明确动作语法：[生产提示词语法](references/production-prompt-grammar.md)
+- 多人表演、口型和精确时序：[表演与动作时序](references/performance-action-timing.md)
+- 运镜、声音和相邻镜头连续性：[摄影与声音连续性](references/camera-audio-continuity.md)
+- 动作负载、形变和生成风险：[可生成性](references/generability.md)
+- 目标执行端的时长、参考、声音同轨等能力：[目标模型能力档案](references/target-model-profile.md)
+- Seedance 2.0 的中文分镜、素材与声音语法：[Seedance 2.0 方言](references/seedance-2.0.md)
+- Seedance 2.5 的长叙事、时间戳和任务类型语法：[Seedance 2.5 方言](references/seedance-2.5.md)
+- MiniMax H3 的结构化正文与参考模式：[MiniMax H3 方言](references/minimax-h3.md)
+- 多镜容器或静态漫剧的交付方式：[交付形态](references/delivery-profile.md)
+- 完成前的边界检查：[审查与示例](references/review-and-fixtures.md)
+
+用户明确要求时间线音乐时，在本文档增加独立章节，写使用区间、剧情功能、进入/退出、动态曲线和
+禁用项；歌词必须来自用户提供或明确接受的文本。静态漫剧只需要关键帧切换与配音时可以跳过逐镜
+视频运动提示词，直接进入生产预览。
+
+## 完成与投产
+
+每个点名镜头都有明确起点、主变化、时序、运镜/声音边界和可验证终点，且与相邻镜头连续，即完成。
+实际生成转 `$short-drama-produce`，先展示精确 job 并取得显式确认；本技能不调用外部服务。
+五份创作文档齐备后，可转 `$short-drama` 对跨文档结构做一次机械核对；内容质量仍由创作者审查。
+
+## 安装维护
+
+只有安装、升级或排障时运行 `python3 scripts/selftest.py`。

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "短剧视频提示词"
+  short_description: "基于镜头边界编写动作、表演、运镜、声音与节奏视频提示词"
+  default_prompt: "使用 $short-drama-video-prompts 根据已接受镜头和关键帧编写以运动变化为核心的视频提示词。"

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/coverage-scope.fragment.json

@@ -0,0 +1,21 @@
+{
+  "coverage_scope": {
+    "mode": "pickup | alternate",
+    "master_motion_id": "MOTION-<master-id>",
+    "supplements_motion_ids": [
+      "MOTION-<same-file-record-id>"
+    ],
+    "source_obligations": [
+      {
+        "kind": "action | reaction | dialogue | reveal | directive | end_boundary",
+        "source_ref": {
+          "src": "screenplay-index",
+          "record_id": "BLK-<EP>-<SC>-<kind><nn>"
+        },
+        "disposition": "covered_now | retained_in_master | separate_pickup | requires_storyboard_revision",
+        "motion_field": "/<current-motion-field-or-none>"
+      }
+    ],
+    "replacement_intent": "does_not_replace_master | requests_supersession"
+  }
+}

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/delivery-container.jsonl.md

@@ -0,0 +1,101 @@
+# `delivery-containers.jsonl` 填写模板
+
+每行一个交付容器对象。容器只是**已接受镜头的排布方式**：它记录哪些镜头按什么顺序装进
+同一个交付单位，以及由此得出的容器时长。它不拥有镜头边界、目的、起止状态或时长——
+这些仍属分镜；容器只引用它们并做加法。
+
+只有创作者声明了分段或多镜打包的交付方式时才需要本文件；单镜交付不必创建容器记录，
+`VID-13` 在那种情形下由运动规格自身的镜头时长满足。
+
+文件第一行是 `sources` 声明：每个上游快照在这里写一次 `owner`、`artifact` 和已接受的
+`artifact`，后面的记录用它的 key 引用。key 用产物文件名派生的短小写名字，在本文件内稳定且唯一。
+
+```jsonl
+{"record_type":"sources","schema_version":"1.0.0","sources":{"shots":{"owner":"short-drama-storyboard","artifact":"剧集/<EP>/storyboard/shots.jsonl"},"motion-specs":{"owner":"short-drama-video-prompts","artifact":"剧集/<EP>/storyboard/motion-specs.jsonl"},"short-drama":{"owner":"creator","artifact":"short-drama.json"}}}
+```
+
+其后每行一个容器记录，引用写 `src` 加它指向的记录 `record_id` 或字段 `field`：
+
+```json
+{
+  "container_id": "CONT-<stable-id>",
+  "status": "candidate",
+  "production_profile_ref": {
+    "src": "short-drama",
+    "field": "/creator_authority/production_profile"
+  },
+  "members": [
+    {
+      "order": 1,
+      "shot_ref": {
+        "src": "shots",
+        "record_id": "SHOT-<id>"
+      },
+      "motion_ref": {
+        "src": "motion-specs",
+        "record_id": "MOTION-<stable-id>"
+      },
+      "accepted_duration_ref": {
+        "src": "shots",
+        "record_id": "SHOT-<id>",
+        "field": "/duration_seconds"
+      },
+      "accepted_duration": "<从 accepted_duration_ref 读到的值，投影不改写>",
+      "location_binding_ref": {
+        "src": "shots",
+        "record_id": "SHOT-<id>",
+        "field": "/location_binding"
+      },
+      "asset_bindings_ref": {
+        "src": "shots",
+        "record_id": "SHOT-<id>",
+        "field": "/asset_bindings"
+      }
+    }
+  ],
+  "container_duration": "<各成员 accepted_duration 之和>",
+  "membership_basis": {
+    "source_order_contiguous": "<true | 说明为什么不连续及去向>",
+    "binding_chain_equal": "<true | 说明哪一位成员的绑定不同、以及为什么仍同容器>",
+    "scene_boundary_not_crossed": "<true | 说明跨越原因与已接受依据>"
+  },
+  "unresolved": [],
+  "provenance": "creator_project"
+}
+```
+
+## 结构校验点
+
+`VID-13` 靠这条记录本地可证，不依赖阅读渲染文本。带 ✓ 的由 [container_check.py](../scripts/container_check.py) 判定，其余由审查者判定——此前这份清单整体写成「本地可证」，而脚本只实现了其中两项：
+
+1. ✓ `members[]` 非空，`order` 唯一、连续、升序；
+2. 每条引用的 `src` 在本文件 `sources` 声明里找得到对应条目；
+3. ✓ 每个成员的 `accepted_duration` 等于其 `accepted_duration_ref` 解析后指向的分镜值；
+4. ✓ `container_duration` 等于各成员 `accepted_duration` 之和；
+5. 每个成员的 `motion_ref` 指向的运动规格，其 `shot_ref` 与该成员 `shot_ref` 解析到同一镜头记录；
+6. **逐成员**解析 `location_binding_ref` 与 `asset_bindings_ref`，各成员解析结果相同时
+   `binding_chain_equal` 才能为 `true`；只引用其中一条成员记录不构成证明。
+7. ✓ `membership_basis` 三项都有结论，未成立的写进 `unresolved`，不留空。
+
+任何一项不成立即为结构缺陷，按主技能的 `stale` 与恢复流程处理，不在渲染文本里补救。
+
+## 依赖方向是单向的
+
+容器 → 运动规格 → 镜头，**不存在反向的文件引用**。运动规格不带 `container_ref`：
+两端在各自 `sources` 里互相声明对方会形成环：依赖方向必须单向，否则谁都不能先落盘。
+文字上写“只读”不能消除这个环。
+
+要从一个镜头反查它属于哪个容器，扫描容器记录的 `members[]`，不在运动规格里存副本。
+
+## 与其他记录的关系
+
+- **运动规格**：每条运动规格仍然只绑定一个 `shot_ref`，且不感知容器的存在。
+- **渲染文本**：`video-prompts.md` 的容器一节由本记录派生，是缓存，不是权威；文本与本
+  记录不一致时以本记录为准。
+- **成员时长**：一律是分镜的只读投影。要改时长就改分镜，然后重算 `container_duration`；
+  不得在容器里直接改数。
+- **成员资格判据**：语义部分见 `references/delivery-profile.md` 的多镜容器成员资格；
+  本文件只负责让判据的结论可被引用与核对。
+
+复制后删除不适用的可选字段。容器不跨越已接受的场次或时间跳跃；省略、闪回分支与声明过的
+蒙太奇各自单独成容器。

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-spec.jsonl.md

@@ -0,0 +1,217 @@
+# `motion-specs.jsonl` 填写模板
+
+文件第一行是 `sources` 声明：每个上游快照在这里写一次 `owner`、`artifact` 和已接受的
+`artifact`，后面的记录用它的 key 引用。key 用产物文件名派生的短小写名字，在本文件内稳定且唯一。
+本阶段插入的片段（[`performance.fragment.json`](performance.fragment.json)、
+[`coverage-scope.fragment.json`](coverage-scope.fragment.json)）落进同一个文件，它们用到的 key
+也在这里声明。
+
+```jsonl
+{"record_type":"sources","schema_version":"1.0.0","sources":{"shots":{"owner":"short-drama-storyboard","artifact":"剧集/<EP>/storyboard/shots.jsonl"},"keyframes":{"owner":"short-drama-storyboard","artifact":"剧集/<EP>/storyboard/keyframes.jsonl"},"screenplay-index":{"owner":"short-drama-write","artifact":"剧集/<EP>/screenplay-index.jsonl"},"characters":{"owner":"short-drama-assets","artifact":"设定集/characters.jsonl"},"short-drama":{"owner":"creator","artifact":"short-drama.json"}}}
+```
+
+其后每行一个候选运动规格对象。引用写 `src` 加它指向的记录 `record_id` 或字段 `field`；
+`boundary_refs` 只读，候选状态属于本运动规格，不向已经接受的上游引用传播。不要加入
+`duration_override`、`end_override` 或 `next_shot_write`。以下字符串只说明怎样填写，
+不是固定答案。
+
+```json
+{
+  "motion_id": "MOTION-<stable-id>",
+  "status": "candidate",
+  "shot_ref": {
+    "src": "shots",
+    "record_id": "SHOT-<id>"
+  },
+  "keyframe_ref": {
+    "src": "keyframes",
+    "record_id": "KEY-<id>"
+  },
+  "production_profile_ref": {
+    "src": "short-drama",
+    "field": "/creator_authority/production_profile"
+  },
+  "boundary_refs": {
+    "duration": {
+      "src": "shots",
+      "record_id": "SHOT-<id>",
+      "field": "/duration_seconds",
+      "value_seconds": 0.0
+    },
+    "start": {
+      "src": "shots",
+      "record_id": "SHOT-<id>",
+      "field": "/start_boundary"
+    },
+    "primary_transition": {
+      "src": "shots",
+      "record_id": "SHOT-<id>",
+      "field": "/primary_transition"
+    },
+    "end": {
+      "src": "shots",
+      "record_id": "SHOT-<id>",
+      "field": "/end_boundary"
+    },
+    "next_start": {
+      "src": "shots",
+      "record_id": "SHOT-<next-id>",
+      "field": "/start_boundary",
+      "access": "comparison_only"
+    }
+  },
+  "reference_bindings": [
+    {
+      "slot_id": "REF-<stable-slot>",
+      "order": 1,
+      "artifact_ref": {
+        "src": "keyframes",
+        "record_id": "KEY-<id>"
+      },
+      "role": "start_frame | continuity_video | actual_tail_frame",
+      "may_control": [
+        "<本镜 accepted 起始构图与可见状态>"
+      ],
+      "must_not_control": [
+        "<尚未发生的动作/终态/无权威文字>"
+      ],
+      "admission_status": "unverified | creator_described | visually_inspected",
+      "reference_observation_ref": null,
+      "unresolved_risks": [
+        "<没有观察证据时保留的文字/水印/裁切风险>"
+      ]
+    }
+  ],
+  "start_anchor": {
+    "pose_balance": "<仅运动必需>",
+    "gaze": "<目标>",
+    "hands": {
+      "left": "<状态>",
+      "right": "<状态>"
+    },
+    "held_props": [
+      "<exact binding + hand>"
+    ],
+    "spatial_relations": [
+      "<与行动对象的关系>"
+    ]
+  },
+  "ordered_subject_motion": [
+    {
+      "order": 1,
+      "actor": "<asset binding>",
+      "trigger": "<accepted cue>",
+      "action": "<可见动作>",
+      "direction_or_path": "<方向/路径>",
+      "object_or_contact": "<对象/接触>",
+      "result": "<阶段结果>",
+      "timing": {
+        "mode": "relative | explicit",
+        "value": "<顺序词或秒区间>"
+      }
+    }
+  ],
+  "camera": {
+    "behavior": "locked | move | transition",
+    "motivation": "reveal | pressure | alignment | relationship | transition | deliberate_stillness",
+    "intervals": [
+      {
+        "range": "<相对阶段或秒区间>",
+        "mode": "<lock/pan/tilt/dolly/handheld/follow>",
+        "path_tempo": "<方向/节奏>",
+        "endpoint": "<在 accepted framing/boundary 内>"
+      }
+    ]
+  },
+  "environment_motion": [
+    {
+      "element": "<已有环境元素>",
+      "motion": "<有剧情意义的变化>",
+      "cause": "<连续性/主体动作>"
+    }
+  ],
+  "audio": [
+    {
+      "source_ref": {
+        "src": "screenplay-index",
+        "record_id": "BLK-<EP>-<SC>-D<nn>"
+      },
+      "speaker_ref": {
+        "src": "characters",
+        "record_id": "CHAR-<id>"
+      },
+      "voice_direction_ref": {
+        "src": "characters",
+        "record_id": "CHAR-<id>",
+        "field": "/voice_direction"
+      },
+      "kind": "dialogue | VO | OS | SFX | ambience | music",
+      "exact_text": "<仅 source 有文本时逐字引用>",
+      "delivery_or_spatial_intent": "<不改文本的表演/声源/层级>",
+      "timing": "<相对阶段或秒区间>"
+    }
+  ],
+  "timing_plan": {
+    "mode": "relative | explicit",
+    "phases": [
+      "<阶段、overlap 与 landing 空间>"
+    ],
+    "declares_overlap": false,
+    "declared_total_or_endpoint_seconds": 0.0
+  },
+  "end_report": {
+    "projection": {
+      "pose": "<reported>",
+      "position": "<reported>",
+      "gaze": "<reported>",
+      "hands": "<reported>",
+      "held_props": "<reported>",
+      "visible_state": "<reported>"
+    },
+    "comparison": "match | mismatch | unrealized",
+    "differences": []
+  },
+  "reference_frame_economy": {
+    "frame_carries": [
+      "appearance",
+      "composition",
+      "base lighting"
+    ],
+    "repeated_for_motion_only": [
+      "<hand/prop/path 等必要局部>"
+    ]
+  },
+  "creator_overrides": [
+    {
+      "rule_id": "<VID-*>",
+      "choice": "<覆盖>",
+      "rationale": "<理由>"
+    }
+  ],
+  "generic_prompt": "<把本规格渲染成一段只含要拍出来的画面的交付文本：从已接受起点的姿态与持物说起，逐条写动作、接触、摄影机行为与终点状态；不写镜头/记录 ID、规则 ID、状态词、工艺备注与成段否定罗列；写满的样子见 references/production-prompt-grammar.md>",
+  "derivation": {
+    "recipe_version": "<version>"
+  },
+  "provenance": "creator_project"
+}
+```
+
+
+运动规格**不带指回交付容器的引用**。依赖方向只有一条：容器 → 运动规格 → 镜头。两端在各自
+`sources` 里互相声明对方会形成环——依赖方向必须单向，
+永远得不到可发布的稳定快照。要找某个镜头属于哪个容器，从容器记录的 `members[]` 反查，不在本文件里
+存副本。容器记录见 [delivery-container.jsonl.md](delivery-container.jsonl.md)。
+
+默认 master 不重复 `purpose_ref` 或 `coverage_scope`：镜头目的、场次计划与原文覆盖从准确
+`shot_ref` 及其上游读取。只有 pickup/alternate 才按
+[motion-recipe.md](../references/motion-recipe.md) 增加 `coverage_scope`，记录相对母版的补充、保留与去向。
+`boundary_refs` 只保留结构校验需要的 duration/start/end/next-start 精确字段投影，不再重复镜头目的、
+场次计划或原文职责；删除它前必须先让 timing 与 continuity 校验器能从 `shot_ref` 安全解析同一快照。
+
+普通记录省略 `performance_arcs[]` 与 `attention_handoffs[]`；存在可见表演变化或注意交接时，按
+[`performance.fragment.json`](performance.fragment.json) 插入完整字段。空镜、道具细节、纯空间
+转场和只有物理动作的镜头不编造 arc。多参考的 `slot_id` 稳定且 `order` 唯一。
+`reported_end` 只作比较；末镜没有真实下一镜时改用
+`next_start_locator`。附加参考为空时使用空数组；对白说话者与声音方向只有在已接受引用存在时才填写。
+母版、补拍和替代关系保留在同一规格文件内，替代决定由审查结论拥有。具体取舍按
+`references/motion-recipe.md` 与 `references/review-and-fixtures.md` 判断。

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-terminal.example.jsonl

@@ -0,0 +1,2 @@
+{"record_type": "sources", "schema_version": "1.0.0", "sources": {"shots": {"owner": "short-drama-storyboard", "artifact": "剧集/EP001/storyboard/shots.jsonl"}, "keyframes": {"owner": "short-drama-storyboard", "artifact": "剧集/EP001/storyboard/keyframes.jsonl"}}}
+{"example_only": true, "motion_id": "MOTION-EP001-LAST", "status": "candidate", "authority": "candidate", "shot_ref": {"src": "shots", "record_id": "SHOT-EP001-LAST", "authority": "candidate"}, "keyframe_ref": {"src": "keyframes", "record_id": "KEY-EP001-LAST", "authority": "candidate"}, "next_start_locator": {"owner": "short-drama-storyboard", "artifact": "剧集/EP002/storyboard/shots.jsonl", "selector": {"record_id": "SHOT-EP002-FIRST", "field": "/start_boundary"}, "status": "future_until_episode_materializes", "access": "comparison_only"}, "rule": "next_start_locator is not an ArtifactRef and cannot satisfy accepted continuity until resolved"}

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/music-spec.jsonl.md

@@ -0,0 +1,31 @@
+# Timeline Music Spec
+
+Music is a timeline layer, not a default bed baked into every generated shot.
+Create a record only when accepted story or directing material gives music a
+specific dramatic job.
+
+The file opens with a `sources` header that declares each upstream snapshot
+once. A source key is short, lowercase and derived from the artifact basename;
+it stays stable and unique within the file.
+
+```jsonl
+{"record_type":"sources","schema_version":"1.0.0","sources":{"screenplay":{"owner":"short-drama-write","artifact":"剧集/EP001/screenplay.md"}}}
+```
+
+Every record after the header names the snapshot through its key:
+
+```json
+{"music_id":"MUS-EP001-01","scope":{"episode_id":"EP001","start_seconds":0,"end_seconds":12},"source_refs":[{"src":"screenplay","record_id":"EP001-SC001"}],"narrative_function":"<what changes for the audience, and why picture/performance alone is insufficient>","prompt":"<provider-neutral style, mood, instrumentation, energy and scene description>","mode":"instrumental | song","lyrics":null,"mix_intent":{"entry":"<relative entry against picture or dialogue>","exit":"<relative exit or transition>","duck_under_dialogue":true,"loop":false},"status":"candidate"}
+```
+
+- `source_refs` carry `src` plus the record or field they point at; the
+  artifact's `owner` and `artifact` live in the header entry that `src`
+  names.
+- `scope` is the accepted timeline interval; it does not promise a supplier can
+  generate that exact duration.
+- `prompt` contains musical intent only, never model names, API fields, artist
+  imitation, remote task identifiers or credentials.
+- `song` requires creator-owned or licensed `lyrics`; `instrumental` carries no
+  lyrics. Do not ask a provider to silently rewrite accepted lyrics.
+- `mix_intent` is an editorial handoff. Production generates a source track;
+  editing still owns exact fades, ducking and placement.

package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/performance.fragment.json

@@ -0,0 +1,38 @@
+{
+  "performance_arcs": [
+    {
+      "actor_ref": {
+        "src": "characters",
+        "record_id": "CHAR-<id>"
+      },
+      "trigger_ref": {
+        "src": "screenplay-index",
+        "record_id": "BLK-<EP>-<SC>-<kind><nn>"
+      },
+      "agenda": "<本镜需要读出的当前策略；无增益时删除>",
+      "receive": "<角色怎样接收触发；无内在处理时删除>",
+      "mask": "<确有掩饰时才保留>",
+      "visible_leak": "<当前景别可读的目光/尾音/手部/距离信号；没有则删除>",
+      "choice": "<说、做或刻意不做的方向性选择>",
+      "landing": "<选择怎样落到 accepted end>"
+    }
+  ],
+  "attention_handoffs": [
+    {
+      "from_ref": {
+        "src": "<注意归属方产物的 sources key>",
+        "record_id": "<exact-attention-owner-record-id>"
+      },
+      "trigger_ref": {
+        "src": "screenplay-index",
+        "record_id": "BLK-<EP>-<SC>-<kind><nn>"
+      },
+      "to_ref": {
+        "src": "<注意归属方产物的 sources key>",
+        "record_id": "<exact-attention-owner-record-id>"
+      },
+      "signal": "<使注意转移的可见或可听信号>",
+      "readability": "<当前景别、遮挡和声源为何读得到>"
+    }
+  ]
+}