@oh-story/dsh 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +5 -3
  2. package/lib/client.js +20 -11
  3. package/lib/client.js.map +2 -2
  4. package/lib/drama/manifest.json +141 -136
  5. package/lib/drama/skills/short-drama/SKILL.md +55 -122
  6. package/lib/drama/skills/short-drama/references/audience-reveal.md +14 -67
  7. package/lib/drama/skills/short-drama/references/contract-and-ownership.md +24 -78
  8. package/lib/drama/skills/short-drama/references/creator-documents.md +79 -0
  9. package/lib/drama/skills/short-drama/references/creator-workflow.md +51 -77
  10. package/lib/drama/skills/short-drama/references/knowhow-index.md +2 -0
  11. package/lib/drama/skills/short-drama/references/look-development.md +2 -3
  12. package/lib/drama/skills/short-drama/references/pickup-and-alternate.md +14 -48
  13. package/lib/drama/skills/short-drama/references/production-form-profiles.md +1 -1
  14. package/lib/drama/skills/short-drama/references/reference-roles.md +29 -135
  15. package/lib/drama/skills/short-drama/references/runtime-preflight.md +13 -19
  16. package/lib/drama/skills/short-drama-assets/SKILL.md +40 -161
  17. package/lib/drama/skills/short-drama-assets/references/asset-review-checklist.md +18 -25
  18. package/lib/drama/skills/short-drama-assets/references/character-and-look.md +13 -15
  19. package/lib/drama/skills/short-drama-assets/references/continuity-delta.md +11 -14
  20. package/lib/drama/skills/short-drama-assets/references/identity-vs-variant.md +5 -12
  21. package/lib/drama/skills/short-drama-assets/references/occurrence-extraction.md +8 -11
  22. package/lib/drama/skills/short-drama-assets/references/prop-and-state.md +2 -2
  23. package/lib/drama/skills/short-drama-assets/references/stage-contract.md +10 -105
  24. package/lib/drama/skills/short-drama-assets/references/voice-direction.md +12 -32
  25. package/lib/drama/skills/short-drama-image-prompts/SKILL.md +41 -155
  26. package/lib/drama/skills/short-drama-image-prompts/references/character-and-look.md +12 -13
  27. package/lib/drama/skills/short-drama-image-prompts/references/common-recipe.md +10 -12
  28. package/lib/drama/skills/short-drama-image-prompts/references/edit-and-revision.md +39 -51
  29. package/lib/drama/skills/short-drama-image-prompts/references/location-plate.md +3 -4
  30. package/lib/drama/skills/short-drama-image-prompts/references/look-and-state-variant.md +15 -14
  31. package/lib/drama/skills/short-drama-image-prompts/references/lookdev-frame.md +11 -15
  32. package/lib/drama/skills/short-drama-image-prompts/references/production-sheet-recipes.md +1 -1
  33. package/lib/drama/skills/short-drama-image-prompts/references/prop-plate.md +4 -7
  34. package/lib/drama/skills/short-drama-image-prompts/references/review-and-fixtures.md +23 -23
  35. package/lib/drama/skills/short-drama-image-prompts/references/stage-contract.md +6 -65
  36. package/lib/drama/skills/short-drama-produce/SKILL.md +26 -10
  37. package/lib/drama/skills/short-drama-review/SKILL.md +61 -123
  38. package/lib/drama/skills/short-drama-review/references/anti-template-repair.md +10 -15
  39. package/lib/drama/skills/short-drama-review/references/production-quality-gates.md +15 -16
  40. package/lib/drama/skills/short-drama-review/references/project-calibration.md +7 -9
  41. package/lib/drama/skills/short-drama-review/references/review-method.md +8 -9
  42. package/lib/drama/skills/short-drama-review/references/rubric-assets-prompts.md +9 -13
  43. package/lib/drama/skills/short-drama-review/references/rubric-story-script.md +104 -4
  44. package/lib/drama/skills/short-drama-review/references/rubric-visual-motion.md +15 -19
  45. package/lib/drama/skills/short-drama-review/references/stage-contract.md +4 -63
  46. package/lib/drama/skills/short-drama-storyboard/SKILL.md +49 -240
  47. package/lib/drama/skills/short-drama-storyboard/references/blocking-playbooks.md +9 -34
  48. package/lib/drama/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md +156 -0
  49. package/lib/drama/skills/short-drama-storyboard/references/coverage-audition.md +5 -10
  50. package/lib/drama/skills/short-drama-storyboard/references/keyframe-craft.md +8 -7
  51. package/lib/drama/skills/short-drama-storyboard/references/review-and-fixtures.md +24 -62
  52. package/lib/drama/skills/short-drama-storyboard/references/scene-visual-plan.md +16 -25
  53. package/lib/drama/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md +5 -23
  54. package/lib/drama/skills/short-drama-storyboard/references/shot-craft.md +8 -10
  55. package/lib/drama/skills/short-drama-storyboard/references/shot-revision-identity.md +9 -13
  56. package/lib/drama/skills/short-drama-storyboard/references/stage-contract.md +11 -71
  57. package/lib/drama/skills/short-drama-video-prompts/SKILL.md +44 -219
  58. package/lib/drama/skills/short-drama-video-prompts/references/camera-audio-continuity.md +10 -8
  59. package/lib/drama/skills/short-drama-video-prompts/references/delivery-profile.md +3 -5
  60. package/lib/drama/skills/short-drama-video-prompts/references/generability.md +2 -2
  61. package/lib/drama/skills/short-drama-video-prompts/references/motion-recipe.md +13 -23
  62. package/lib/drama/skills/short-drama-video-prompts/references/performance-action-timing.md +8 -11
  63. package/lib/drama/skills/short-drama-video-prompts/references/production-prompt-grammar.md +2 -3
  64. package/lib/drama/skills/short-drama-video-prompts/references/review-and-fixtures.md +34 -63
  65. package/lib/drama/skills/short-drama-video-prompts/references/stage-contract.md +13 -72
  66. package/lib/drama/skills/short-drama-write/SKILL.md +73 -268
  67. package/lib/drama/skills/short-drama-write/references/dialogue-craft.md +7 -0
  68. package/lib/drama/skills/short-drama-write/references/scene-handoff-capsule.md +17 -43
  69. package/lib/drama/skills/short-drama-write/references/screenplay-format.md +15 -15
  70. package/lib/drama/skills/short-drama-write/references/script-craft.md +208 -21
  71. package/lib/drama/skills/short-drama-write/references/stage-contract.md +11 -70
  72. package/lib/index.js +107 -14
  73. package/lib/index.js.map +4 -4
  74. package/lib/oh-story/manifest.json +26 -26
  75. package/lib/oh-story/roles/character-designer.md +4 -4
  76. package/lib/oh-story/roles/narrative-writer.md +11 -11
  77. package/lib/oh-story/roles/story-architect.md +20 -14
  78. package/lib/oh-story/roles/story-explorer.md +8 -5
  79. package/lib/oh-story/skills/story-import/SKILL.md +5 -1
  80. package/lib/oh-story/skills/story-import/references/structure-mapping-long.md +1 -1
  81. package/lib/oh-story/skills/story-long-write/references/artifact-protocols.md +1 -1
  82. package/lib/oh-story/skills/story-long-write/references/outline-structure-theory.md +1 -1
  83. package/lib/oh-story/skills/story-long-write/references/workflow-chapter.md +1 -1
  84. package/lib/oh-story/skills/story-long-write/references/workflow-daily.md +1 -0
  85. package/lib/oh-story/skills/story-long-write/references/workflow-setup.md +11 -5
  86. package/lib/oh-story/skills/story-setup/SKILL.md +12 -9
  87. package/lib/types/client/file-activity.d.ts +5 -0
  88. package/lib/types/client/file-activity.d.ts.map +1 -1
  89. package/lib/types/client/index.d.ts.map +1 -1
  90. package/lib/types/index.d.ts +2 -1
  91. package/lib/types/index.d.ts.map +1 -1
  92. package/lib/types/reference-tool.d.ts +6 -0
  93. package/lib/types/reference-tool.d.ts.map +1 -0
  94. package/lib/types/role-provider.d.ts.map +1 -1
  95. package/lib/types/role-tool.d.ts +3 -1
  96. package/lib/types/role-tool.d.ts.map +1 -1
  97. package/lib/types/skill-provider.d.ts.map +1 -1
  98. package/package.json +3 -2
  99. package/lib/drama/skills/short-drama/references/lifecycle-commands.md +0 -130
@@ -18,7 +18,7 @@
18
18
 
19
19
  ## 一、先分清什么问题必须阻断
20
20
 
21
- - `structural_invariant`:引用、哈希、明确时长、同一区间摄影机指令冲突、已声明
21
+ - `structural_invariant`:可见引用、明确时长、同一区间摄影机指令冲突、已声明
22
22
  起点/终点不一致等可以直接证明的问题;本地检查可以阻断。
23
23
  - `reviewed_invariant`:剧情意义是否丢失、人物反应是否承接后果、动作是否可执行、
24
24
  指令是否被改写;审查者引用资料给 `REVISE`。
@@ -38,7 +38,7 @@
38
38
 
39
39
  检查:
40
40
 
41
- - 原文覆盖表是否为每个制作相关段落说明去向;
41
+ - 是否能从剧本的每个制作相关段落直接追到承担它的镜头或声音;
42
42
  - 每个有明确来源的动作是否只实现一次;
43
43
  - 关键结果落地后,观众是否能看到受影响者的反应或后果;
44
44
  - 重新编组前后,原文段落、镜头目的、起点/终点与声音引用是否仍相同。
@@ -55,7 +55,7 @@
55
55
  先核对负责环节的起止边界和资产版本;若剧情确实需要变化,向对应技能
56
56
  请求状态或镜头修改,不在提示词里偷偷补故事。
57
57
 
58
- 选择性环境变换还要核对 `VID-11`:触发、准确目标范围、结束几何/状态与 `preserve_set`
58
+ 选择性环境变换还要核对 `VID-11`:触发、准确目标范围、结束几何/状态与保持项
59
59
  是否同时存在;相邻但非目标的人物、道具、文字承载面和空间锚点是否保持原位置、数量与
60
60
  状态。只写“门消失”“地面折叠”而不写留下什么及什么必须不变,属于无法确认能否执行的问题。
61
61
 
@@ -79,14 +79,14 @@
79
79
 
80
80
  ### 6. 版本和执行状态冒充内容权威
81
81
 
82
- 同一集、镜头或提示词可能保留多个历史版本。审查前先沿 `sources` 声明的 owner、artifact、
83
- 引用的 record ID 解析**当前权威版本**;文件更新时间、编号大小、默认展示项或最近一次执行状态
84
- 只能帮助定位候选,不能替代 creator acceptance。下游引用旧版本时,即使内容看似合理也要
85
- 先报告 stale binding,而不是把旧稿重新解释成现行要求。
82
+ 同一集、镜头或提示词可能保留多个历史版本。审查前先读取当前 creator-visible 文档,并按文件名、
83
+ 标题 ID 和文中明确写出的母版/替代关系判断当前版本;文件更新时间、编号大小、默认展示项或最近一次
84
+ 执行状态只能帮助定位,不能替代创作者当前决定。下游仍引用旧标题时,即使内容看似合理也要报告
85
+ 版本引用过期,而不是把旧稿重新解释成现行要求。
86
86
 
87
87
  生成或处理任务的技术状态只说明某次执行结束到哪一步,不证明语义质量。任何状态为成功的
88
- 历史记录都必须写明当时准确的提示词记录、资产/镜头 refs 与配置;审查仍比较这些文字是否
89
- 覆盖当前 accepted artifact。没有看过媒体时,不得从技术状态、重试次数或结果地址声称画面、
88
+ 历史记录都必须写明当时准确的提示词标题、资产/镜头引用与配置;审查仍比较这些文字是否
89
+ 覆盖当前创作者可见文档。没有看过媒体时,不得从技术状态、重试次数或结果地址声称画面、
90
90
  表演、文字和连续性已经正确。
91
91
 
92
92
  ## 三、指令优先级与改写回归(REV-09)
@@ -126,11 +126,10 @@
126
126
  不能证明提示词覆盖了原动作、反应、台词与已确认的项目指令。审查者必须比较
127
127
  改写前后必须保留的内容。
128
128
 
129
- 缩短修改若形成补拍或替代版,必须在 `coverage_scope` 标明 `pickup/alternate`、同一文件内
130
- 的母版或补充运动记录 ID,并把每项原文要求对应到当前运动字段或说明去向。普通母版省略
131
- `coverage_scope`,不为“没有版本关系”制造占位账目。
132
- 补拍默认不替代母版;替代版只能提出替代请求,最终决定由下游审查结论
133
- 指名替代版或母版的记录,不能回写运动规格制造循环引用。若有内容丢失,再由
129
+ 缩短修改若形成补拍或替代版,必须在 `视频提示词.md` 中标明版本类型、同一文件内的母版或补充
130
+ `MOTION-...` 标题,并把每项原文要求对应到当前版本或说明去向。普通母版不为“没有版本关系”制造
131
+ 占位账目。补拍默认不替代母版;替代版只能提出替代请求,最终由审查结论直接指名保留哪一个标题,
132
+ 不能让两个版本互相声明对方才是当前版本。若有内容丢失,再由
134
133
  分镜或视频提示词技能决定保留其他镜头、拆镜、延长、删减或请求上游修改。
135
134
 
136
135
  ## 四、各环节证据问题
@@ -155,8 +154,8 @@
155
154
  `no-text` 删除参考像素?
156
155
  - 每张参考图的 `role`、可参考内容与不可照搬内容是否明确?构图、尺度或效果参考有没有
157
156
  改写本来不该由它决定的身份、内容、文字或状态?
158
- - 像素、文字、水印或裁切检查是否有准确的观察记录;没有时是否保持 `unverified`,
159
- 而不是从 JSON 引用或负面词推断已经看过输入参考图?
157
+ - 像素、文字、水印或裁切检查是否有准确的观察记录;没有时是否明确写“未观察”,
158
+ 而不是从文件引用或负面词推断已经看过输入参考图?
160
159
  - 定点修改是否写准确目标、`changes` 与 `preserve_set`?
161
160
  - 同一地点在同一时间/天气 state 下的各观察方向板,主光来源、冷暖主次、光比方向与实际
162
161
  灯具开关是否对齐(`IMG-10`)?不一致时是否有已记录的成因与对应 delta?逐板单独看
@@ -9,15 +9,13 @@
9
9
  - `generated_result`:某个准确提示词/规格版本、参考槽位集合和制作配置下的结果观察;它可以支持
10
10
  项目内校准,但不能自动变成跨项目、跨配置或跨制作方式的定律。
11
11
 
12
- 两种记录都要写明被观察的媒体、观察方法、准确文本 refs、观察区域/时间段、限制与观察者。
13
- `generated_result` 还要绑定 `prompt_or_spec_refs`、每个稳定 `slot_id/order`、production profile
14
- 与 `valid_only_for`。模板见核心的生产观察记录;审查只读取项目提供的记录,不在公开运行时找数据。
15
- `evidence_state: active` 只表示这份有界观察仍可作为证据使用,不表示内容被接受或质量通过;
16
- 证据被撤回、被观察的媒体已经换过或来源无法复核时,不沿用该记录做校准,而是保留历史并另记失效原因。
17
- 不要给观察套用创作产物的 `candidate/accepted` 状态。
18
- 实际项目记录建议放在受保护的 `输入/production-observations.jsonl`(legacy 项目为
19
- `inputs/production-observations.jsonl`),由创作者或获授权观察者提供;它不属于任何 skill 的
20
- 可发布产物,也不进入文本交付包。公共 `assets/production-observation.example.jsonl` 只是空白示例。
12
+ 两种记录都要写明被观察的媒体、观察方法、准确的文档标题引用、观察区域/时间段、限制与观察者。
13
+ 生成结果还要写明对应提示词或镜头标题、参考图顺序、制作形态/配置和结论适用范围。审查只读取
14
+ 项目提供的记录,不在公开运行时找数据。记录仍可使用只代表这份有界观察可复核,不表示创作内容
15
+ 已接受或质量通过;证据被撤回、媒体已经换过或来源无法复核时,不沿用它做校准,并写明失效原因。
16
+
17
+ 实际项目记录可以由创作者放在受保护的 `原始资料/生产观察.md`,也可以直接在当前请求中提供;它不属于
18
+ 五份单集创作文档,也不进入文本交付包。
21
19
 
22
20
  ## 选择有内容代表性的试跑
23
21
 
@@ -19,9 +19,9 @@
19
19
 
20
20
  ## Review scope
21
21
 
22
- Start from the current artifact files and accepted creator constraints. Prefer an uninvolved reviewer or isolated
23
- context when available; otherwise perform an honest self-check. The project CLI stores only a verdict, optional
24
- reviewer label and note. It does not authenticate reviewer identity or require runtime provenance.
22
+ Start from the current creator-visible files and the constraints the creator has explicitly chosen. Prefer an
23
+ uninvolved reviewer or isolated context when available; otherwise perform an honest self-check and say so in the
24
+ review Markdown. A reviewer label is disclosure, not authenticated identity.
25
25
 
26
26
  If a target changes during review, reread that target before recording the verdict. Do not recursively invalidate
27
27
  unrelated findings.
@@ -30,11 +30,11 @@ unrelated findings.
30
30
 
31
31
  Mechanical examples:
32
32
 
33
- - invalid JSON/JSONL, missing or duplicate IDs, unresolved references;
33
+ - missing or duplicate Markdown IDs, broken links or unresolved references;
34
34
  - unknown asset variants or contradictory camera flags;
35
35
  - explicit segments not matching their declared duration;
36
36
  - readable text conflicting with the accepted text policy;
37
- - owner writing outside its authority;
37
+ - a stage document silently taking over facts owned by another document;
38
38
  - delivery containing private or unapproved material.
39
39
 
40
40
  Semantic examples:
@@ -51,7 +51,7 @@ Semantic examples:
51
51
  A useful finding contains:
52
52
 
53
53
  1. stable diagnostic/rule ID when one exists;
54
- 2. project-relative target plus record, field, block or shot when useful;
54
+ 2. project-relative file plus heading ID, line number or shot when useful;
55
55
  3. bounded quotation or conflicting facts;
56
56
  4. audience, continuity or production impact;
57
57
  5. required outcome and preserve set, not ghostwritten replacement prose;
@@ -60,9 +60,8 @@ A useful finding contains:
60
60
  “The dialogue is weak” is invalid. A finding should identify the exact exchange, say what fails to change, and tell
61
61
  the write owner what outcome must be restored.
62
62
 
63
- A findings or verdict file declares each upstream snapshot once under `sources`, and every reference names that
64
- snapshot key plus the record. Those source references are archival review metadata, not lifecycle inputs and not proof
65
- of reviewer independence.
63
+ The review Markdown cites the current file name, heading ID, line number or a necessary short quotation directly.
64
+ It does not copy upstream snapshots, invent record IDs or create another version of the source material.
66
65
 
67
66
  ## Cross-layer synthesis
68
67
 
@@ -26,32 +26,28 @@ creator-approved idealization or deliberate counter-casting remains a taste choi
26
26
 
27
27
  ### Voice direction (optional, `AST-07`–`AST-12`)
28
28
 
29
- Only reviewed when a project records `voice_direction`. Timbre is carried by a
30
- bound reference recording, not by prose: identity is the reference binding plus
31
- the accepted pronunciations, and the text alongside it exists to select or judge
32
- a candidate, never to stand in for one.
29
+ Only reviewed when `视觉设定.md` records a voice direction. Timbre is carried by a
30
+ named reference recording, not by prose: identity is the reference plus the
31
+ creator's current pronunciation choices, and the text alongside it exists to
32
+ select or judge a voice, never to stand in for one.
33
33
 
34
34
  Fail when:
35
35
 
36
36
  - a project has no reference and a paragraph of adjectives is standing in for
37
- identity — that record must read `reference: null` and 待选型 instead;
37
+ identity — the voice section must say `待选型` instead;
38
38
  - a binding omits what it controls and what it must not, or lets the take's
39
39
  emotion, the recording space (reverb, mic distance) or background noise into
40
40
  identity (`AST-08`);
41
41
  - a claim about what is audible in a reference has no creator description and no
42
- authorized listening observation, yet admission is not `unverified` (`AST-09`);
43
- - one proper noun appears with two accepted spellings anywhere in the 设定集
42
+ authorized listening observation, yet is written as established fact (`AST-09`);
43
+ - one proper noun appears with two accepted spellings anywhere in `视觉设定.md`
44
44
  (`AST-10`) — this one is structural and blocks;
45
45
  - two characters designed together are bound to confusable references and no
46
46
  distinguishing trait names the nearest neighbour (`AST-11`);
47
47
  - a selection criterion is an emotion word, carries no counter-example, or the
48
48
  list has grown past a handful (`AST-12`);
49
49
  - reference audio bytes, a provider parameter, a model name, a task field or a
50
- URL appear in the 设定集 or the delivery package.
51
-
52
- The rendered `voice-casting.md` is a cache. A finding against it is a finding
53
- against the accepted record it projects, routed to assets — never a request to
54
- hand-edit the derived text.
50
+ URL appear in `视觉设定.md` or the delivery package.
55
51
 
56
52
  ### Location / View
57
53
 
@@ -107,7 +103,7 @@ apply type-specific criteria:
107
103
  - prop has no scale or text state;
108
104
  - negative constraints contradict the required visible fact;
109
105
  - edit request says “make better” without target/change/preserve;
110
- - rendered Markdown differs from accepted structured spec;
106
+ - `图片提示词.md` contradicts the current identity, state or text policy in `视觉设定.md`;
111
107
  - private URL, source ID, provider task field, or operator complaint leaks in.
112
108
  - “use the whole reference” does not say what may or may not be copied.
113
109
 
@@ -24,9 +24,30 @@
24
24
  - What pressure is active at the opening?
25
25
  - What does the protagonist want now, and what resists it?
26
26
  - Which choice/action causes the directional turn?
27
+ - If the episode frames that turn as a consequential choice, what live value does each
28
+ executable direction protect, and what cost is newly caused by the action (`SCR-13`)?
29
+ If it is an ordinary decision or single-path pursuit, leave this test inactive rather
30
+ than manufacturing a dilemma.
31
+ - Conditional does not mean cursory: when the episode itself foregrounds a choice,
32
+ evidence carrier, deadline, or rule, does resistance, action, and consequence dramatize
33
+ it, rather than merely naming it in dialogue?
34
+ - Could a viewer identify those stakes from the screenplay alone, without access to
35
+ the upstream brief or episode card?
36
+ - Do explicit brief facts, must/forbid constraints, genre contract, and required exit state
37
+ outrank craft defaults, or did the screenplay invent precision, records, resources,
38
+ procedures, relationships, or mechanisms merely to display a rule?
39
+ - When a choice cost or deadline is essential, was it perceptible before the decision,
40
+ or invented at decision time by a convenient new condition?
27
41
  - What part of the promised experience is delivered before the outgoing hook?
28
42
  - What exact state enters the next episode?
29
43
  - Before the outgoing hook, what local dramatic result has already landed?
44
+ - Which behavior, relationship history, line, silence, spatial choice, or object makes the
45
+ protagonist's private reason legible? Do not require a recurring object when another
46
+ carrier already does the work.
47
+ - Does the ending fulfill the episode's viewing contract through consequence, relationship,
48
+ irony, afterimage, atmosphere, or intentional openness? A new external event is optional.
49
+ - If the ending declares a path closed or a consequence irreversible, do later beats
50
+ accidentally contradict that claim without presenting an intentional new change?
30
51
  - Whose choice caused that result (`STY-13`)? If it arrived by outside force, cite the
31
52
  protagonist's earlier action that made it arrive now, and what they did with it.
32
53
  A protagonist who only endures until rescue is this episode's audience, not its lead.
@@ -78,6 +99,18 @@ What is reportable:
78
99
  - Do world truth, character beliefs, and audience knowledge remain separate?
79
100
  - For each evidence carrier, what claim does it directly support, and which identity,
80
101
  cause, motive, or mechanism remains an unresolved inference (`STY-15`)?
102
+ - When a major belief change hinges on contested evidence, is the response limited to
103
+ what was proved, or does the story intentionally preserve/delay uncertainty (`SCR-14`)?
104
+ Leave this test inactive for uncontested facts, comic misunderstanding, subjective
105
+ narration, or clues whose ambiguity is the intended effect.
106
+ - When contested evidence is a primary episode engine, does at least one visible state
107
+ change alter which explanations remain live or alter the next action, rather than
108
+ leaving every increment to verbal report? Photographing, bagging, numbering, or logging
109
+ is not a dramatic turn by itself. Once the required inference changes, does testing stop
110
+ unless another live counter-explanation would genuinely change the next action?
111
+ - If a proof claim depends on continuity such as connection, sealing, position, time, or
112
+ lack of contact, did preceding action preserve that exact property? A continuity label
113
+ may carry forward a shown state; it cannot prove that an unseen event or contact never occurred.
81
114
  - Does active serial memory preserve character/relationship state, information
82
115
  permissions, setup debt, rhythm direction, and the exact physical handoff?
83
116
  - Do external pressure and emotional load rise, fall, or diverge for a reason?
@@ -88,16 +121,20 @@ dialogue quota.
88
121
 
89
122
  ## Scene test
90
123
 
91
- For each scene ask:
124
+ For a scene organized around active pursuit or conflict, ask:
92
125
 
93
126
  1. Why must it exist?
94
127
  2. Whose agenda organizes it?
95
128
  3. What force opposes that agenda?
96
- 4. What becomes visible, known, decided, owned, risked, or irreversible?
129
+ 4. What traceable fact, leverage change, cost, authority, or choice makes the prior
130
+ strategy fail? An opponent merely becoming silent or leaving is not enough.
97
131
  5. What exit state pressures the next scene?
98
132
 
99
- A quiet scene can pass when pressure and change are legible. A loud scene can fail
100
- when nothing changes.
133
+ A quiet scene can pass when pressure and change are legible. Atmospheric, ritual,
134
+ montage, transition, and consequence-processing scenes may instead justify their
135
+ function through a necessary change in knowledge, relationship, pressure, rhythm,
136
+ or production state; do not invent an opponent or strategy failure merely to make
137
+ them fit this checklist. A loud scene can fail when nothing changes.
101
138
 
102
139
  ## Action and production meaning
103
140
 
@@ -107,6 +144,42 @@ when nothing changes.
107
144
  - Are exact on-screen text, prop text, SFX, VO/OS, and transitions tagged?
108
145
  - Does prose avoid camera/prompt boilerplate while retaining production-critical
109
146
  facts?
147
+ - Do supporting characters who receive substantial dramatic emphasis have a goal, judgment,
148
+ or strategy of their own? Incidental, transactional, choral, and environmental roles need
149
+ not all alter the main plot.
150
+ - Does a central participant who supplies the main leverage, opposition, or cost remain
151
+ strategically present through the turn and response, rather than becoming a passive prop
152
+ once the protagonist acts?
153
+ - If that participant's leverage disappears, what already-established action, spatial fact,
154
+ authority, relationship, or choice made it disappear? Do not infer neutralization merely
155
+ from the protagonist completing one step.
156
+ - When a literal precise deadline is foregrounded and audience-auditable, does its action
157
+ chain fit, or does the screenplay make compression, changed method, changed objective,
158
+ or failure legible (`SCR-16`)? Qualitative urgency must not be upgraded into invented
159
+ minutes, timestamps, notifications, or records. Do not apply a real-time test to montage,
160
+ ellipsis, subjective time, or declared stylization.
161
+ - When the brief defines a limited number of attempts, turns, breaths, beats, or other units,
162
+ does each unit end with its required visible state (`SCR-17`)? Labels, counts, requests,
163
+ authorization, preparation, and cleanup after the boundary do not substitute for completion;
164
+ an intentional failure or partial result may count when it is legible at that boundary.
165
+ - When exact timestamps share one literal continuity, are they mutually consistent?
166
+ - When the current date is necessary to a conclusion, is it supported by a current source?
167
+ - Does a compressed process retain only the steps that change strategy, relationship,
168
+ risk, or result, instead of listing interchangeable operations?
169
+ - When multiple carriers repeat one pressure or fact, does each add rhythm, viewpoint,
170
+ irony, misdirection, or consequence? If not, which one is redundant?
171
+ - Does a solution use established resources and still confront the core obstacle, rather
172
+ than erase it with a newly invented convenience?
173
+ - Even when a resource is established, does it change the problem without conveniently
174
+ performing the character's hardest dramatic work for them?
175
+ - Does an outside response increase or transform pressure in a way grounded in the work's
176
+ established world, rather than suddenly forgiving, rewarding, or rescuing the character
177
+ to make the ending easy?
178
+ - After a mechanism becomes visually clear, does dialogue change the relationship or
179
+ narrow the claim instead of explaining the same mechanism again?
180
+ - When the brief gives a target duration but the project has no pacing rates, has the
181
+ writer still performed a real-time read/action pass and removed obviously excessive
182
+ repeated verification, date exposition, or equivalent closing beats?
110
183
 
111
184
  ## Dialogue
112
185
 
@@ -162,3 +235,30 @@ the benefit is not, and the mark exists precisely so the strong version can stay
162
235
  - generic emotion adjectives replace visible performance;
163
236
  - every character explains the plot in the same voice;
164
237
  - downstream production requirement was never marked in screenplay truth.
238
+ - a redundant `[连续性]` tag repeats an exit state already explicit in the final action;
239
+ - a story-critical ending state appears without a prior transition;
240
+ - the script uses atmosphere, silence, or a black frame to avoid landing a result the episode
241
+ promised, rather than as an intentional ending form;
242
+ - a beat is sold as a consequential choice after one direction has already become valueless
243
+ or impossible (`SCR-13`);
244
+ - contested evidence produces a broader conclusion than the evidence or intentionally
245
+ incomplete verification supports (`SCR-14`);
246
+ - a claimed proof relies on a continuity property the preceding action already destroyed,
247
+ or on a continuity label asserting an unseen negative event;
248
+ - a local payoff erases its established residue or replaces meaning with a slogan (`SCR-15`);
249
+ - a cost framed as central pressure automatically resets at success, leaving no material
250
+ effect on ability, body, resource, relationship, or next action;
251
+ - a central participant supplies the opening leverage or cost but becomes a passive prop
252
+ through the decisive action;
253
+ - the core opposing force disappears only because its holder becomes silent, stops acting,
254
+ or leaves, without a traceable loss of leverage, accepted cost, or changed strategy;
255
+ - a literal, audience-auditable deadline succeeds only through unexplained speed, or
256
+ qualitative urgency is upgraded into invented precise timing (`SCR-16`);
257
+ - a limited unit is counted before its required state completes, with the completion moved
258
+ outside the boundary (`SCR-17`);
259
+ - a newly invented resource, permission, or ability removes the central obstacle;
260
+ - a limited result is renamed as a broader success or truth than the scene demonstrated;
261
+ - repeated carriers restate one pressure without adding viewpoint, rhythm, irony, or consequence;
262
+ - a second same-direction decision, closing line, or maxim merely translates a change,
263
+ punchline, or metaphor that the preceding action already completed;
264
+ - post-result action unintentionally contradicts a consequence the screenplay called irreversible.
@@ -23,7 +23,7 @@
23
23
  genuinely differ — in knowledge timing, audience alignment, performance space,
24
24
  strongest image, landing, losses, or production fit?
25
25
  - Does the formal plan bind the approach the creator selected, rather than the first draft?
26
- - When a `scene_visual_plan` exists: do its start/end audience positions, spatial
26
+ - When a scene visual plan was used: do its start/end audience positions, spatial
27
27
  pressure, camera rhythm, reaction landing, and sound movement carry **one** dramatic turn?
28
28
  - Does that plan stay clear of owning shot boundaries? (Ordinary scenes need no plan
29
29
  merely to satisfy a form.)
@@ -34,7 +34,7 @@
34
34
  - Are Location/View, axis, screen direction, eyelines, entrances, positions,
35
35
  hands, and props coherent?
36
36
  - Are exact asset variants bound?
37
- - Does `audience_visibility` expose every fact this shot must carry while protecting
37
+ - Does the shot expose every fact it must carry while protecting
38
38
  facts the source withholds until a later action or cut?
39
39
  - Do crop, occlusion, focus, back view, and offscreen space serve that information
40
40
  permission rather than accidentally reveal or conceal it?
@@ -42,7 +42,7 @@
42
42
  ## Frozen keyframe
43
43
 
44
44
  - Can all described facts exist in one still instant?
45
- - Does it project the authoritative shot start boundary?
45
+ - Does it project the start state written for this shot?
46
46
  - Are focal hierarchy, composition, camera/lens, geography, pose/gaze/hands/prop,
47
47
  expression, and light legible?
48
48
  - Does it avoid ordered actions, performance arcs, camera moves, or transforming
@@ -56,15 +56,13 @@
56
56
  - In multi-character motion: do the actors who actually change have distinct,
57
57
  readable triggers, choices, leaks, or landings — as this shot needs, not one
58
58
  identical arc per actor?
59
- - Is `attention_handoffs` used only where attention truly transfers, rather than for
59
+ - Is attention handed off only where it truly transfers, rather than for
60
60
  synchronized reaction?
61
- - Does the derived text-readiness view cite accepted inputs and real blocking gaps?
62
- - Does it avoid any claim about generated media quality, and avoid persisting a second
63
- readiness truth inside each motion record?
61
+ - Does any text-readiness claim cite the current creator-visible inputs and a real blocking gap?
62
+ - Does it avoid any claim about generated media quality or create a second readiness truth?
64
63
  - Is camera behavior coherent and motivated?
65
64
  - Are environment motion, dialogue, SFX, and audio included only when relevant?
66
- - Does the end report match storyboard `end_boundary` and feed no unauthorized
67
- write into the next shot?
65
+ - Does the described end match the storyboard's written end state without rewriting the next shot?
68
66
  - When a reference frame carries appearance/composition, does motion prose avoid
69
67
  dumping the full visual 设定集?
70
68
  - Does every claim about text-bearing reference pixels cite a creator/reference-owner
@@ -78,12 +76,10 @@
78
76
 
79
77
  For a pickup or alternate, ask these separately:
80
78
 
81
- - Does `coverage_scope` bind each exact source obligation?
82
- - Is every obligation mapped to a current motion field or an explicit disposition?
83
- - Are the exact master/supplement record IDs named?
84
- - Is supersession only *requested* here? Only a downstream verdict may bind fixed
85
- alternate/master records and decide it — see the
86
- [supersession decision example](../assets/supersession-decision.example.json).
79
+ - Does the pickup/alternate name its master by visible `MOTION-...` heading?
80
+ - Is every source obligation assigned to the master, this version, another named version or a requested storyboard revision?
81
+ - Are the changed items and the items that must remain unchanged explicit?
82
+ - Is replacement only requested here? The review Markdown decides whether the master remains primary or the alternate replaces it.
87
83
 
88
84
  For music, ask these separately (`VID-14`):
89
85
 
@@ -136,7 +132,7 @@ ellipsis, dream, or deliberate disorientation.
136
132
  - every emotional beat uses the same close-up/push template;
137
133
  - provider batching is mistaken for editorial shot structure.
138
134
  - a narrowed pickup silently replaces the master and drops dialogue, reaction,
139
- reveal, end-boundary, or accepted-directive obligations.
135
+ reveal, end-state, or creator-directive obligations.
140
136
 
141
137
  ## Production-risk and authorized-observation checklist (REV-08)
142
138
 
@@ -145,9 +141,9 @@ ellipsis, dream, or deliberate disorientation.
145
141
  并把该记录作为外部证据引用。没有观察记录时保持结果未知,不从任务成功、结果地址或提示词
146
142
  存在推断成片质量。
147
143
 
148
- 需要项目校准时,先区分 `input_reference` 与 `generated_result`。后一种观察只有在绑定准确
149
- prompt/spec 记录、稳定 reference slots、production profile/config、观察方法和限制时才可引用;
150
- finding 同时给出最小 `change_set` 与 `preserve_set`,并保持结论只在该项目和版本条件下有效。
144
+ 需要项目校准时,先区分输入参考与生成结果。后一种观察只有在绑定准确的提示词/镜头标题、参考顺序、
145
+ 制作形态/配置、观察方法和限制时才可引用;finding 同时给出最小修改项与保持项,并保持结论只在该项目
146
+ 和版本条件下有效。
151
147
 
152
148
  短剧生产中需要防范的文字风险或获授权观察包括:
153
149
 
@@ -1,68 +1,9 @@
1
1
  # 审查阶段契约
2
2
 
3
- ## 目录
3
+ 本阶段只拥有审查结论与修订要求,不改写 owner 来源。需要落盘时使用创作者可读 Markdown,引用当前
4
+ 文件名、标题 ID、行号或短引文;不建立 JSON/JSONL、来源快照、哈希或接受状态。
4
5
 
5
- - [独立运行与项目集成](#独立运行与项目集成)
6
- - [所有权边界](#所有权边界)
7
- - [制作形态需要什么](#制作形态需要什么)
8
- - [参考媒体与补拍](#参考媒体与补拍)
9
- - [本阶段规则](#本阶段规则)
10
-
11
- 本文件是本技能的自包含契约:预检、所有权、形态输入与规则表都在这里,
12
- 不需要读取其他技能的文件。
13
-
14
- ## 独立运行与项目集成
15
-
16
- 本技能可以单独安装并运行;下面几条说明项目工具存在时怎样集成。
17
-
18
- 1. **读取直接输入**:只读取用户明确提供或当前任务实际需要的文件,不批量加载整个项目。
19
- 2. **可选项目集成**:若存在 `short-drama.json` 且 core 项目工具可用,可以运行
20
- `python3 <core>/scripts/project_tool.py status <project>`,使用返回的目录布局和语言设置;
21
- core 不可用时,直接基于已提供输入产出本阶段文件。
22
- 3. **可选发布生命周期**:项目工具可用时,用 `publish` 原子发布并用 `--input <path>`
23
- 声明直接输入;`accept`、`review` 与 `package` 继续承担确认、复核与交付。
24
- 4. **保持职责分离**:创作者确认、内容修订和复核是不同动作;reviewer 提修改要求,负责人改文件。
25
-
26
- ## 所有权边界
27
-
28
- - **本阶段拥有**:审查问题、审查结论与修订请求;证据指向被审查的产物与其中的准确记录。
29
- - **本阶段继承**:精确的 artifact 引用、已接受限制与创作者覆盖。
30
- - **本阶段不越权**:不修改负责人的来源文件,不用个人偏好替代证据,也不把 owner 修订动作
31
- 冒充审查动作。Self-review may record any evidence-supported verdict when it is labeled honestly.
32
- Prefer an uninvolved reviewer to reduce confirmation bias, but never retry isolation as a completion strategy.
33
-
34
- ## 制作形态需要什么
35
-
36
- 视觉风格不是贴在提示词前面的标签。创作者已接受的视觉方向与制作形态由项目层决定并传入,
37
- **本技能不加载形态卡,也不自行选择形态**;本节只说明本阶段需要形态回答什么、以及拿到
38
- 答案后投影成哪些字段。
39
-
40
- 形态决定属于 `craft_default`:创作者说明理由即可覆盖。形态不能创造新的
41
- `structural_invariant`,也不能改写身份、地理、持物归属与可读文字政策。审查者不得单凭
42
- 形态偏好阻断交付。
43
-
44
- 不要用“加一句风格前缀”处理形态差异。前缀只改变检索标签;形态改变的是**必须出现和
45
- 可以省略的字段**,只有后者会被执行,也只有后者能被审查。
46
-
47
- 本阶段对形态只问一件事:**叙事职责是否真的落到了本形态可执行的字段**——形、层、
48
- 材质、光、动作或声音。
49
-
50
- 检查时不问“有没有写风格名”,而问:连续性必带项是否按本形态取舍、而不是照抄别的形态;
51
- 同一决定是否只由一个负责人写入。已选择的形态或单镜预算不可执行时,回到对应负责人请求
52
- 批准,不把拆镜或换形态默认为已经授权的替代。
53
-
54
- ## 参考媒体与补拍
55
-
56
- - **参考图能决定什么要逐张写明**:每张参考的用途、可以照搬什么、不可以照搬什么。身份参考
57
- 不自动决定构图;构图、尺度或效果参考不自动带入图中人物、服装、文字、道具与故事状态。
58
- - **像素主张需要证据**:关于参考图上可见内容(尤其文字、水印、标牌、界面)的断言,必须
59
- 来自创作者/参考图权利人的可核对说明,或运行环境获授权后形成的输入参考观察记录,并绑定
60
- 被检查的字节。两者都没有时保持 `unverified`,负面提示词不能代替证据。
61
- - **观众揭示时机**:某一事实何时可被观众看到,由已接受的可见性决定绑定其来源、载体、
62
- 权限、触发与保护方式。构图既不能提前泄露该事实,也不能遮掉本环节必须传达的载体。
63
- - **母版、补拍与替代**:补拍默认只补充、不替代母版。普通母版不增加版本范围字段;只有
64
- 补拍/替代版才声明 `pickup | alternate`,用同一文件内稳定的记录 ID 说明母版与补充关系,并把每项原文要求对应到当前字段或说明
65
- 去向。只有下游审查结论才能批准替代,不得回写形成循环引用。
6
+ 审查可以由独立 reviewer 或明确标注的自检完成。媒体不可见时保持未知;外部生产仍需要自己的显式确认。
66
7
 
67
8
  ## 本阶段规则
68
9
 
@@ -71,7 +12,7 @@
71
12
  | ID | Class | Knowledge |
72
13
  |---|---|---|
73
14
  | REV-01 | structural_invariant | Run mechanical checks before spending creative review attention. |
74
- | REV-02 | structural_invariant | A finding binds its target through the file's `sources` declaration (`src` plus record), and includes evidence, impact, required fix, owner, severity, and status. |
15
+ | REV-02 | structural_invariant | A finding names a visible file and heading/shot/prompt ID, and includes evidence, impact, required fix, owner, severity and status. |
75
16
  | REV-03 | reviewed_invariant | Semantic invention cites the source fact and conflicting downstream fact. |
76
17
  | REV-04 | craft_default | Prefer a reviewer who did not author the current targets; disclose self-review, and keep reviewer findings separate from owner edits. |
77
18
  | REV-05 | craft_default | Diagnose repeated structure or generic language with location and impact; do not label output merely "AI-ish". |