@oh-story/dsh 0.1.15 → 0.1.16

package/lib/drama/skills/short-drama-review/references/rubric-story-script.md

@@ -35,7 +35,7 @@
   evidence carrier, deadline, or rule, does resistance, action, and consequence dramatize
   it, rather than merely naming it in dialogue?
 - Could a viewer identify those stakes from the screenplay alone, without access to
-  the upstream brief or episode card?
+  the upstream brief or episode planning?
 - Do explicit brief facts, must/forbid constraints, genre contract, and required exit state
   outrank craft defaults, or did the screenplay invent precision, records, resources,
   procedures, relationships, or mechanisms merely to display a rule?
@@ -58,9 +58,9 @@
 A capacity estimate (`STY-16`) is informational, never a blocking finding. If a
 planned episode's shot/duration magnitude is far from the project's own accepted
 ratios, note it as an advisory observation with the sampled basis, and leave the
-resolution to the creator. Do not derive a word, line, or shot quota from it. The only
-numbers a review checks are the ones in an accepted rhythm profile
-([below](#rhythm-profile-rev-12)), and never another project's numbers.
+resolution to the creator. Do not derive a word, line, or shot quota from it. Rhythm
+comparisons use only an accepted profile ([below](#rhythm-profile-rev-12)); explicit
+numbers already required by the brief, such as a literal deadline, still need their own consistency checks.
 
 When the premise grants foreknowledge or externally authorized ability (`STY-17`), keep
 two layers apart and cite each from its own place:
@@ -83,11 +83,13 @@ What is reportable:
 - Strip the device out—does the episode still contain a choice? If not, cite what
   resistance was removed and never replaced.
 - What did the opposition learn once the device was in play?
-- For foreknowledge: does the information degrade as the timeline diverges, or does the
-  author keep inventing reasons to weaken the protagonist? Is the audience's permission
-  level held constant across episodes?
-- For authorized ability: is the cost visible and landed on something the protagonist
-  cares about? Does the device offer options, or decide for them?
+- For foreknowledge: does the information change according to the accepted timeline rules,
+  or does the author invent new limits to weaken the protagonist? Can changes in audience
+  knowledge be traced to information released in the episodes?
+- For authorized ability: when the contract establishes a cost, is it visible and consequential
+  to the protagonist? When the genre places pressure on the opponent, does that opposition
+  remain active without inventing a new cost to dilute the reward? Does the device offer options,
+  or decide for the protagonist?
 - If the device uses an on-screen readable carrier, is the `exact-readable` obligation
   stated instead of coexisting with a global no-text policy?
 
@@ -133,8 +135,8 @@ Active only when the project adapts a source. Read the source span each mapping
   Pressure made louder or spoken aloud is fine; a supportive figure turned oppressor,
   or a relationship reversed, is a finding unless the creator accepted the change.
   Cite the source fact and the conflicting screenplay line (`REV-03`).
-- Does the main line still run the source's way, and does any invented detail
-  contradict a source fact?
+- Are the main line and invented details consistent with source facts, except for changes
+  the creator has explicitly accepted?
 - Is every character, scene, or opponent the source lacks registered as its own `add`
   mapping, with the function it serves, why existing source material cannot carry it,
   the source facts checked against it, and a line in the brief for the creator (`STY-30`)?
@@ -236,7 +238,7 @@ nothing else:
 | `opposed_reversals_per_episode_min` | Reversals driven or suffered by a human opponent with an agenda; changes completed by a system, a number, or the environment alone do not count. |
 | `end_on_peak` | Whether the last beat sits on or just before the peak, with no afterglow, summary, or quiet coda after it. |
 | `reprise_previous_last_beat` | Whether the opening replays the previous episode's last beat. Not applicable to the first episode. |
-| `vo_share_max` | `[VO]` spoken characters as a share of all spoken characters; `$short-drama-write`'s duration estimate reports it when run with the project file. |
+| `vo_share_max` | `[VO]` characters as a share of all dialogue characters under the write estimate's convention: whitespace and parenthetical directions removed, punctuation retained; `[OS]` belongs only in the denominator. `$short-drama-write` reports the share with the project file when the accepted ceiling is valid and dialogue is present. |
 | `first_major_payoff_by_episode` | Series review only: the episode in which the first major payoff lands. |
 
 Seconds come from the project's declared pacing, or from a real-time read-through
@@ -248,8 +250,8 @@ are measured in the [visual rubric](rubric-visual-motion.md#rhythm-profile-shots
 
 ## Local passes (`REV-13`)
 
-After the whole-episode read, run three passes that each read one part only. A whole
-read lets a strong middle excuse a flat opening; a part read cannot.
+After the whole-episode read, run three passes that each read one part only, so each
+segment is assessed on what it delivers at that point.
 
 1. **Opening hook**: read only the first segment, up to `first_hook_seconds` or, with
    no accepted profile, the first scene. Would a viewer who saw only this stay? Name
@@ -259,10 +261,12 @@ read lets a strong middle excuse a flat opening; a part read cannot.
    first (`SCR-22`)? A still image that poses its own question passes. For a first
    episode, also check that the brief compared the entry candidates on that same image
    (`STY-25`).
-2. **Ending suspense**: read only the last segment, the final scene's closing beats.
-   What question is left open? Does it grow out of this episode's result? Is it a line
-   hook (an unfinished question, an identity hint) or an image hook (a door half open,
-   an envelope half torn)? Does it stop before the answer?
+2. **Ending suspense**: read only the final scene's closing beats. Do they fulfill the
+   episode's accepted ending function? When suspense is intended, what question remains
+   open, and does it grow out of this episode's result? A line hook (an unfinished question,
+   an identity hint) or an image hook (a door half open, an envelope half torn) may stop
+   before the answer. A resolved, quiet, ironic, or intentionally open ending is judged
+   by its own contract; an accepted `end_on_peak` profile takes precedence.
 3. **Mid-episode reversal density**: read only the middle. List each reversal with its
    location and the person driving or suffering it; flag long stretches with no
    touchpoint and reversals bunched at the end.
@@ -273,16 +277,16 @@ the numeric comparisons need one.
 ## Replaceable realization (`SCR-10`)
 
 Only for beats the creator marked. **An unmarked beat leaves this section
-inactive**: do not raise a finding for the absence of a mark, do not guess which
-beats need one, and never rate a depiction against a standard this suite does not
-carry — it carries none, and predicts no outcome.
+inactive**: do not raise a finding for the absence of a mark or choose marks for
+the creator. The suite carries no platform approval standard and predicts no approval outcome.
 
 On a marked beat:
 
 - Is the dramatic function written as *who is proven or changed*, rather than an
   emotion word? A function stated as "高潮" cannot be used to judge equivalence.
 - Does the fallback deliver that same function — same person affected, cost still
-  paid, `payoff_refs` and the next episode's entry state still satisfied?
+  paid, downstream payoffs and the next episode's entry state still satisfied?
+  Existing structured material may locate those payoffs through `payoff_refs`; no new record is required.
 - Does the fallback need a setup the script has not established? Then it is a
   rewrite, not a fallback.
 - Is "delete the scene" being offered as the fallback? Deletion removes the
@@ -290,9 +294,9 @@ On a marked beat:
   which existing beat now carries it and what that beat must absorb.
 - Is the fallback concrete enough to become scene action, or is it "酌情处理"?
 
-Report pre-emptive sanding as a finding in its own right when the current
-depiction was already weakened to avoid a risk nobody stated: the loss is certain,
-the benefit is not, and the mark exists precisely so the strong version can stay.
+When a depiction was weakened to avoid a risk nobody stated, cite the lost dramatic
+function and the absence of a creator requirement. A marked fallback preserves the
+current choice until a concrete need for replacement arises.
 
 ## Common findings
 

package/lib/drama/skills/short-drama-review/references/rubric-visual-motion.md

@@ -13,7 +13,7 @@
 
 ## Coverage and meaning
 
-- Does every production-relevant block have a disposition?
+- Can every production-relevant action, line, sound, or on-screen text in `剧本.md` be traced to a shot or an explicit omission reason?
 - Are omissions/repeats explained?
 - Does each shot preserve the source action, dialogue, information, and reaction?
 - Has downstream work invented or deleted a story fact?
@@ -23,7 +23,7 @@
 - For a high-value scene with an accepted coverage audition: did the approaches
   genuinely differ — in knowledge timing, audience alignment, performance space,
   strongest image, landing, losses, or production fit?
-- Does the formal plan bind the approach the creator selected, rather than the first draft?
+- Do the final shots in `分镜.md` implement the approach the creator selected?
 - When a scene visual plan was used: do its start/end audience positions, spatial
   pressure, camera rhythm, reaction landing, and sound movement carry **one** dramatic turn?
 - Does that plan stay clear of owning shot boundaries? (Ordinary scenes need no plan
@@ -50,7 +50,8 @@
 Under the `REV-12` conditions in the [story rubric](rubric-story-script.md#rhythm-profile-rev-12),
 measure two storyboard fields: the average shot length per scene (scene duration divided
 by its shot count) against `target_avg_shot_seconds`, and the share of close-range shots
-across the episode, as the profile field defines them, against `close_shot_share_min`. The average is a
+across the episode against `close_shot_share_min`. Close-range shots include 近景、特写、大特写 and 细节镜头;
+divide their count by the episode's total shot count. The average is a
 scene-level target; one long or short shot is not a finding. Also report durations folded
 from screenplay word counts instead of the scene's sound timeline (`SHT-28`).
 
@@ -78,7 +79,7 @@ from screenplay word counts instead of the scene's sound timeline (`SHT-28`).
 ## Motion
 
 - Does it start from the accepted frame/boundary?
-- Are subject actions ordered and small enough to preserve intended performance?
+- Are subject actions ordered and feasible within the accepted duration while preserving the intended performance?
 - Does performance change express the story move rather than stack synonyms?
 - In multi-character motion: do the actors who actually change have distinct,
   readable triggers, choices, leaks, or landings — as this shot needs, not one
@@ -90,8 +91,7 @@ from screenplay word counts instead of the scene's sound timeline (`SHT-28`).
 - Is camera behavior coherent and motivated?
 - Are environment motion, dialogue, SFX, and audio included only when relevant?
 - Does the described end match the storyboard's written end state without rewriting the next shot?
-- When a reference frame carries appearance/composition, does motion prose avoid
-  dumping the full visual 设定集?
+- When a reference frame carries appearance/composition, does motion prose retain only the visual facts this shot needs?
 - Does every claim about text-bearing reference pixels cite a creator/reference-owner
   description or an authorized input-reference observation? Without that evidence,
   is admission still `unverified` instead of pretending a negative prompt solved it?
@@ -113,10 +113,10 @@ observations scoped to their tested model and execution path.
 
 For a pickup or alternate, ask these separately:
 
-- Does the pickup/alternate name its master by visible `MOTION-...` heading?
+- Does the pickup/alternate identify its master? Keep candidate differences in ordinary notes and one formal `MOTION-...` with one copyable body per `SHOT-...`; a separate pickup first needs its own storyboard shot.
 - Is every source obligation assigned to the master, this version, another named version or a requested storyboard revision?
 - Are the changed items and the items that must remain unchanged explicit?
-- Is replacement only requested here? The review Markdown decides whether the master remains primary or the alternate replaces it.
+- Is replacement only requested here? The review Markdown decides whether to adopt the candidate; the owning skill then updates the formal body.
 
 For music, ask these separately (`VID-14`):
 
@@ -178,9 +178,9 @@ ellipsis, dream, or deliberate disorientation.
 并把该记录作为外部证据引用。没有观察记录时保持结果未知，不从任务成功、结果地址或提示词
 存在推断成片质量。
 
-需要项目校准时，先区分输入参考与生成结果。后一种观察只有在绑定准确的提示词/镜头标题、参考顺序、
-制作形态/配置、观察方法和限制时才可引用；finding 同时给出最小修改项与保持项，并保持结论只在该项目
-和版本条件下有效。
+需要项目校准时，先区分输入参考与生成结果。后一种观察须绑定准确的提示词/镜头标题、参考顺序、
+制作形态/配置、观察方法和限制；先按 `REV-11` 选择处置，需要改动时再写最小修改项与保持项。
+结论只在该项目和版本条件下有效。
 
 短剧生产中需要防范的文字风险或获授权观察包括：
 

package/lib/drama/skills/short-drama-review/references/stage-contract.md

@@ -1,9 +1,10 @@
 # 审查阶段契约
 
-本阶段只拥有审查结论与修订要求，不改写 owner 来源。需要落盘时使用创作者可读 Markdown，引用当前
+本阶段只拥有审查结论与修订要求，来源修改交回负责技能。需要落盘时使用创作者可读 Markdown，引用当前
 文件名、标题 ID、行号或短引文；不建立 JSON/JSONL、来源快照、哈希或接受状态。
 
-审查可以由独立 reviewer 或明确标注的自检完成。媒体不可见时保持未知；外部生产仍需要自己的显式确认。
+审查可以由独立 reviewer 或明确标注的自检完成。媒体不可见时保持未知；外部生产须展示本次任务预览，
+再由创作者明确确认。
 
 ## 本阶段规则
 

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

@@ -30,15 +30,14 @@ license: MIT
 [镜长从哪来](references/shot-craft.md#镜长从哪来-sht-28) 由声音事件与 `target_avg_shot_seconds` 推出，
 全集近景类镜头占比不低于 `close_shot_share_min`；档案缺失或未接受时不核对这些数值。
 
-冻结关键帧写完之前，谁会出现在这一格画面里还没有定下来。所以三条依据都在关键帧之后回填，
-读的是成稿画面，不是镜头意图。
+冻结关键帧成稿后，再按画面中的可见内容填写视觉依据、图片提示词项和输入参考图，
+避免只按镜头意图列资产而漏掉实际入画的人物或物件。
 
 用户没有手工点名参考图，不等于选择文生视频。冻结关键帧后先根据本镜可见人物、地点、关键道具与
 起始构图判断一致性需求，再检查项目中已有的真实图片。只有当前可读、内容与用途可核对的图片才能自动绑定；
 文件名像某个角色但内容未核对时，仍视为未准备好。
 
-项目里一张都没有时，创作者有三条路，一次把三条都说清楚再让他选，不要只给「先生成参考图」和
-「改成文生视频」两个：把手上已有的图片放进项目再绑成 `REF-...`；在自己的工具里出图、本轮先用
+项目里没有所需图片时，一次向创作者说明三条可选路径：把手上已有的图片放进项目再绑成 `REF-...`；在自己的工具里出图、本轮先用
 `PLAN-...` 写出挂图计划；或者明确改走文生视频。用本套件的生产技能出图只是第一条路的一种做法，
 需要项目外的 adapter 与凭据，不是唯一入口。
 
@@ -85,8 +84,7 @@ license: MIT
   需要看见的动作应另有镜头承载，或说明为何省略。
 
 - 剧本里的每个场景都要有镜头承载。确实决定不拍某一场时，在《分镜.md》正文开头写一行
-  `- 未拍场次：<场景 ID>（理由：……）`，多项用 `；` 连接。SHT-01 一直允许带理由的省略，
-  但省略和漏拍在成稿文档里长得一模一样，所以理由要写下来，而不是留在对话里。
+  `- 未拍场次：<场景 ID>（理由：……）`，多项用 `；` 连接。省略理由必须留在成稿文档中，供下游区分有意省略与遗漏（SHT-01）。
 - 已声明原生时长时，每镜照常有自己的唯一职责、起止边界和冻结关键帧，镜长先按叙事需要定。短于最短秒数
   的镜头，向创作者提议把同场相邻的几镜装进一个多镜容器，在交付档案里声明；目标方言要求时，容器的每一切
   都要有已接受的关键帧图片，能否装、怎么装由 `$short-drama-video-prompts` 的方言决定。创作者没有声明
@@ -105,7 +103,7 @@ license: MIT
 - 近景类关键帧挂着地点板生成时，图片常被拉宽成中远景；正文写具体取景（画面切在哪、脸在画面哪里、机位距离），出图仍偏宽就这一镜不挂地点板，把背景写进正文。
 - 一集的关键帧要像同一部片：每条正文用同一句画风（写实就写写实，不混用「漫剧」「插画」这类会把一部分图拉向插画脸的词），每个场景写同一句光与色温；生成时先出该场景一张中远景作定调图并接受，其余镜头把它作为最后一张参考、只取色调、光线与质感，不取构图。
 - 《视觉设定.md》的连续性锁在生效镜头上原样写进冻结关键帧正文；锁面不因“参考图会交代”而省略。
-- 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。镜头块里的「视觉依据」是本镜的依据字段，不是这里说的覆盖表。
+- 检查发现遗漏就直接修正文档，不生成覆盖表来证明自己检查过。镜头块里的「视觉依据」是本镜的依据字段，不属于额外覆盖表。
 
 ## 视觉依据与图片
 
@@ -116,10 +114,10 @@ license: MIT
   `《视觉设定.md》·<人物|造型|地点|道具>「<名称>」（控制：<范围>）`，多项用 `；` 连接，名称必须能在《视觉设定.md》里找到同名标题。
   小比例或背景人物只要需要认出身份仍在范围内，画外人声和不可识别局部不算；本镜确实没有这类条目时写「视觉依据：无」。
 - 关键帧正文出现了某个条目的名字，但它本镜确实不在画面里（物主已离场、名字只出现在屏幕文字上、和某个词同形），
-  在「视觉依据」末尾追加 `；画外：<类别>「<名称>」`。这是如实记录，不是把不在场的人写成在场。
+  在「视觉依据」末尾追加 `；画外：<类别>「<名称>」`。该声明只说明名称被提及，人物或物件并未入画。
 - 某个条目的名字在正文里根本不可靠（`道具「手机」` 会撞上「手机店」，`人物「小雨」` 会撞上「下着小雨」），
-  在《视觉设定.md》该条目写 `画面代称：无`，机械核对就不再按名字找它；这一镜是否画到它仍由「视觉依据」如实回答。
-- 三条依据都描述同一格画面，不是本镜的资产花名册。「控制」只写这一格承担得起的范围：手背特写不写「本集造型」，
+  请视觉设定负责技能在该条目写 `画面代称：无`，机械核对就不再按名字找它；这一镜是否画到它仍由「视觉依据」如实回答。
+- 三条依据都只描述当前关键帧中的可见内容。「控制」只写这一格承担得起的范围：手背特写不写「本集造型」，
   只出现屏幕和一根手指的镜头不写「体态」。上一镜的绑定不因为“角色还在这场戏里”就顺延到下一镜。
 - 关键帧正文点名的人物、地点或道具（《视觉设定.md》条目名称或它声明的「画面代称」），必须出现在本镜「视觉依据」里；
   `creator_markdown_check.py` 会机械核对这一条。它只抓**被名字点到**的那一类：正文只描述不点名

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

@@ -1,4 +1,4 @@
 interface:
   display_name: "短剧分镜"
-  short_description: "把剧本与资产拆成完整coverage、有动机镜头和冻结关键帧"
+  short_description: "把剧本与视觉设定转为覆盖完整、动机明确的镜头和冻结关键帧"
   default_prompt: "使用 $short-drama-storyboard 把已接受剧本和资产拆成有动机的镜头与冻结关键帧提示词。"

package/lib/drama/skills/short-drama-storyboard/references/blocking-playbooks.md

@@ -15,7 +15,7 @@
 
 ## 1. 竖屏多人调度
 
-竖屏不是把所有人排成上下两层。先画出人物能怎样通行，再决定纵向画幅怎样表现关系与权力：
+先画出人物能怎样通行，再决定纵向画幅怎样表现关系与权力，避免只按上下两层排人：
 
 - 用前景、中景、后景、门框、台阶和桌沿建立深度。
 - 明确谁能接近证据、出口或权力座位。
@@ -31,16 +31,15 @@
 
 ### 交付面遮挡 (`SHT-15`)
 
-竖屏画面在播放时通常不是完整可见的：播放界面会在画幅上叠一层东西——字幕条、播放控件、
-进度条、侧边的互动控件、片头片尾的角标。**画幅是满的，可读区不是**。 这与拍摄无关，
-是交付面的事实，所以它约束的是构图决定，而不是画面内容。
+播放界面可能叠加字幕条、播放控件、进度条、互动控件或角标，遮住部分画面。
+按项目已声明的叠加范围检查构图，确保关键信息仍然可读。
 
 **`reviewed_invariant`**：当创作者已声明交付面的遮挡区时，本镜必须被读到的内容（脸与
 眼神、证据上的可读文字、决定性的手部动作）不能只落在这些区域里。遮挡区、是否常驻及其
 来源引用都取自已接受的交付方案；**没有声明就没有这条约束**。
 
 - **未声明时保持未解决，不要猜**。 记为待创作者决定，照常按画面本身的可读性构图，
-  **不因为猜测的区域改变构图**——猜出来的避让同样是一个通用安全框，只是没写在纸上。
+  **不因为猜测的区域改变构图**。
   需要时向创作者提一次问：这次交付的播放面会在画幅哪些位置叠加什么、是否常驻。
 
 声明由**创作者拥有**，写在 `视觉设定.md` 的“交付面”章节，与项目视觉方向和制作形态并列。
@@ -52,8 +51,7 @@
 - 承载字幕、控件、角标还是其他内容；
 - 创作者提供的平台模板、截图或文字说明。
 
-没有声明时本规则不生效：镜头照常按画面本身的可读性构图，把问题留为待创作者决定。已经声明时，
-受影响镜头在 `分镜.md` 指名交付面区域 ID；交付方案改版后重新核对，不沿用上一版避让结论。
+已声明交付面时，受影响镜头在 `分镜.md` 指名区域 ID；交付方案改版后重新核对，不沿用上一版避让结论。
 已声明遮挡区后，按下面的优先级判断哪些内容必须挪开：
 
 - **可读文字最敏感**：证据类道具上必须被读出的字，一旦落在字幕条位置，观众永远读不到。
@@ -65,8 +63,7 @@
 - **不要把避让写成通用禁区**。它是本项目交付方案下的构图约束；换交付面就要重新确认，
   也不能反过来要求剧本改动作发生的位置。
 
-失效方式是安静的：单帧看构图很好，只有放到实际播放面上才发现关键信息被压住，而这时
-关键帧与视频提示词都已经做完了。所以这个判断属于分镜阶段，不属于交付前检查。
+分镜阶段先核对已声明遮挡区，交付前再放到实际播放面复核，避免关键帧和视频完成后才发现关键信息被压住。
 
 ## 1b. 轴线、屏幕方向与正反打
 
@@ -107,7 +104,7 @@ working side：摄影机常驻红毯一侧
 
 ### 越轴之后要重新记账
 
-越轴的合法手段见本文上一节。但越完之后，**新的 working side 必须重新声明并被后续镜头
+越轴的过渡方法见[群体与轴线](#4-群体与轴线)。越轴后，**新的 working side 必须重新声明并被后续镜头
 继承**——否则后面每一镜都在各自猜轴线在哪。越轴那一镜本身也要标明它是越轴，而不是让
 下游从方向矛盾里反推。
 
@@ -203,7 +200,7 @@ working side：摄影机常驻红毯一侧
 - 门、灯、天气和文字状态。
 - 谁知道什么；这一项只引用剧本来源。
 
-镜头结束边界是事实来源；关键帧只投影镜头开始边界；运动规格只实现这段过程。
+镜头起止边界是事实来源；首帧投影开始边界，可选尾帧投影结束边界，运动提示词实现两者之间的过程。
 不能把本镜动作结果提前写进起始关键帧，也不能在相邻两镜重复完整动作。若 SHOT-02
 的结束状态是“右手刚开始伸出”，SHOT-03 才能完成取物；若 SHOT-02 已完成取物，
 SHOT-03 就必须从“已经持有”继续。

package/lib/drama/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md

@@ -15,13 +15,11 @@
 
 ## 这份词表解决什么问题
 
-项目视觉方向接受为漫剧 / 二维漫画形态后，写关键帧 `generic_prompt` 的人会撞上同一个
-问题：身份、地理、边界事实都绑好了，但“这一帧怎样投影已接受的画风、当前镜头要防什么
-可读性风险”每次都要重新发明措辞，同一个项目里不同集的提示词各说各话。这份词表把
-项目级画风基底与镜头级可选词分开，让同一项目复用一份视觉语言，又不把镜头差异抹平。
+项目视觉方向接受为漫剧 / 二维漫画形态后，先读取共享画风基底，再选择当前镜头需要的光色和可读性约束。
+同一项目复用稳定的视觉语言，局部写法仍由镜头职责决定。
 
-它是 [关键帧手艺](keyframe-craft.md) 的补充，不是替代：主体、边界瞬间、构图、机位、光线、
-连续性与排除项仍先写清，本词表只负责画风投影、光色倾向和当前帧的可读性约束。
+先按[关键帧手艺](keyframe-craft.md)写清主体、边界瞬间、构图、机位、光线、
+连续性与排除项，再用本词表选择画风、光色倾向和当前帧的可读性约束。
 事实先于审美词的优先级不变——词表里的任何词都不能顶替身份、地理、构图与连续性事实。
 
 ## 规则分级与语言政策
@@ -41,7 +39,7 @@
 建议按三层组织；重点是事实先于审美词，不把段落顺序本身当成机械门槛：
 
 1. **场景 / 主体事实**：这一帧拍谁、在哪、处于哪个边界瞬间——来自已接受的资产、镜头边界与
-   [keyframe-craft.md](keyframe-craft.md) 的十二项。本词表不提供这一层，也不允许用风格词冒充它。
+   [keyframe-craft.md](keyframe-craft.md) 的构图与边界检查。本词表不提供这一层，也不允许用风格词冒充它。
 2. **视觉语言投影**：项目级共享画风基底 + 当前镜头需要的光色或表现手段。先从已接受的
    “项目视觉方向”读取稳定项，再按镜头目的补局部变化；不能每集回表重新选一套。
 3. **可读性 / 风险约束**：只写当前帧确实可能失去的可见信息，例如目光、持物、特效起点或
@@ -112,8 +110,8 @@
 
 1. 先按 [关键帧手艺](keyframe-craft.md) 写清谁、在哪、边界瞬间的姿态/目光/持物、构图、机位、
    光线、连续性和排除项。这一步不碰本词表。
-2. 读取 `视觉设定.md` 的“项目视觉方向”。若基底仍只有名称或尚未决定，就在当前任务完成最小
-   Look Development 比较；选定结果直接写回该章节。
+2. 读取 `视觉设定.md` 的“项目视觉方向”。若基底仍只有名称或尚未决定，向视觉设定负责技能提出最小
+   画风比较请求；由其更新该章节，创作者接受后再用于本镜。
 3. 判断这一帧的类型：叙事关键帧 / 对话镜头 / 动作特效帧。类型由镜头目的决定，不由
    “想要好看的特效”决定。
 4. 投影项目级画风的稳定项，再从对应镜头表挑当前需要的局部变化。可读性约束必须能指向
@@ -123,15 +121,16 @@
 ## 完整示例（合成改写）
 
 竖屏 9:16 漫剧，已接受视觉方向为“国风条漫：墨线粗细变化、分层设色、留白参与空间组织；
-暗调场景允许局部冷暖分区”。场：雨夜天台对峙，叙事关键帧。十二项事实按
-`keyframe-craft.md` 写满后，视觉投影与可读性约束这样接在事实之后：
+暗调场景允许局部冷暖分区”。场：雨夜天台对峙，叙事关键帧。按
+`keyframe-craft.md` 核对当前帧的必要事实后，将视觉语言与可读性约束接在事实之后。
+下方片段示意这种组合：
 
 ```text
 竖屏 9:16 中近景。机位在轴线左侧、平视略低约五度，标准焦段。前景是湿透的栏杆扶手
 （占下缘约六分之一）；中景两人对峙；背景是虚焦的城市灯斑与雨幕。三分构图，她落右三分线。
 她在栏杆内侧，双手握栏杆，身体朝向正前，视线落在对方胸口，无持物。人物乙站在她正前方
 约两步、略偏画面左，一手插袋，身体朝向她。光自画面右上高杆灯斜下为硬主光，左侧留暗。
-视觉重点在她握栏杆的双手。位置与持物与上一镜相同。
+视觉重点在她握栏杆的双手。
 视觉语言：国风条漫，墨线粗细分明，前中后景分层设色；暗调叙事，右上硬光形成局部冷暖分区。
 可读性约束：雨幕不遮住两人的面部识别点与她握栏杆的双手；栏杆、人物和城市背景层级分明。
 排除：不出现动作过程；不新增道具或可读文字。

package/lib/drama/skills/short-drama-storyboard/references/coverage-audition.md

@@ -1,7 +1,7 @@
 # 关键场景 Coverage Audition
 
-Coverage audition 在正式 shots 前比较真正不同的导演方案，避免第一种合理做法直接成为唯一答案。
-它不是固定镜头数、固定宫格或自动变体器；创作者选择之后才投影为正式场次视觉计划和 shots。
+Coverage audition 在正式分镜前比较不同导演方案，由创作者选择后，再把结果写入场次视觉计划和正式镜头。
+方案按观看体验区分，不预设镜头数或宫格数量。
 
 ## 什么时候比较
 
@@ -25,9 +25,8 @@ Coverage audition 在正式 shots 前比较真正不同的导演方案，避免
 ## 比较方式
 
 在上下文中用真实场景 ID 绑定当前剧本、项目视觉方向、制作形态、地点视图与参与资产；逐方案回答：
-观众何时知道什么、
-站在哪一边、谁拥有表演空间、最强画面与最终落点、可能丢失的空间/反应/信息、与制作形态是否
-相容。保留反对理由，不替创作者选择。
+观众何时知道什么、站在哪一边、谁拥有表演空间、最强画面与最终落点是什么、
+可能丢失哪些空间、反应或信息，以及方案是否与制作形态相容。保留反对理由，不替创作者选择。
 
 不得固定四宫格、九宫格、二十五宫格或景别比例。宫格只是人工比较界面，不是镜头数量公式。
 展示各方案的取舍后，由创作者选择；只把选中的观看位置、信息时机、空间与声音策略投影进正式

package/lib/drama/skills/short-drama-storyboard/references/keyframe-craft.md

@@ -47,37 +47,34 @@ composition, camera/lens, frame-only staging, and exclusions.
 
 ### 写完之后过一遍可渲染检查
 
-判据是一句话：**接手的人能不能照着画出来，而不用自己发明任何事实**。逐条对照，
-缺哪条补哪条——这些不是可选修辞，缺一条执行端就得替你决定一次：
+检查接手的人能否读出当前帧必须保持的可见事实。按构图和镜头职责核对下表，
+只补本帧实际需要的内容：
 
-| 必须写出来 | 缺了会发生什么 |
+| 检查内容 | 信息缺失时的风险 |
 |---|---|
 | 每个人在哪、彼此距离多少（"站在他正前方约两步"） | 人物间距逐镜漂移，观众读成换了场地 |
-| 前景、中景、背景各有什么 | 纵深塌成一层，主体贴在背景上 |
+| 构图需要纵深时，前景、中景、背景分别承载什么 | 层次不明，主体与背景混在一起 |
 | 视线该落在哪（本镜的视觉重点） | 画面平均用力，观众不知道该看谁 |
 | 构图方式与景别 | 同一场每镜构图随机，剪不到一起 |
 | 机位在轴线哪一侧、俯仰角度、焦段意图 | 越轴；正反打方向对不上 |
 | 光从哪来、什么质感 | 同场光位逐镜跳变 |
 | 每个在场者的姿态、朝向、手部、持物 | 下一镜接不住，道具凭空易手 |
-| 哪些与上一镜相同 | 执行端把"没写"读成"可以变" |
+| 与上一镜连续的关键状态在本帧具体是什么 | 只写“同上”，当前正文无法独立说明状态 |
 
-最后一条最容易漏，也最便宜：与上一镜一致的部分**写一句"与上一镜相同"即可**，
-不必重述细节；真正变了的才展开写。这一句是连续性的承载点。
+连续性核对时可以与上一镜比较；可复制正文仍须写出当前帧的位置、持物和其他必要状态，
+不能用“与上一镜相同”代替执行端本次需要的事实。
 
-**写紧**：一件事只说一次，能并进一句就不另起一句。上表十二项写满大约五百字就够；
-写到八百字往上，多出来的通常是连接词、铺垫句和把同一件事换个说法再说一遍——它们不增加
-可渲染的事实，却按字数付费。检查办法：删掉任意一句，如果画面没有变得更不确定，那句就是
-多的。
+**`craft_default`：一件事只说一次。** 合并能自然衔接的句子，删除重复事实和不帮助确定画面的铺垫。
+不设通用字数门槛；保留当前帧所需的身份、空间、构图、光线、文字和连续性事实。
 
-写出来是这样（合成材料，四百余字覆盖上表全部十二项）：
+以下合成片段示意构图与静态事实的组织方式：
 
 ```text
 竖屏 9:16 中近景。机位在轴线左侧、高约一米二，平视略低约五度，中焦 50mm。前景是长凳
 扶手与半张湿报纸（占下缘约六分之一）；中景是两人对峙；背景是虚焦的候车牌。三分构图，
 她落在右三分线上。她：坐长凳右端，双手交叠压膝，身体朝向正前，视线落在对方鞋尖，
 无持物。人物乙：站她正前方约两步、略偏画面左，双手插袋，身体朝向她，头略偏向出口。
-光自画面右上顶棚缝隙斜下为主光（硬），左侧留暗，无补光。视觉重点在她压膝的双手——
-本镜唯一不动的东西。位置与持物与上一镜相同，只有她的视线从水洼移到对方鞋尖。
+光自画面右上顶棚缝隙斜下为主光（硬），左侧留暗，无补光。视觉重点在她压膝的双手。
 排除：无动作过程，无雨丝拖影。
 ```
 
@@ -93,13 +90,11 @@ instead of inventing a hidden candidate state.
 
 ## 尾帧：什么时候可以有，以及它换来什么代价（`SHT-17`）
 
-默认每镜一张关键帧，冻结的是 start。但首尾帧接续是 AI 视频里最常用的工作流之一：把首帧
-和尾帧一起交给执行端，中间由它补。套件此前没有尾帧的位置，于是这条路要么走不通，要么被
-私自绕过——后者更糟，因为绕过时尾帧往往是**独立画出来的**，它就成了第二个终点权威，与
-镜头 `end_boundary` 各说各话。
+默认每镜一张首帧，冻结 `start_boundary`。交付工作流需要首尾帧时，再补一张投影
+`end_boundary` 的尾帧；两帧之间的运动仍按分镜边界和运动提示词实现。
 
-**`structural_invariant`**：关键帧记录必须声明 `boundary_role`（`start` 或 `end`），
-`boundary_ref` 指向同一镜头对应的那个边界字段。**尾帧是 `end_boundary` 的投影，
+**`structural_invariant`**：《分镜.md》的首帧与收尾关键帧分别指向同一镜头已接受的起点与终点。
+**尾帧是 `end_boundary` 的投影，
 不是新的终点事实**——它与首帧对 `start_boundary` 的关系完全一样：可以决定这一帧怎么构图、
 用什么景别镜头、光怎么落，不能决定人在哪、手里有什么、看着谁。尾帧与镜头终点不一致时，
 错的是尾帧。
@@ -125,16 +120,16 @@ instead of inventing a hidden candidate state.
 from the boundary that frame declares. 首帧写进任何由运动或终点首次产生的事实是漂移；
 尾帧写进在它之前就已经消耗掉的事实同样是漂移。两帧各守各的边界，不互相借用。
 
-Keyframe 默认是 shot start，不是“本镜最有戏的时刻”。为避免把 end 提前：
+关键帧默认投影镜头起点，不能直接选取“本镜最有戏的时刻”。为避免提前写入终点事实：
 
 1. 先明确本帧冻结 `SHOT-...` 的起点，草拟正文时暂不读终点与运动描述；
-2. 只填 start 已成立的 position/pose/gaze/hands/held props/visible state；
-3. 再与 end 做“新出现事实”差集；差集中的事实不得出现在 keyframe prompt；
+2. 只填起点已成立的位置、姿态、目光、双手、持物和可见状态；
+3. 再对照终点，找出动作后才产生的事实，确保它们未进入起始关键帧正文；
 4. 写完 Markdown 后从自然语言反向提取手位、持物、目光和可见状态，与镜头起点再比一次；
    不能只看条目说明而忽略真正交付的正文。
 
 反例：start 是“右手空置、看对方”，end 是“右手握铃绳、看门”。冻结帧写
-“手已握铃绳”即使很好看，也属于 boundary drift。
+“手已握铃绳”会提前写入终点事实，属于边界漂移。
 
 ## Static test
 

package/lib/drama/skills/short-drama-storyboard/references/lighting-craft.md

@@ -24,7 +24,7 @@
 > 主光来自画面左侧；画面左侧脸颊较亮，另一侧留柔和阴影，眼睛仍可辨认。
 
 仅写「电影感、氛围感强」不足以决定画面。一次图片模型对照中，描述受光结果比只写
-光位更稳定；这可以作为起步写法，不能据此保证其他模型或视频同样执行。
+光位更稳定，可作为起步写法；其他模型和视频结果仍需检查。
 暗部深度、边缘亮光和背景亮度按本镜需要写，不把例子中的效果全部照搬。
 
 ## 参考板与跨镜连续性