@oh-story/dsh 0.1.15 → 0.1.17

package/lib/drama/package.json

@@ -0,0 +1,4 @@
+{
+  "private": true,
+  "description": "Bundled upstream Skills; no module type so scripts resolve as in an upstream install."
+}

package/lib/drama/skills/short-drama/SKILL.md

@@ -6,11 +6,11 @@ license: MIT
 
 # 短剧创作路由
 
-本技能负责项目初始化、跨阶段路由、制作形态与 Dashboard。各阶段正文由对应 owner 完成。
+本技能负责项目初始化、跨阶段路由、制作形态与 Dashboard。各阶段正文由对应技能完成。
 
 ## Quick Start
 
-所有项目统一使用 [creator-first 工作流](references/creator-workflow.md)：每集按需维护
+当前创作统一使用 [creator-first 工作流](references/creator-workflow.md)：每集按需维护
 `剧本.md`、`视觉设定.md`、`分镜.md`、`图片提示词.md`、`视频提示词.md`，不建立并行的结构化创作真相。
 具体写法见 [五份创作文档](references/creator-documents.md)。
 
@@ -42,13 +42,13 @@ license: MIT
 
 ## 执行请求
 
-1. 找到用户给出的项目或资料，只读当前任务的直接输入。
-2. 把用户点名的完整范围交给相应 owner；批次只控制上下文，自动续跑。
+1. 定位用户给出的项目或资料，只读当前任务的直接输入。
+2. 把用户点名的完整范围交给相应技能；批次只控制上下文，自动续跑。
 3. 只有真实创作分叉才询问；不要拿 schema、目录、事务或检查器询问创作者。
 4. 范围完成后一次回报完成内容、关键决定、真实未决项和可选下一步。
 5. 不自动开始用户没点名的审查、归档或生产。
-6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前按当前五文档做一次视觉依赖对账；
-   不因图片提示词和分镜可并行，就把后完成的一支留在另一支的旧引用之外。
+6. 请求横跨视觉设定、图片提示词、分镜或视频提示词时，结束前核对当前已有文档的视觉依赖；
+   图片提示词和分镜并行完成时，也要同步两支的引用。五份文档齐备后再运行完整跨文档检查，不为检查补造文件。
 7. 视频提示词请求遇到「输入参考图：无」或仍带「待补参考图」时，先路由分镜 owner 检查项目已有图片并刷新绑定。有匹配图就同请求续跑；有必要图缺失就列表停下。
    停下时把三条路一起给出：把已有图片放进项目绑成 `REF-...`；由创作者在自己的工具里出图、本轮先用
    `PLAN-...` 写出逐镜挂图计划并照常产出视频提示词；或者明确改走文生视频。用本套件生产参考图需要项目外的
@@ -57,7 +57,7 @@ license: MIT
    同时按已成稿的冻结关键帧回填；两条依据描述同一格画面，不要只补一条。
 8. 用户在会话里点名目标视频模型（“按 MiniMax H3 写”“用 Seedance 2.5”）而 `short-drama.json` 的
    `production_profile` 还是 `unset` 时，先把这个选择连同它带来的原生时长、参考方式和正文语言写进档案，
-   再继续下游阶段。会话里的一句点名不落到档案上，下一轮就会退回通用路径，方言和时长要重猜。
+   再继续下游阶段。把已确认选择写入档案，后续请求才能沿用同一方言、语言和时长边界。
 
 ## 初始化与 Dashboard
 
@@ -73,7 +73,7 @@ python3 {技能目录}/scripts/project_tool.py init ./my-drama --title "示例
 `accepted`；`unset` 只表示尚未决定，不另造中间状态。
 `init` 只建立配置和空目录；第一次创作时再把文档写入 `剧集/<EP>/`，不预建空文件。
 项目已经建好、用户之后才定下目标视频模型时，把选择写进档案，并同时展示它对时长区间、参考方式和
-正文语言的影响。档案只接受已发布并已接受的创作者决策，所以是三步，不是一步。先写一行决策记录
+正文语言的影响。档案只能从已发布、已接受的创作者决策写入。先在 `输入/profile.jsonl` 写一行决策记录
 （`accepted_value` 就是要落进 `choices` 的对象本身，不要再包一层 `choices`）：
 
 ```jsonl
@@ -100,8 +100,7 @@ python3 {技能目录}/scripts/project_tool.py set-authority <project> \
 python3 {技能目录}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open
 ```
 
-`--detach` 让服务进程脱离当前 shell 独立运行，会话结束、终端关闭或智能体退出都不会带走它；
-链接因此在整个创作期间保持有效。运行中的地址、端口和 pid 记录在
+`--detach` 让服务进程脱离当前 shell 独立运行，无需保持当前会话或终端开启。运行中的地址、端口和 pid 记录在
 `<workspace>/.short-drama/dashboard.json`（仅本人可读），日志在同目录 `dashboard.log`：
 
 ```bash
@@ -123,11 +122,11 @@ Dashboard 按阶段展示项目：全剧页给出下一步和分集进度，每
 制作形态、视觉方向、播放面和集长目标确实约束多个阶段时，展示选择及影响后由用户决定。
 Look Development 是可选分支，不是进入图片提示词或分镜的固定门槛。
 
-节奏数值（首钩秒数、情绪触点间隔、反转次数、VO 占比、平均镜长等）住在
+节奏数值（首钩秒数、情绪触点间隔、反转次数、VO 占比、平均镜长等）记录在
 `creator_authority.rhythm_profile`。字段与默认值由 `$short-drama-develop` 按制作形态提出，
-创作者接受或改写后，按上文三步写入：决策的 `accepted_value` 是完整档案对象，`--field`
+创作者接受或改写后，按上文三步写入：决策的 `accepted_value` 是不含 `status` 的完整档案值，`--field`
 写 `/creator_authority/rhythm_profile`；档案已接受后，单改一个值时 `--field` 指向该字段。
-`set-authority` 只校验类型与范围，缺字段、越界或多出未知字段都拒绝写入。下游只按 `status` 为 `accepted` 的档案做算术核对，缺失、`unset` 或
+`set-authority` 对节奏档案校验字段、类型与范围，缺字段、越界或多出未知字段都拒绝写入。下游只按 `status` 为 `accepted` 的档案做算术核对，缺失、`unset` 或
 `proposed` 都表示「未声明，不核对」。写完用 `status` 复核 `rhythm_profile`；手改后档案不合法时
 它返回空档案，问题列在 `rhythm_profile_problems`。
 
@@ -152,7 +151,7 @@ Look Development 是可选分支，不是进入图片提示词或分镜的固定
 python3 {技能目录}/scripts/project_tool.py export <project> --out <项目外目录>
 ```
 
-它把每集现有的五份创作文档和 `剧集/<EP>/制作成果/` 复制到 `--out`，附 `manifest.json` 与
+它把每集现有的五份创作文档、`剪辑单.md` 和 `剧集/<EP>/制作成果/` 复制到 `--out`，附 `manifest.json` 与
 `checksums.sha256`，并排除 `输入/`、`交付/` 和 `.short-drama/`。只要一部分时加
 `--episode EP001`（可重复）；只要文字时加 `--no-media`；覆盖旧目录加 `--overwrite`。
 `--out` 必须在项目之外。

package/lib/drama/skills/short-drama/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧创作"
-  short_description: "基于文件系统初始化、恢复、路由、可视化管理并交付短剧项目"
+  short_description: "初始化和继续短剧项目，路由创作阶段，查看创作台并导出当前成果"
   default_prompt: "使用 $short-drama 初始化、查看、继续、恢复或打开 Dashboard 管理我的文件系统短剧项目。"

package/lib/drama/skills/short-drama/references/audience-reveal.md

@@ -1,7 +1,7 @@
 # 观众此刻可以知道什么
 
 背影、门缝、画外声、浅景深和遮挡会决定观众何时知道一个人是谁、看见证据或发现门后有人。
-需要同时防两种错：该给的信息被漂亮构图挡住；不该给的信息被镜头提前泄露。
+设计时同时检查：必要信息是否被构图挡住，暂不该给的信息是否被镜头提前泄露。
 
 ## 一条事实一条判断
 
@@ -10,12 +10,12 @@
 - **事实来源**：来自哪个场景 ID、对白、动作或画面文字；
 - **本镜权限**：现在展示，还是暂时扣住；
 - **可见/可听载体**：观众具体能看到或听到什么；
-- **释放时机**：若暂时扣住，在哪个可见事件后释放；
+- **释放时机**：若暂时扣住，在哪个可见事件后释放；若本集有意保持未知，说明保留到哪里；
 - **保护方法**：靠遮挡、景深、画外声、光线或构图怎样实现；
 - **戏剧理由**：为什么这个时机改变理解或压力。
 
 同一镜头里“来者认识主角”和“来者是谁”是两件事：可以让旧称呼先从画外传来，同时让来者的脸
 留在暗处。揉成一句“稍后揭示”，下游就无法分别处理声音和身份。
 
-扣住信息本身没有价值；说不出何时释放，就说明还没完成设计。审查时同时核对原文此刻允许透露什么，
-以及本镜必须让观众明白什么。
+扣住信息要有明确的戏剧作用。审查时同时核对来源此刻允许透露什么、本镜必须让观众明白什么，
+以及暂扣或有意保留未知的范围。

package/lib/drama/skills/short-drama/references/contract-and-ownership.md

@@ -8,7 +8,7 @@
                     \-> 明确确认后的媒体生产
 ```
 
-可以从任一已有材料直接进入；Look Development 和审查都按需发生。每个 owner 只修改自己的 Markdown，
+可以从任一已有材料直接进入；Look Development 和审查都按需发生。各负责技能只修改自己的 Markdown，
 引用上游可见事实，但不静默改写它们。
 
 ## 输出语言
@@ -17,7 +17,7 @@
 |---|---|---|
 | 创作者可读说明与审查 | `short-drama.json#/language` | 用户当前语言 |
 | 图片、关键帧的可复制正文 | `short-drama.json#/format/prompt_language` | `en` |
-| 视频的可复制正文 | 目标视频模型档案的 `production_profile.choices.video_prompt_language`；未声明时回退 `format.prompt_language` | 根据目标视频模型确认；未声明时使用用户当前语言 |
+| 视频的可复制正文 | 目标视频模型档案的 `creator_authority.production_profile.choices.video_prompt_language`；未声明时回退 `format.prompt_language` | 根据目标视频模型确认；未声明时使用用户当前语言 |
 
 创作者说明、通用提示词语言和视频模型提示词语言互相独立；画面中的对白和可读文字来自剧本/视觉事实，
 不由描述语言推断。

package/lib/drama/skills/short-drama/references/creator-documents.md

@@ -1,6 +1,7 @@
 # 五份创作文档
 
-这是一份建议格式，不是 schema。优先让人一眼读懂；只有跨文档引用和投产定位需要稳定 ID。
+正文优先供创作者阅读；下文的标题、引用和参考字段用于跨文档核对与投产定位，应按所示语法填写。
+内容按本集需要组织，不为填满示例补造事实。
 
 ## `剧本.md`
 
@@ -26,13 +27,14 @@
 二级标题固定写成 `## <人物|造型|地点|道具> · <名称>`；分镜的「视觉依据」按这个标题定位条目。
 
 **画面代称**是提示词正文里直接叫到这一条的名字，按项目提示词语言写；多个写法用 `、` 分隔，
-大小写必须与正文一致。条目自身的中文名称始终算一个代称，所以中文项目通常不必写这一行。
-`creator_markdown_check.py` 用它机械核对「冻结关键帧里出现的名字，视觉依据必须覆盖」。
+拼写与正文保持一致。未声明这一行时，检查器回退到条目名称；显式声明后只匹配列出的代称，
+不会自动加入中文名。需要同时匹配两者时都写入；写 `画面代称：无` 则取消名称匹配。
+`creator_markdown_check.py` 用这些名称核对冻结关键帧与「视觉依据」的覆盖。
 
-提示词正文语言不是中文时，被某镜「视觉依据」引用过的**人物**条目必须给出结论：写
-`画面代称：<正文里的拼写>`，或在正文从不点名它时写 `画面代称：无`。少了这一行，中文条目名在英文正文里
-永远匹配不上，这条核对就静默失效——那正是 #94 报告的形状。地点和道具通常在正文里只被描述、不被点名，
-不作强制。
+完整检查按已接受生产档案中的 `video_prompt_language`、项目 `format.prompt_language`、默认 `en`
+的顺序取语言。该语言不是中文时，**所有人物条目**都要给出可用代称，或在正文从不点名时写
+`画面代称：无`，不以是否已被镜头引用为条件。显式代称至少两个字符；仅列出与条目名相同的中文名
+仍不能满足这项非中文检查。地点和道具不强制声明，名称容易误匹配时可主动取消名称匹配。
 
 识别锚点写给创作者读；**连续性锁**写给执行端逐字带走。跨镜出现、观众看得出不一致、又不随剧情
 改变的可见事实（服装主色与形制、道具颜色材质、发型长度、伤口位置）才上锁，会变的部分留在
@@ -114,7 +116,7 @@ REF-<slot>（顺序：<n>）· <项目相对路径>《<中文名称>》（用途
 `起始帧`、一张 `结束帧`，且写 `结束帧` 时必须同时有 `起始帧`。有了 `用途`，视频提示词就能直接回答
 「本镜要送哪一张分镜起始帧、哪些人物/道具/场景图」，生产端也不必再猜每张图的职责。
 
-创作者在别处出图时，图片不会进项目，`REF-...` 也就无从写起。这时用 `PLAN-...` 槽位，
+创作者在别处出图、且图片不放进项目时，用 `PLAN-...` 槽位；图片导入项目后即可写 `REF-...`。`PLAN-...`
 语法与 `REF-...` 完全一致，只把定位符从项目相对路径换成本项目已有的条目 ID：
 
 ```markdown
@@ -193,7 +195,7 @@ PLAN-<slot>（顺序：<n>）· <IMG-... 或 SHOT-...>《<中文名称>》（用
 
 ## `视频提示词.md`
 
-与分镜一一对应时沿用镜头号并使用 `MOTION-...` ID。若「输入参考图」中的 `REF-...` 与 `PLAN-...` 已全部就绪，使用图生视频，正文
+每个正式镜头对应一个 `MOTION-...` 条目，ID 沿用 `SHOT-...` 的编号部分。若「输入参考图」中的 `REF-...` 与 `PLAN-...` 已全部就绪，使用图生视频，正文
 只需重述运动所需的局部起点和防漂移事实；只有「输入参考图：无（创作者已明确选择文生视频）」才使用文生视频，正文必须自足地
 包含人物、造型、地点、构图、光线等本镜需要的静态视觉锚点，不能用 `preserve/保持已有外观`
 代替模型并未收到的图片。「待补参考图」会阻止最终视频提示词；视频文档中的「输入参考图」必须与对应分镜逐字一致。
@@ -230,4 +232,4 @@ caption 和对白文字叠加，不能只写抽象的“文字层为空”，让
 - `### 可复制提示词` 下的引用块是**一条**提示词：从第一行到最后一行整段复制进那一次生成。方言把它分成 `subject_definitions` / `overall_soundscape` 这类段落时，段落仍属于同一条正文，不是分几次提交，也不是只交第一段。
 - 引用使用文档里看得见的场景/镜头/提示词 ID；不写文件哈希和内部路径。
 - 用户没要求的字段不为“完整”而补造。
-- 完成或修订五份文档后运行 `python3 {技能目录}/scripts/creator_markdown_check.py 剧集/<EP> --project-root .`，校验可执行的跨文档结构；内容质量仍由创作者审查。
+- 五份文档齐备后，完成或修订时运行 `python3 {技能目录}/scripts/creator_markdown_check.py 剧集/<EP> --project-root .`，核对跨文档结构。检查器缺任一文件即返回缺文件；局部任务只核对当前已有文档，不为运行检查补造其余文件。内容质量仍由创作者审查。

package/lib/drama/skills/short-drama/references/creator-workflow.md

@@ -49,8 +49,7 @@
 
 ### 一句话把范围说清楚
 
-请求不需要固定话术，技能也不靠关键词匹配。下面几句只是把「一句话里到底要交代哪几件事」写明白，
-照抄或改写都可以：
+请求可以直接说明集号、阶段、模型和参考图安排。下面是几种写法：
 
 ```text
 写 EP001 的分镜和每镜冻结关键帧。目标视频模型是 MiniMax H3，先把它写进项目档案。
@@ -76,16 +75,18 @@ EP001 的角色图和场景图在 输入/参考图/ 下，本镜起始帧在 剧
 ```
 
 一句请求里值得交代的是四件事：**做哪一集的哪一阶段**、**目标视频模型**、**参考图在哪里或还没有**、
-**没有图时怎么办**。前三件缺一件，技能会来问或按已接受档案推进；最后一件从不替创作者假设。
+**没有图时怎么办**。已接受档案中有答案时直接沿用；只有缺失事实形成真实创作分叉时才询问。
+没有图时的路径不能替创作者假设。
 第四件有三个答案：等图、由创作者自己在别处出图并挂载（写成 `PLAN-...`）、或者明确走文生视频；
 一个都没说时，就当成还在等图。
 
-结构检查服务于发现错误，不是创作门禁。能在当前文档直接修正的问题直接修正；审查、归档和媒体
+结构检查用于发现可证明的引用、ID、算术或显式状态问题；能在当前文档修正的直接修正。
+完整跨文档检查要求五份文档齐备，局部任务先核对已有文档，不因缺少未请求的阶段而补造文件。审查、归档和媒体
 生产只有用户点名时开始。安装 selftest、全量 QA 和 demo 验证属于技能维护，不属于普通创作请求。
 
 ## 创作质量
 
-简化文件数量不等于降低内容标准。各 owner 按具体问题读取自己的 craft references，检查剧情因果、
+各阶段按具体问题读取自己的 craft references，检查剧情因果、
 人物声音、资产身份、空间连续性、镜头职责、可生成性和提示词边界。规则与路由总表见
 [knowhow-index.md](knowhow-index.md)。最终回报只说明已完成范围、关键创作决定、真实未决问题和可选
 下一步，不汇报内部流水线噪音。

package/lib/drama/skills/short-drama/references/form-cards/Q/347/211/210/350/241/250/350/276/276.md

@@ -7,8 +7,8 @@
 
 用**降低威胁感和降低认知负担**换取信息通过率：夸张比例让情绪一眼可读，简化形体让因果链
 只剩必要元素。它擅长把规则、流程、风险和抽象概念变成可看的因果单位，也擅长让沉重题材
-被接受。它不擅长细节写实、精确尺度和严肃的暴力后果；需要这些时改由旁白或文字承担，
-不要靠画面硬撑。
+被接受。需要细节写实、精确尺度或严肃后果时，先检查当前简化方式能否保住事实，再由创作者选择
+更准确的画面、文字、声音或其他形态。
 
 ## 身份锚点载体
 
@@ -36,20 +36,20 @@
 ## 光与材质词汇
 
 可执行词汇是**平涂 + 两段明暗 + 高饱和主色**，加少量指示性高光。「危险物用画面里唯一的
-高饱和红，其余降饱和」可执行；「可爱风格」「明快色调」不可执行。材质通常只需分三类——
-软（布、皮肤）、硬（金属、塑料）、透（玻璃、液体）——够用即可，再细分不会被画出来。
+高饱和红，其余降饱和」可执行；「可爱风格」「明快色调」不可执行。材质可先分为
+软（布、皮肤）、硬（金属、塑料）、透（玻璃、液体），再按识别与因果需要补充细节。
 
 ## 运动预算
 
-一个画面或一个运动段**只承载一个因果单位**。默认 hold 加局部动：动的是执行因果的那只手
+默认让一个画面或一个运动段集中呈现一个主要因果单位；能同时读清的并行动作可保留。hold 加局部动时，动的是执行因果的那只手
 或那个物体，其余保持。可爱不等于持续弹跳——给每个元素都加弹性循环会让因果读不出来。
 转场可以用符号层或尺度变化（推到局部）承接。危险动作与错误示范是否允许被完整演示，
 属于形态卡的安全边界决定，不由提示词阶段临时判断。
 
 ## 声音与文字职责
 
-旁白通常是主要信息载体，画面负责证据与后果，两者分工要写死：**旁白说规则，画面说后果**，
-画面不复述旁白已经说完的内容。可读文字（标签、数字、步骤号）在这个形态里高频出现，
+知识或教育短片可由旁白说明规则、画面呈现证据与后果，按项目选择分工，避免同义复述；
+剧情类 Q 版仍按剧本决定信息载体。可读文字（标签、数字、步骤号）在这个形态里高频出现，
 必须走资产 text policy 并明确是画内还是后期层；后期文字要在构图里预留位置，
 不能事后压在脸或记号上。事实准确性不因为风格可爱而下调。
 
@@ -60,7 +60,7 @@
 | develop | 头身比体系、旁白与画面的分工、符号层策略、安全边界 |
 | assets | 比例体系、色块、记号、符号层清单、文字政策 |
 | image-prompts | 单帧的比例、色块、符号位置与文字预留区 |
-| storyboard | 一个画面一个因果单位、注意力指向、后期文字预留 |
+| storyboard | 突出本画面的主要因果单位、注意力指向、后期文字预留 |
 | video-prompts | 会动的那一层与其因果、符号层出现时机、旁白相对动作的位置 |
 | review | 因果单位是否被稀释、尺度关系是否稳定、文字预留是否被占用 |
 

package/lib/drama/skills/short-drama/references/form-cards//344/272/214/347/273/264/345/212/250/346/200/201/346/274/253.md

@@ -13,9 +13,8 @@
 ## 身份锚点载体
 
 **轮廓剪影 + 线条特征 + 固定色块**。跨镜可辨认靠发型剪影、脸型比例、服装的色块划分，
-以及一两个不可省的图形记号（领口形状、发饰、袖口条纹）。不要拿「眼神」或写实五官
-细节做锚点——绘制形态每个角度都会重画，只有形状级特征稳定。剪影测试是这个形态特有的
-自检：把角色填成纯黑，是否还认得出是谁。
+以及关键图形记号（领口形状、发饰、袖口条纹）。优先选择跨角度仍可比较的形状级特征，
+避免只靠「眼神」或细微五官差异。可用剪影测试自检：把角色填成纯黑，是否还认得出是谁。
 
 ## 连续性载体
 
@@ -28,7 +27,7 @@
 
 这是本形态最核心的可执行结构，每镜都要显式写：
 
-- 身份层：角色线稿与固定色块，跨镜不重画；
+- 身份层：角色线稿与固定色块的设计跨镜继承，换角度重绘时仍遵循同一设计；
 - 环境层：背景板，通常整段复用，只在机位改变时更换；
 - 可动层：本镜真正会动的部分（一只手、嘴、发梢、衣摆、一件道具）；
 - 效果层：光斑、粒子、速度线、冲击波、光晕，与角色层分开声明谁负责。
@@ -51,7 +50,8 @@
 ## 声音与文字职责
 
 口型策略（不做口型 / 有限口型开合 / 完整口型）要在形态卡里先决定并跨集一致；决定之后，
-台词的写法随之改变——不做口型时长台词优先改成画外或背身。画面文字（拟声字、心声框、
+分镜和声音实现随之调整。选择不做口型时，可比较背身、听者画面等方案；需要改为画外声时，
+先回剧本阶段确认通道，不由提示词擅改。画面文字（拟声字、心声框、
 标题字）是本形态的合法叙事载体，但必须走资产 text policy，并声明是画内元素还是后期层。
 
 ## 跨阶段传递

package/lib/drama/skills/short-drama/references/form-cards//345/233/275/346/274/253/344/272/214/346/254/241/345/205/203.md

@@ -7,18 +7,17 @@
 
 用**高完成度的单帧**承担情绪与人物魅力：观众在一张画面里就接受身份、状态和关系。
 它擅长情绪特写、氛围色、强光效瞬间，也擅长用高质量定帧加少量运动撑住长对白场面。
-它不擅长复杂的连续空间调度；更要紧的是，它有一个别的形态没有的头号风险——
-**全剧人物互相趋同**。精修画风会把不同角色拉平，这必须在形态卡里被主动对抗。
+复杂的连续空间调度需要额外设计；精修画风也容易削弱人物差异，使**全剧人物互相趋同**，
+应在形态卡中明确区分方法。
 
 ## 身份锚点载体
 
 因为五官是精修的，识别**不能靠精度，只能靠可枚举的结构差异**：脸型轮廓（下颌线与颊线）、
 眼型与瞳孔结构（瞳色分层、高光形状）、发型的分层结构与发色渐变的位置，
-以及至少一件跨造型不摘的配件。
+以及项目已确认的固定配件；没有配件时由其他结构差异承担识别。
 
 形态卡必须显式写出：**这个角色与同剧其他角色在哪些结构上不同**，逐条枚举而不是一句概括；
-枚举到能把同组角色两两分开为止，不按条数验收。这是本形态与二维动态漫最大的执行差异——
-后者靠剪影就够，前者剪影往往相似，必须落到结构条目上。写「清冷美人」
+枚举到能把同组角色两两分开为止，不按条数验收。本形态中角色剪影可能相近，需继续核对脸、眼、发等结构；二维动态漫剪影不足以区分时也可采用这种方法。写「清冷美人」
 不构成锚点；写「下颌比同组角色更方、瞳孔上缘是横向条状高光、左耳一枚不摘的银环」才可执行。
 
 ## 连续性载体
@@ -54,7 +53,7 @@
 
 ## 声音与文字职责
 
-通常做完整或接近完整口型，需在形态卡里确认——它直接决定台词长度与画外台词的比例。
+口型通常考虑完整或接近完整的方案，需按制作能力确认，并与剧本的台词和画外通道对齐。
 本形态常配情绪化的环境声与留白式静默，要写明哪些静默是设计的、持续到哪个事件为止。
 画面文字方面，手机屏与聊天框是这个形态的高频文字载体，必须预先声明可读还是符号化，
 并走资产 text policy；不要默认「屏幕反正看得清」。

package/lib/drama/skills/short-drama/references/form-cards//345/256/236/346/213/215.md

@@ -7,14 +7,13 @@
 
 让观众用日常经验直接读出处境：衣服的旧、屋子的挤、手上的伤，不需要翻译。实拍最擅长
 承担**当场证据与即时后果**——事实放在一个能搭建、能收音的空间里，犹豫和选择由表演
-本身携带。它不擅长廉价地跨越尺度、时间与非人身体；那类段落要么改写成可搭建的版本，
-要么在 develop 阶段就换形态，不要拖到视频提示词阶段才发现不可执行。
+本身携带。跨越尺度、时间与非人身体的段落需要额外制作安排，应在 develop 阶段比较可搭建版本、
+效果方案或形态变化，按创作者选择推进。
 
 ## 身份锚点载体
 
-演员的面部结构、身高和体态是天然锚点，不需要提示词反复描述。跨镜可辨认真正靠
-**造型状态**：发型走向与凌乱度、妆面完成度、服装层次与穿法（袖挽到哪一截、扣到第几颗）、
-随身物件的固定位置。所以实拍的身份字段写的是可比较的状态，不是长相评价：
+演员或真实参考已固定面部结构、身高和体态时，提示词重点交接**造型状态**：发型走向与凌乱度、妆面完成度、服装层次与穿法（袖挽到哪一截、扣到第几颗）、
+随身物件的固定位置。没有固定演员或参考时，仍须写明可见身份锚点；造型说明使用可比较的状态：
 「左眉一道旧疤，右手食指常缠创可贴」可执行；「英俊坚毅」没有任何可执行内容。
 
 ## 连续性载体
@@ -33,7 +32,7 @@
 - 可动层：表演动作、道具操作、机位运动；
 - 效果层：需要单独安排的现场物理（烟、雨、火、闪光）。
 
-每镜只写本镜发生变化的层，不重复描述不变层。
+每镜重点写发生变化的层；连续性锁与执行所需的不变事实仍按原规则携带。
 
 ## 光与材质词汇
 
@@ -51,7 +50,7 @@
 
 ## 声音与文字职责
 
-现场声源要写出来：谁在说、说话时手上在做什么、环境里有哪条持续声（空调、雨、走廊脚步）、
+有叙事职责的现场声源要写清：谁在说、说话时手上在做什么、哪条持续声影响本场（空调、雨、走廊脚步）、
 哪个声音先于画面进入。旁白只在项目已选择旁白体时使用。可读文字（合同、手机屏、门牌）
 仍走资产的 text policy，不因为「实拍反正拍得到」就默认可读。
 

package/lib/drama/skills/short-drama/references/form-cards//346/260/264/345/242/250/347/254/224/350/247/246.md

@@ -13,8 +13,7 @@
 
 **轮廓的笔势 + 不可散的墨记号**。因为边缘可以散、可以飞白，身份不能靠细节，
 只能靠起笔与收笔构成的形：发髻的走向、衣纹的三笔主线、腰间最浓的一块墨。
-本形态卡必须显式点名：**哪些边缘绝不允许洇化**。没有这一条，下游每一次「加点水墨感」
-都会合法地把人物吃掉一点。
+本形态卡应显式点名：**哪些边缘绝不允许洇化**，让效果处理保留这些身份锚点。
 
 ## 连续性载体
 
@@ -46,7 +45,7 @@
 | 笔势 | 动作方向与余势 |
 
 「衣袖三笔飞白向左，收笔处最浓」可执行；「水墨感」「国风意境」不可执行。若项目在水墨上
-着彩，先声明彩色承担什么信息——通常只给一个焦点，多给一处就会和浓淡抢注意力。
+着彩，先声明彩色承担什么信息，并与浓淡层级共同分配注意力；按本场需要设置焦点。
 
 ## 运动预算
 

package/lib/drama/skills/short-drama/references/form-cards//351/243/216/346/240/274/345/214/226/344/270/211/347/273/264.md

@@ -6,13 +6,12 @@
 ## 叙事职责
 
 用**重量与空间**说话：接触、承重、碰撞、遮挡关系和有动机的镜头运动，让观众相信人和物
-在同一个空间里且有质量。它擅长连续的空间调度、复杂机位和可复用的角色资产。它不擅长
-靠单帧信息密度取胜，也不擅长随手改变角色比例——比例一旦定下就是全剧硬约束。
+在同一个空间里且有质量。它擅长连续的空间调度、复杂机位和可复用的角色资产。若依赖复杂的单帧信息或频繁改变比例，要先确认项目做法；已接受的稳定比例由各阶段共同继承。
 
 ## 身份锚点载体
 
 **比例 + 剪影 + rig 能达到的姿势范围**。识别靠头身比、肩宽、手长、材质分区，不靠妆造描述。
-身份字段应写两件别的形态不写的事：哪些比例与剪影不能被镜头畸变或姿势掩盖，
+身份字段需明确：哪些比例与剪影不能被镜头畸变或姿势掩盖，
 以及 rig 做不到的姿势有哪些。后者是硬约束，写进形态卡可以让下游不去要求不可执行的动作。
 
 ## 连续性载体
@@ -30,7 +29,7 @@
 - 效果层：体积光、粒子、景深、分级。
 
 若与二维线稿、绘制背景或特效混合，必须逐项声明谁负责身份、深度、边缘、光和运动。
-两层同时决定同一事实是这个形态最贵的错误：边缘会抖，光会打架，改一处要改两处。
+两层同时决定同一事实容易造成边缘与光照冲突，修订时也要同时处理两层。
 
 ## 光与材质词汇
 
@@ -48,9 +47,9 @@
 
 ## 声音与文字职责
 
-这个形态里**接触即有声**：落地、放置、碰撞、摩擦都应有对应声源，缺失会让重量感垮掉。
-口型通常可做完整口型，仍需在形态卡里确认，因为它决定台词长度与画外比例。可读文字若是
-场景内几何体（招牌、屏幕、包装），走资产 text policy，并声明是贴图还是后期层。
+接触声可帮助表现重量。落地、放置、碰撞、摩擦承担重量感或故事信息时，写清对应声源；
+有意静默按已确认声音方案执行，不逐项补造效果声。口型可考虑完整方案，仍需按制作能力确认，
+并与已接受的台词和声音通道对齐。可读文字若是场景内几何体（招牌、屏幕、包装），走资产 text policy，并声明是贴图还是后期层。
 
 ## 跨阶段传递
 

package/lib/drama/skills/short-drama/references/knowhow-index.md

@@ -1,8 +1,7 @@
 # 规则与路由索引
 
-本文件只做两件事：把每类决策路由到**负责的技能**，以及定义规则分级与冲突优先级。
-它不复制任何规则正文——每个技能的预检、所有权边界、形态输入与完整规则表，都在该技能
-自己的 `references/stage-contract.md` 里。核心不代子技能决定读哪一份资料。
+本文件将决策路由到**负责的技能**，并定义规则分级与冲突优先级。各技能的预检、所有权边界、
+形态输入与完整规则表见其 `references/stage-contract.md`；具体加载哪份资料由该技能决定。
 
 ## 目录
 
@@ -20,7 +19,7 @@
 | 抽样快评一本书值不值得拆 | `$short-drama-novel-analyze` | 全量拆解前先按抽样判断改编密度与风险 | 结论限于抽样范围，不产候选集条目 |
 | 改编价值与分集候选 | `$short-drama-novel-analyze` | 判断哪些单元在屏幕上成立、按戏剧结果切候选集 | 候选不是决定；集数由创作者与 develop 定 |
 | 故事承诺与冲突引擎 | `$short-drama-develop` | 从点子建立可持续压力与回报 | 不用题材词直接生成剧情 |
-| 单集契约与集尾交接 | `$short-drama-develop` | 规划进入状态、局部结果与出去压力 | 不代替剧本场景执行 |
+| 单集契约与集尾交接 | `$short-drama-develop` | 规划进入状态、局部结果与退出状态 | 不代替剧本场景执行 |
 | 单元里被反复运行的机制与耗尽 | `$short-drama-develop` | 单元故事靠同一套机制反复兑现，或中段开始重复、越写越薄 | 不规定运行次数与换代位置；不替单集决定怎么写 |
 | 爽点排名与开篇替换点 | `$short-drama-novel-analyze` | 选段与切候选集之前，按观众收益给全书情节点排名 | 排名是候选；从哪里开篇、提前哪段由创作者与 develop 定 |
 | 项目节奏档案 | `$short-drama-develop` | 按制作形态提出首钩、触点间隔、反转、VO 占比、镜长等项目数值 | 只提起点值；创作者接受后下游只做算术核对，未声明不核对 |
@@ -31,7 +30,7 @@
 | 题材条件与钩子 | `$short-drama-develop` | 需要按压力机制比较题材写法 | 不把案例节拍、数字或标签当公式 |
 | 单题材执行细节 | `$short-drama-develop` | 已确定题材、要落到场面颗粒与打法 | 一次只读一张卡；卡片不产生可阻断约束 |
 | 前提装置（先知或外部授权） | `$short-drama-develop` | 主角带着已知结果开局，或获得一套外部规则给的能力 | 装置叠加在题材之上，不替代题材卡，也不新建题材 |
-| 单形态执行细节 | `$short-drama` | 已确定制作形态、要按表定位一张形态卡 | 一次只读一张卡；形态不改写身份与地理 |
+| 单形态执行细节 | `$short-drama` | 已确定制作形态、要按表定位一张形态卡 | 单一形态读一张，混合形态按已声明层读所需两张；不预加载全部卡，形态不改写身份与地理 |
 | Look Development 与风格帧 | `$short-drama` | 把视觉方向变成人物、地点和高压力代表帧的可观察规则 | `$short-drama-image-prompts` 只投影提示词；风格不接管身份、地理或剧情 |
 | 场景与可表演行动 | `$short-drama-write` | 把单集节拍落实成场景 | 不决定分镜景别和运镜 |
 | 开场第一拍 | `$short-drama-write` | 写每集第一段动作描写，也就是观众开场第一帧的画面 | 静止画面自己能提出问题也算；不规定第一拍必须动 |
@@ -46,7 +45,7 @@
 | 资产出现证据 | `$short-drama-assets` | 从剧本拆角色、地点、道具与状态 | 不用名词/人名匹配直接建资产 |
 | 身份、变体与复用 | `$short-drama-assets` | 决定复用、新变体、新身份或未决 | 相机角度通常不是资产变体 |
 | 原著自带的真实品牌与现实实体 | `$short-drama-assets` | 剧本沿用了原著专名，且该专名指向现实存在的品牌、商标、机构或人物 | 不判断合规、不给禁令、不内置清单；只把选择交给创作者并留痕 |
-| 时代锚点 | `$short-drama-assets` | 定项目时代，或场所、设备、制服要落到某个年代的形制 | 时代从原著事实定；旧、老式、复古要有原著依据或创作者选择 |
+| 时代锚点 | `$short-drama-assets` | 定项目时代，或场所、设备、制服要落到某个年代的形制 | 按已提供的原著或剧本事实判断；旧、老式、复古要有来源依据或创作者选择 |
 | 资产图片提示词 | `$short-drama-image-prompts` | 把已接受资产投影为单帧可见规格 | 不承载有先后顺序的剧情动作 |
 | 场景板光线与跨 View 一致 | `$short-drama-image-prompts` | 同一地点要拆多个观察方向、且这些板会被互相剪接 | 朝向造成的逆光/落影差异不需拉平 |
 | 图片提示词定点修改 | `$short-drama-image-prompts` | 修改局部并冻结 preserve set | 不把重写整图伪装成局部编辑 |
@@ -65,7 +64,7 @@
 | 表演强度按形态与题材 | `$short-drama-video-prompts` | 导演没定表演强度，漫剧或爽文峰值需要外放、AI 真人需要可读的表演 | 仍写成常见的全身动作，不让剧情压在微表情上 |
 | 摄影机、声音与相连边界 | `$short-drama-video-prompts` | 写运镜、环境运动、口型或声音方向 | 不添加无来源的音乐/事件 |
 | 目标执行端能力档案 | `$short-drama-video-prompts` | 执行端的时长、参考方式、声音同轨或长度上限会改变正文写法 | 能力由创作者声明不由推断；不内置模型清单，不因收敛改写已接受边界 |
-| 跨场与跨镜连续性 | `$short-drama-assets` | 状态变化会传给下一场/镜/集 | 不复制整本 设定集 到每镜 |
+| 跨场与跨镜连续性 | `$short-drama-assets` | 状态变化会传给下一场/镜/集 | 只交接本镜依赖的事实，不复制整份视觉设定 |
 | 跨镜可见事实上锁 | `$short-drama-assets` | 服装、道具的颜色/材质在镜与镜之间漂移，参考图管不到 | 锁不变事实，不锁状态、姿势与镜头瞬态；锁面不替创作者选颜色 |
 | 制作形态翻译 | `$short-drama` | 把实拍、二维、三维、水墨等方向投影到各阶段 | 风格名或模型代码不是生产决策 |
 | 独立证据审查 | `$short-drama-review` | 冻结目标后写 finding 与 verdict | reviewer 不编辑 owner 来源 |

package/lib/drama/skills/short-drama/references/look-development.md

@@ -1,7 +1,6 @@
 # Look Development：把视觉方向变成可比较的代表帧
 
-Look development 不是给全剧粘一个风格标签，也不是让参考图接管角色和剧情。它把创作者
-接受的 `visual_direction` / `production_profile` 投影成少量**文本风格帧规格**，让人物、地点与
+Look Development 把创作者已接受的 `visual_direction` / `production_profile` 转成少量**代表帧的文本设计**，让人物、地点与
 高压力场景在正式分镜前共用一套可观察视觉语言。本阶段只产出规格和提示词；创作者要求
 实际出图时交给 `$short-drama-produce`，并对它展示的精确任务预览明确确认。
 
@@ -33,9 +32,9 @@ Look development 不是给全剧粘一个风格标签，也不是让参考图接
 
 ## 权限边界
 
-`$short-drama-image-prompts` 只把已接受方向写成 `purpose: lookdev_frame` 的通用图片提示词。
-风格参考的 `role` 是 `style`，可控制色彩层级、材质处理、阴影边缘、景深倾向和画面密度；
-必须在 `must_not_control` 中保护角色身份、固定场景地理、剧情状态、道具文字和信息揭示。
+`$short-drama-image-prompts` 把已接受方向写入 `图片提示词.md` 的代表帧条目，并在用途说明中标明
+用于视觉方向比较。风格参考按完整 `REF-...` 声明填写，`用途` 写 `风格`，控制色彩层级、材质处理、
+阴影边缘、景深倾向和画面密度；`不得控制` 中保护角色身份、固定场景地理、剧情状态、道具文字和信息揭示。
 
 人物表现帧仍绑定准确人物/造型；地点帧仍绑定准确地点/视角；压力场景仍绑定已接受的场景、
 人物和剧本来源。风格帧没有权力发明这些事实，也不能反向覆盖资产或剧本。
@@ -47,5 +46,4 @@ Look development 不是给全剧粘一个风格标签，也不是让参考图接
 生产观察，只在准确方向、提示词版本、参考槽位和制作配置范围内修订该项目。没有观察时只报告
 文字风险，不声称画面已经成功或失败。
 
-接受的是可观察的视觉选择，不是某个供应商、模型名、参数或任务结果。任何二进制媒体仍留在
-外部制作环节，不进入文本交付包。
+接受的内容应是可观察的视觉选择。实际图片经生产流程另行生成；本阶段的文本设计不代表已经出图或验证效果。

package/lib/drama/skills/short-drama/references/pickup-and-alternate.md

@@ -6,12 +6,15 @@
 | 补拍 | 补一个动作、反应、构图或效果 | 与母版并存，不替代 |
 | 替代版 | 同一要求的另一种实现 | 必须明确比较后才能替代 |
 
-缩小提示词范围经常是正确修复。危险不是“变短”，而是把只拍了一部分的版本悄悄当成母版，使未被
-它承担的对白、反应、揭示或终点从此无人负责。
+缩小提示词范围可以帮助修复，但只承担部分要求的版本不能直接成为母版；未承担的对白、反应、
+揭示或终点仍须有明确去向。
 
 ## 补拍必须逐项交代去向
 
-在 `视频提示词.md` 中为补拍或替代版使用稳定 `MOTION-...` ID，并写清：
+当前五文档要求每个正式 `SHOT-...` 只对应一个 `MOTION-...`，编号部分相同。比较方案时，先在
+对应 MOTION 的普通说明中记录差异与版本关系，不新增第二个正式条目或第二段可复制正文。需要独立
+补拍时，先交分镜阶段确定对应 SHOT 的职责与边界，再建立匹配的 MOTION；替代方案获确认后更新
+对应正式正文。无论采用哪种方式，都写清：
 
 1. 它对应哪个母版；
 2. 原文要求逐项由本版本、母版、另一补拍承担，还是必须退回分镜；