@lemoncat7/dsh-partner 2.4.2 → 2.7.0

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 (671) hide show
  1. package/README.md +8 -0
  2. package/docs/THIRD_PARTY_LICENSES.md +13 -0
  3. package/docs/attachment-storage.md +18 -0
  4. package/docs/director-skills.md +24 -0
  5. package/docs/long-task-continuation.md +51 -0
  6. package/docs/releases/2.5.0.md +13 -0
  7. package/docs/releases/2.6.0.md +11 -0
  8. package/docs/releases/2.7.0.md +21 -0
  9. package/lib/agent-runtime.d.ts +9 -1
  10. package/lib/agent-runtime.d.ts.map +1 -1
  11. package/lib/agent-runtime.js +117 -17
  12. package/lib/agent-runtime.js.map +1 -1
  13. package/lib/api/features/attachments-api.d.ts.map +1 -1
  14. package/lib/api/features/attachments-api.js +31 -1
  15. package/lib/api/features/attachments-api.js.map +1 -1
  16. package/lib/api.d.ts +1 -1
  17. package/lib/api.d.ts.map +1 -1
  18. package/lib/api.js +1 -1
  19. package/lib/api.js.map +1 -1
  20. package/lib/attachments/grouped-storage.d.ts +5 -0
  21. package/lib/attachments/grouped-storage.d.ts.map +1 -0
  22. package/lib/attachments/grouped-storage.js +47 -0
  23. package/lib/attachments/grouped-storage.js.map +1 -0
  24. package/lib/attachments/service.d.ts +17 -0
  25. package/lib/attachments/service.d.ts.map +1 -1
  26. package/lib/attachments/service.js +100 -8
  27. package/lib/attachments/service.js.map +1 -1
  28. package/lib/attachments/shared-storage.d.ts +7 -0
  29. package/lib/attachments/shared-storage.d.ts.map +1 -0
  30. package/lib/attachments/shared-storage.js +44 -0
  31. package/lib/attachments/shared-storage.js.map +1 -0
  32. package/lib/attachments/storage-admin.d.ts +6 -0
  33. package/lib/attachments/storage-admin.d.ts.map +1 -0
  34. package/lib/attachments/storage-admin.js +43 -0
  35. package/lib/attachments/storage-admin.js.map +1 -0
  36. package/lib/attachments/storage-types.d.ts +33 -0
  37. package/lib/attachments/storage-types.d.ts.map +1 -0
  38. package/lib/attachments/storage-types.js +2 -0
  39. package/lib/attachments/storage-types.js.map +1 -0
  40. package/lib/attachments/tool.d.ts.map +1 -1
  41. package/lib/attachments/tool.js +16 -5
  42. package/lib/attachments/tool.js.map +1 -1
  43. package/lib/channels/delivery-policy.d.ts.map +1 -1
  44. package/lib/channels/delivery-policy.js +7 -4
  45. package/lib/channels/delivery-policy.js.map +1 -1
  46. package/lib/channels/direct/message-format.js +418 -281
  47. package/lib/channels/direct/message-format.js.map +4 -4
  48. package/lib/channels/manager.d.ts +7 -3
  49. package/lib/channels/manager.d.ts.map +1 -1
  50. package/lib/channels/manager.js +73 -38
  51. package/lib/channels/manager.js.map +1 -1
  52. package/lib/channels/weixin/api.d.ts.map +1 -1
  53. package/lib/channels/weixin/api.js +7 -2
  54. package/lib/channels/weixin/api.js.map +1 -1
  55. package/lib/channels/weixin/errors.d.ts +14 -0
  56. package/lib/channels/weixin/errors.d.ts.map +1 -0
  57. package/lib/channels/weixin/errors.js +29 -0
  58. package/lib/channels/weixin/errors.js.map +1 -0
  59. package/lib/channels/weixin/poll.d.ts +14 -0
  60. package/lib/channels/weixin/poll.d.ts.map +1 -0
  61. package/lib/channels/weixin/poll.js +50 -0
  62. package/lib/channels/weixin/poll.js.map +1 -0
  63. package/lib/client-api.d.ts +1 -23
  64. package/lib/client-api.d.ts.map +1 -1
  65. package/lib/client-api.js.map +1 -1
  66. package/lib/client-controller.d.ts.map +1 -1
  67. package/lib/client-controller.js +3 -3
  68. package/lib/client-controller.js.map +1 -1
  69. package/lib/client.d.ts.map +1 -1
  70. package/lib/client.js +1078 -679
  71. package/lib/client.js.map +4 -4
  72. package/lib/collaboration/composition.d.ts.map +1 -1
  73. package/lib/collaboration/composition.js +32 -8
  74. package/lib/collaboration/composition.js.map +1 -1
  75. package/lib/collaboration/domain.d.ts +8 -0
  76. package/lib/collaboration/domain.d.ts.map +1 -1
  77. package/lib/collaboration/domain.js.map +1 -1
  78. package/lib/collaboration/service.d.ts.map +1 -1
  79. package/lib/collaboration/service.js +38 -5
  80. package/lib/collaboration/service.js.map +1 -1
  81. package/lib/concern-notification.d.ts.map +1 -1
  82. package/lib/concern-notification.js +2 -1
  83. package/lib/concern-notification.js.map +1 -1
  84. package/lib/concern-tool.js +1 -1
  85. package/lib/concern-tool.js.map +1 -1
  86. package/lib/execution/reply-progress.d.ts.map +1 -1
  87. package/lib/execution/reply-progress.js +4 -2
  88. package/lib/execution/reply-progress.js.map +1 -1
  89. package/lib/execution/service.d.ts +1 -1
  90. package/lib/execution/service.d.ts.map +1 -1
  91. package/lib/execution/service.js +4 -7
  92. package/lib/execution/service.js.map +1 -1
  93. package/lib/index.d.ts.map +1 -1
  94. package/lib/index.js +7 -1
  95. package/lib/index.js.map +1 -1
  96. package/lib/memory-reflection.js +2 -2
  97. package/lib/memory-reflection.js.map +1 -1
  98. package/lib/message-source.d.ts +25 -0
  99. package/lib/message-source.d.ts.map +1 -0
  100. package/lib/message-source.js +8 -0
  101. package/lib/message-source.js.map +1 -0
  102. package/lib/observation-loop.js +4 -4
  103. package/lib/observation-loop.js.map +1 -1
  104. package/lib/pendant/reader.js +1 -1
  105. package/lib/pendant/reader.js.map +1 -1
  106. package/lib/pendant/settings-panel.js +1 -1
  107. package/lib/pendant/settings-panel.js.map +1 -1
  108. package/lib/persona/service.js +1 -1
  109. package/lib/persona/service.js.map +1 -1
  110. package/lib/requirements/attachments.d.ts +7 -0
  111. package/lib/requirements/attachments.d.ts.map +1 -0
  112. package/lib/requirements/attachments.js +26 -0
  113. package/lib/requirements/attachments.js.map +1 -0
  114. package/lib/requirements/domain.d.ts +1 -1
  115. package/lib/requirements/domain.d.ts.map +1 -1
  116. package/lib/requirements/service.d.ts.map +1 -1
  117. package/lib/requirements/service.js +4 -1
  118. package/lib/requirements/service.js.map +1 -1
  119. package/lib/scheduler/channel-origin.d.ts +7 -0
  120. package/lib/scheduler/channel-origin.d.ts.map +1 -0
  121. package/lib/scheduler/channel-origin.js +27 -0
  122. package/lib/scheduler/channel-origin.js.map +1 -0
  123. package/lib/scheduler/continuations.d.ts +29 -0
  124. package/lib/scheduler/continuations.d.ts.map +1 -0
  125. package/lib/scheduler/continuations.js +286 -0
  126. package/lib/scheduler/continuations.js.map +1 -0
  127. package/lib/scheduler/domain.d.ts +40 -0
  128. package/lib/scheduler/domain.d.ts.map +1 -1
  129. package/lib/scheduler/final-reply.d.ts +13 -0
  130. package/lib/scheduler/final-reply.d.ts.map +1 -0
  131. package/lib/scheduler/final-reply.js +21 -0
  132. package/lib/scheduler/final-reply.js.map +1 -0
  133. package/lib/scheduler/service.d.ts +2 -0
  134. package/lib/scheduler/service.d.ts.map +1 -1
  135. package/lib/scheduler/service.js +30 -1
  136. package/lib/scheduler/service.js.map +1 -1
  137. package/lib/scheduler/wakeup-context.d.ts +7 -0
  138. package/lib/scheduler/wakeup-context.d.ts.map +1 -0
  139. package/lib/scheduler/wakeup-context.js +14 -0
  140. package/lib/scheduler/wakeup-context.js.map +1 -0
  141. package/lib/scheduler/wakeup.d.ts +11 -0
  142. package/lib/scheduler/wakeup.d.ts.map +1 -0
  143. package/lib/scheduler/wakeup.js +52 -0
  144. package/lib/scheduler/wakeup.js.map +1 -0
  145. package/lib/skills/builtin-resources.d.ts +6 -0
  146. package/lib/skills/builtin-resources.d.ts.map +1 -0
  147. package/lib/skills/builtin-resources.js +47 -0
  148. package/lib/skills/builtin-resources.js.map +1 -0
  149. package/lib/skills/builtin.d.ts +2 -5
  150. package/lib/skills/builtin.d.ts.map +1 -1
  151. package/lib/skills/builtin.js +11 -0
  152. package/lib/skills/builtin.js.map +1 -1
  153. package/lib/skills/director-builtins.d.ts +8 -0
  154. package/lib/skills/director-builtins.d.ts.map +1 -0
  155. package/lib/skills/director-builtins.js +65 -0
  156. package/lib/skills/director-builtins.js.map +1 -0
  157. package/lib/skills/drama-builtin.d.ts +3 -0
  158. package/lib/skills/drama-builtin.d.ts.map +1 -0
  159. package/lib/skills/drama-builtin.js +49 -0
  160. package/lib/skills/drama-builtin.js.map +1 -0
  161. package/lib/skills/long-task-continuation.d.ts +4 -0
  162. package/lib/skills/long-task-continuation.d.ts.map +1 -0
  163. package/lib/skills/long-task-continuation.js +43 -0
  164. package/lib/skills/long-task-continuation.js.map +1 -0
  165. package/lib/skills/service.d.ts.map +1 -1
  166. package/lib/skills/service.js +8 -3
  167. package/lib/skills/service.js.map +1 -1
  168. package/lib/skills/viora-canvas-builtin.d.ts +3 -0
  169. package/lib/skills/viora-canvas-builtin.d.ts.map +1 -0
  170. package/lib/skills/viora-canvas-builtin.js +19 -0
  171. package/lib/skills/viora-canvas-builtin.js.map +1 -0
  172. package/lib/storage/migrate-layout.d.ts.map +1 -1
  173. package/lib/storage/migrate-layout.js +13 -4
  174. package/lib/storage/migrate-layout.js.map +1 -1
  175. package/lib/store.d.ts.map +1 -1
  176. package/lib/store.js +2 -0
  177. package/lib/store.js.map +1 -1
  178. package/lib/tasks/context.js +1 -0
  179. package/lib/tasks/context.js.map +1 -1
  180. package/lib/tasks/continuation-yield.d.ts +4 -0
  181. package/lib/tasks/continuation-yield.d.ts.map +1 -0
  182. package/lib/tasks/continuation-yield.js +27 -0
  183. package/lib/tasks/continuation-yield.js.map +1 -0
  184. package/lib/tasks/continuation.d.ts +13 -0
  185. package/lib/tasks/continuation.d.ts.map +1 -0
  186. package/lib/tasks/continuation.js +106 -0
  187. package/lib/tasks/continuation.js.map +1 -0
  188. package/lib/tasks/domain.d.ts +2 -0
  189. package/lib/tasks/domain.d.ts.map +1 -1
  190. package/lib/tasks/scheduling.d.ts.map +1 -1
  191. package/lib/tasks/scheduling.js +7 -0
  192. package/lib/tasks/scheduling.js.map +1 -1
  193. package/lib/tasks/service.d.ts +2 -1
  194. package/lib/tasks/service.d.ts.map +1 -1
  195. package/lib/tasks/service.js +19 -1
  196. package/lib/tasks/service.js.map +1 -1
  197. package/lib/ui/attachment-storage.d.ts +2 -0
  198. package/lib/ui/attachment-storage.d.ts.map +1 -0
  199. package/lib/ui/attachment-storage.js +59 -0
  200. package/lib/ui/attachment-storage.js.map +1 -0
  201. package/lib/ui/capability-editor.js +1 -1
  202. package/lib/ui/capability-editor.js.map +1 -1
  203. package/lib/ui/companion-access-panel.js +1 -1
  204. package/lib/ui/companion-access-panel.js.map +1 -1
  205. package/lib/ui/companion-create.js +1 -1
  206. package/lib/ui/companion-create.js.map +1 -1
  207. package/lib/ui/companion-picker.js +1 -1
  208. package/lib/ui/companion-picker.js.map +1 -1
  209. package/lib/ui/identity-editor.js +1 -1
  210. package/lib/ui/identity-editor.js.map +1 -1
  211. package/lib/ui/mcp-capabilities.js +1 -1
  212. package/lib/ui/mcp-capabilities.js.map +1 -1
  213. package/lib/ui/mcp-panel.js +1 -1
  214. package/lib/ui/mcp-panel.js.map +1 -1
  215. package/lib/ui/memory/concern-board.js +2 -2
  216. package/lib/ui/memory/concern-board.js.map +1 -1
  217. package/lib/ui/memory/concern-deletion.d.ts +1 -1
  218. package/lib/ui/memory/concern-deletion.d.ts.map +1 -1
  219. package/lib/ui/memory/concern-deletion.js +9 -4
  220. package/lib/ui/memory/concern-deletion.js.map +1 -1
  221. package/lib/ui/memory/concern-panel.js +1 -1
  222. package/lib/ui/memory/concern-panel.js.map +1 -1
  223. package/lib/ui/memory/memory-library.js +1 -1
  224. package/lib/ui/memory/memory-library.js.map +1 -1
  225. package/lib/ui/memory/memory-panel.js +1 -1
  226. package/lib/ui/memory/memory-panel.js.map +1 -1
  227. package/lib/ui/partner-components.js +1 -1
  228. package/lib/ui/partner-components.js.map +1 -1
  229. package/lib/ui/requirement-board.js +1 -1
  230. package/lib/ui/requirement-board.js.map +1 -1
  231. package/lib/ui/requirement-dialog.js +1 -1
  232. package/lib/ui/requirement-dialog.js.map +1 -1
  233. package/lib/ui/requirement-tasks-panel.js +1 -1
  234. package/lib/ui/requirement-tasks-panel.js.map +1 -1
  235. package/lib/ui/schedule-panel.d.ts.map +1 -1
  236. package/lib/ui/schedule-panel.js +20 -4
  237. package/lib/ui/schedule-panel.js.map +1 -1
  238. package/lib/ui/skills-panel.js +1 -1
  239. package/lib/ui/skills-panel.js.map +1 -1
  240. package/lib/ui/storage-settings.d.ts.map +1 -1
  241. package/lib/ui/storage-settings.js +2 -1
  242. package/lib/ui/storage-settings.js.map +1 -1
  243. package/lib/ui/task-board-stage.js +1 -1
  244. package/lib/ui/task-board-stage.js.map +1 -1
  245. package/lib/ui/workspace-components.js +1 -1
  246. package/lib/ui/workspace-components.js.map +1 -1
  247. package/lib/ui/workspace-navigation.d.ts +16 -16
  248. package/lib/ui/workspace-navigation.js +1 -1
  249. package/lib/ui/workspace-navigation.js.map +1 -1
  250. package/package.json +55 -41
  251. package/resources/skills/cinematic-director/manifest.json +205 -0
  252. package/resources/skills/cinematic-director/upstream/CHANGELOG.md +213 -0
  253. package/resources/skills/cinematic-director/upstream/CONTRIBUTING.md +316 -0
  254. package/resources/skills/cinematic-director/upstream/LICENSE +21 -0
  255. package/resources/skills/cinematic-director/upstream/README.md +507 -0
  256. package/resources/skills/cinematic-director/upstream/SKILL.md +420 -0
  257. package/resources/skills/cinematic-director/upstream/assets/beat-sheet-template.md +97 -0
  258. package/resources/skills/cinematic-director/upstream/assets/director-book-template.md +254 -0
  259. package/resources/skills/cinematic-director/upstream/assets/edit-timeline-template.md +147 -0
  260. package/resources/skills/cinematic-director/upstream/assets/keyframe-prompt-template.md +334 -0
  261. package/resources/skills/cinematic-director/upstream/assets/qc-checklist.md +153 -0
  262. package/resources/skills/cinematic-director/upstream/assets/shot-plan-template.md +95 -0
  263. package/resources/skills/cinematic-director/upstream/assets/sound-plan-template.md +181 -0
  264. package/resources/skills/cinematic-director/upstream/assets/video-prompt-template.md +305 -0
  265. package/resources/skills/cinematic-director/upstream/evals/run.md +69 -0
  266. package/resources/skills/cinematic-director/upstream/references/ai-video-tool-adapters.md +527 -0
  267. package/resources/skills/cinematic-director/upstream/references/blocking-and-staging.md +424 -0
  268. package/resources/skills/cinematic-director/upstream/references/cinematic-language.md +595 -0
  269. package/resources/skills/cinematic-director/upstream/references/continuity-bible.md +410 -0
  270. package/resources/skills/cinematic-director/upstream/references/director_styles/01_spielberg.md +192 -0
  271. package/resources/skills/cinematic-director/upstream/references/director_styles/02_hitchcock.md +193 -0
  272. package/resources/skills/cinematic-director/upstream/references/director_styles/03_kubrick.md +196 -0
  273. package/resources/skills/cinematic-director/upstream/references/director_styles/04_kurosawa.md +196 -0
  274. package/resources/skills/cinematic-director/upstream/references/director_styles/05_scorsese.md +195 -0
  275. package/resources/skills/cinematic-director/upstream/references/director_styles/06_fellini.md +197 -0
  276. package/resources/skills/cinematic-director/upstream/references/director_styles/07_bergman.md +197 -0
  277. package/resources/skills/cinematic-director/upstream/references/director_styles/08_tarkovsky.md +184 -0
  278. package/resources/skills/cinematic-director/upstream/references/director_styles/09_wong_kar_wai.md +189 -0
  279. package/resources/skills/cinematic-director/upstream/references/director_styles/10_nolan.md +185 -0
  280. package/resources/skills/cinematic-director/upstream/references/director_styles/11_villeneuve.md +188 -0
  281. package/resources/skills/cinematic-director/upstream/references/director_styles/12_fincher.md +185 -0
  282. package/resources/skills/cinematic-director/upstream/references/director_styles/13_refn.md +186 -0
  283. package/resources/skills/cinematic-director/upstream/references/director_styles/14_bi_gan.md +188 -0
  284. package/resources/skills/cinematic-director/upstream/references/director_styles/15_zhang_yimou.md +192 -0
  285. package/resources/skills/cinematic-director/upstream/references/director_styles/16_hou_hsiao_hsien.md +192 -0
  286. package/resources/skills/cinematic-director/upstream/references/director_styles/17_park_chan_wook.md +192 -0
  287. package/resources/skills/cinematic-director/upstream/references/director_styles/18_malick.md +191 -0
  288. package/resources/skills/cinematic-director/upstream/references/director_styles/19_michael_mann.md +192 -0
  289. package/resources/skills/cinematic-director/upstream/references/director_styles/20_coen_brothers.md +194 -0
  290. package/resources/skills/cinematic-director/upstream/references/director_styles/README.md +89 -0
  291. package/resources/skills/cinematic-director/upstream/references/director_styles/example_comparisons.md +140 -0
  292. package/resources/skills/cinematic-director/upstream/references/editing-and-assembly.md +263 -0
  293. package/resources/skills/cinematic-director/upstream/references/failure-modes.md +594 -0
  294. package/resources/skills/cinematic-director/upstream/references/genre-playbooks.md +407 -0
  295. package/resources/skills/cinematic-director/upstream/references/image-model-adapters.md +290 -0
  296. package/resources/skills/cinematic-director/upstream/references/lighting-and-color.md +349 -0
  297. package/resources/skills/cinematic-director/upstream/references/product-and-macro.md +207 -0
  298. package/resources/skills/cinematic-director/upstream/references/production-workflow.md +238 -0
  299. package/resources/skills/cinematic-director/upstream/references/prompt-lexicon.md +602 -0
  300. package/resources/skills/cinematic-director/upstream/references/sound-and-dialogue.md +364 -0
  301. package/resources/skills/director-skills/manifest.json +541 -0
  302. package/resources/skills/director-skills/upstream/CHANGELOG.md +32 -0
  303. package/resources/skills/director-skills/upstream/LICENSE +21 -0
  304. package/resources/skills/director-skills/upstream/MANIFEST.md +366 -0
  305. package/resources/skills/director-skills/upstream/README.md +251 -0
  306. package/resources/skills/director-skills/upstream/RESEARCH_PROVENANCE.md +37 -0
  307. package/resources/skills/director-skills/upstream/SKILL.md +114 -0
  308. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/SKILL.md +81 -0
  309. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/checklists/continuity_checklist.md +8 -0
  310. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/character_continuity_update.md +9 -0
  311. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/location_continuity_update.md +9 -0
  312. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/continuity_system.md +21 -0
  313. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/golden_image_workflow.md +29 -0
  314. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/identity_anchors.md +14 -0
  315. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/visual_bible_system.md +15 -0
  316. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/character_profile.md +15 -0
  317. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/continuity_checklist.md +11 -0
  318. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/costume_profile.md +12 -0
  319. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/location_profile.md +14 -0
  320. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/prop_profile.md +13 -0
  321. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/visual_style_bible.md +15 -0
  322. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/tests/continuity_tests.md +6 -0
  323. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/SKILL.md +80 -0
  324. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/checklists/image_prompt_quality_checklist.md +10 -0
  325. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/examples/shot_list_to_image_prompts.md +4 -0
  326. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/image_prompt_components.md +22 -0
  327. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/lighting_and_photorealism.md +19 -0
  328. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/negative_prompt_patterns.md +18 -0
  329. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/prompt_anatomy.md +18 -0
  330. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/character_reference_sheet_prompt.md +5 -0
  331. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/cinematic_still_prompt.md +3 -0
  332. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/keyframe_prompt.md +6 -0
  333. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/location_reference_prompt.md +3 -0
  334. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/prop_prompt.md +3 -0
  335. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/tests/image_prompt_completeness_tests.md +5 -0
  336. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/SKILL.md +84 -0
  337. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/checklists/video_prompt_quality_checklist.md +9 -0
  338. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/examples/image_prompt_to_video_prompt.md +3 -0
  339. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/ai_film_production_pipeline.md +21 -0
  340. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/audio_motion_timing.md +16 -0
  341. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/camera_lens_movement.md +26 -0
  342. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/negative_prompt_patterns.md +18 -0
  343. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/prompt_anatomy.md +18 -0
  344. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/video_prompt_components.md +25 -0
  345. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/image_to_video_prompt.md +5 -0
  346. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/text_to_video_prompt.md +5 -0
  347. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/video_beat_prompt.md +9 -0
  348. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/tests/video_prompt_completeness_tests.md +5 -0
  349. package/resources/skills/director-skills/upstream/skills/model-adaptation/SKILL.md +82 -0
  350. package/resources/skills/director-skills/upstream/skills/model-adaptation/checklists/model_export_checklist.md +9 -0
  351. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/failed_model_transfer_diagnosis.md +5 -0
  352. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/image_prompt_translation.md +10 -0
  353. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/same_scene_across_models.md +9 -0
  354. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/universal_prompt_to_model_specific_exports.md +14 -0
  355. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/video_prompt_translation.md +9 -0
  356. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/failure_modes_by_model.md +13 -0
  357. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/image_model_profiles.md +226 -0
  358. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_capability_matrix.md +24 -0
  359. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_update_protocol.md +10 -0
  360. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/parameter_compatibility.md +20 -0
  361. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/prompt_translation_rules.md +18 -0
  362. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/video_model_profiles.md +251 -0
  363. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_comparison_table.md +4 -0
  364. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_specific_prompt_export.md +21 -0
  365. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/multi_model_export_package.md +18 -0
  366. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/prompt_translation_report.md +13 -0
  367. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/universal_prompt_brief.md +25 -0
  368. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/model_routing_tests.md +8 -0
  369. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/prompt_translation_tests.md +7 -0
  370. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/research_provenance_tests.md +6 -0
  371. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/unknown_capability_tests.md +7 -0
  372. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/SKILL.md +82 -0
  373. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/diagnostic_checklist.md +8 -0
  374. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/release_quality_checklist.md +9 -0
  375. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/failed_output_to_revised_prompt.md +10 -0
  376. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/final_prompt_package_export.md +10 -0
  377. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/failure_modes.md +13 -0
  378. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/iteration_diagnostics.md +17 -0
  379. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/revision_loops.md +17 -0
  380. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/story_voice_release_qc.md +30 -0
  381. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/failed_output_intake.md +13 -0
  382. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/final_production_package.md +11 -0
  383. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/prompt_revision_report.md +17 -0
  384. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/tests/prompt_quality_checklist_tests.md +6 -0
  385. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/SKILL.md +81 -0
  386. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/checklists/scene_quality_checklist.md +8 -0
  387. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/examples/scene_to_screenplay_excerpt.md +18 -0
  388. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/dialogue_and_subtext.md +15 -0
  389. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/fountain_workflow.md +29 -0
  390. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/scene_construction.md +20 -0
  391. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/screenplay_format.md +18 -0
  392. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/beat_sheet.md +6 -0
  393. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/dialogue_pass.md +9 -0
  394. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/fountain_scene.md +25 -0
  395. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/screenplay_scene.md +19 -0
  396. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/tests/screenplay_scene_tests.md +6 -0
  397. package/resources/skills/director-skills/upstream/skills/short-film-development/SKILL.md +83 -0
  398. package/resources/skills/director-skills/upstream/skills/short-film-development/checklists/concept_quality_checklist.md +8 -0
  399. package/resources/skills/director-skills/upstream/skills/short-film-development/examples/idea_to_logline.md +13 -0
  400. package/resources/skills/director-skills/upstream/skills/short-film-development/examples/logline_to_outline.md +10 -0
  401. package/resources/skills/director-skills/upstream/skills/short-film-development/references/ai_storytelling_workflow.md +46 -0
  402. package/resources/skills/director-skills/upstream/skills/short-film-development/references/continuity_handoff.md +8 -0
  403. package/resources/skills/director-skills/upstream/skills/short-film-development/references/screenplay_structure.md +19 -0
  404. package/resources/skills/director-skills/upstream/skills/short-film-development/references/story_development_workflow.md +23 -0
  405. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/beat_sheet.md +7 -0
  406. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/idea_intake.md +16 -0
  407. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/logline.md +10 -0
  408. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_film_treatment.md +23 -0
  409. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_story_plan.md +22 -0
  410. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_premise.md +19 -0
  411. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_revision_audit.md +22 -0
  412. package/resources/skills/director-skills/upstream/skills/short-film-development/tests/output_format_tests.md +3 -0
  413. package/resources/skills/director-skills/upstream/skills/short-film-development/tests/routing_tests.md +7 -0
  414. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/SKILL.md +77 -0
  415. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/checklists/shotlist_quality_checklist.md +8 -0
  416. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/examples/screenplay_scene_to_shot_list.md +8 -0
  417. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/camera_plan.md +11 -0
  418. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/production_breakdown.md +11 -0
  419. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/shotlist_schema.md +21 -0
  420. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/asset_list.md +7 -0
  421. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/camera_plan.md +10 -0
  422. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/scene_breakdown.md +16 -0
  423. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/shot_list.md +5 -0
  424. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/tests/screenplay_to_shotlist_tests.md +5 -0
  425. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/SKILL.md +77 -0
  426. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/checklists/style_quality_checklist.md +8 -0
  427. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/examples/genre_to_visual_direction.md +15 -0
  428. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/camera_lens_movement.md +26 -0
  429. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/cinematic_language.md +32 -0
  430. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/genre_style_tone.md +17 -0
  431. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/lighting_and_photorealism.md +19 -0
  432. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/templates/visual_style_bible.md +33 -0
  433. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/tests/style_translation_tests.md +5 -0
  434. package/resources/skills/director-skills/upstream/tests/master_router_tests.md +80 -0
  435. package/resources/skills/drama-production/manifest.json +933 -0
  436. package/resources/skills/drama-production/upstream/LICENSE +21 -0
  437. package/resources/skills/drama-production/upstream/skills/short-drama/SKILL.md +153 -0
  438. package/resources/skills/drama-production/upstream/skills/short-drama/agents/openai.yaml +4 -0
  439. package/resources/skills/drama-production/upstream/skills/short-drama/assets/creator-decision.example.jsonl +4 -0
  440. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/app.js +1263 -0
  441. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/index.html +114 -0
  442. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/styles.css +297 -0
  443. package/resources/skills/drama-production/upstream/skills/short-drama/assets/production-observation.example.jsonl +2 -0
  444. package/resources/skills/drama-production/upstream/skills/short-drama/assets/project-template/short-drama.json +36 -0
  445. package/resources/skills/drama-production/upstream/skills/short-drama/assets/reference-observation.example.jsonl +2 -0
  446. package/resources/skills/drama-production/upstream/skills/short-drama/references/audience-reveal.md +21 -0
  447. package/resources/skills/drama-production/upstream/skills/short-drama/references/contract-and-ownership.md +45 -0
  448. package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-documents.md +230 -0
  449. package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-workflow.md +98 -0
  450. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards/Q/347/211/210/350/241/250/350/276/276.md +73 -0
  451. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//344/272/214/347/273/264/345/212/250/346/200/201/346/274/253.md +74 -0
  452. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//345/233/275/346/274/253/344/272/214/346/254/241/345/205/203.md +79 -0
  453. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//345/256/236/346/213/215.md +75 -0
  454. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//346/260/264/345/242/250/347/254/224/350/247/246.md +85 -0
  455. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//351/243/216/346/240/274/345/214/226/344/270/211/347/273/264.md +72 -0
  456. package/resources/skills/drama-production/upstream/skills/short-drama/references/knowhow-index.md +85 -0
  457. package/resources/skills/drama-production/upstream/skills/short-drama/references/look-development.md +51 -0
  458. package/resources/skills/drama-production/upstream/skills/short-drama/references/pickup-and-alternate.md +24 -0
  459. package/resources/skills/drama-production/upstream/skills/short-drama/references/production-form-profiles.md +126 -0
  460. package/resources/skills/drama-production/upstream/skills/short-drama/references/reference-roles.md +53 -0
  461. package/resources/skills/drama-production/upstream/skills/short-drama/references/runtime-preflight.md +24 -0
  462. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/creator_markdown_check.py +1413 -0
  463. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/dashboard_server.py +1798 -0
  464. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/project_tool.py +2454 -0
  465. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/selftest.py +287 -0
  466. package/resources/skills/drama-production/upstream/skills/short-drama-assets/SKILL.md +76 -0
  467. package/resources/skills/drama-production/upstream/skills/short-drama-assets/agents/openai.yaml +4 -0
  468. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/character-look.example.jsonl +3 -0
  469. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/continuity.example.jsonl +4 -0
  470. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/decisions.example.jsonl +5 -0
  471. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/location-view.example.jsonl +3 -0
  472. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/occurrences.example.jsonl +5 -0
  473. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/prop-state.example.jsonl +3 -0
  474. package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/characters.jsonl +2 -0
  475. package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/looks.jsonl +2 -0
  476. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/asset-review-checklist.md +82 -0
  477. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/character-and-look.md +190 -0
  478. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-delta.md +120 -0
  479. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-lock.md +122 -0
  480. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/identity-vs-variant.md +140 -0
  481. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/location-and-view.md +84 -0
  482. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/occurrence-extraction.md +108 -0
  483. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/prop-and-state.md +126 -0
  484. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/stage-contract.md +43 -0
  485. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/voice-direction.md +179 -0
  486. package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/asset_check.py +267 -0
  487. package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/selftest.py +89 -0
  488. package/resources/skills/drama-production/upstream/skills/short-drama-develop/SKILL.md +157 -0
  489. package/resources/skills/drama-production/upstream/skills/short-drama-develop/agents/openai.yaml +4 -0
  490. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/adaptation-map.example.jsonl +1 -0
  491. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/creative-brief.md +120 -0
  492. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/episode-map.jsonl +1 -0
  493. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/story-engine.md +181 -0
  494. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/adaptation-craft.md +219 -0
  495. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/creative-reference-intake.md +57 -0
  496. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/director-brief-craft.md +113 -0
  497. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/episode-design.md +509 -0
  498. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-and-hook-playbook.md +240 -0
  499. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//344/272/262/345/255/220/351/232/220/347/247/230.md +112 -0
  500. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//344/273/231/344/276/240/344/277/256/347/234/237.md +51 -0
  501. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//345/212/250/344/275/234/344/273/273/345/212/241.md +51 -0
  502. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//345/217/244/350/243/205/346/235/203/350/260/213.md +51 -0
  503. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//345/244/215/344/273/207/346/211/223/350/204/270.md +51 -0
  504. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//345/256/266/345/272/255/345/205/263/347/263/273.md +51 -0
  505. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//346/202/254/347/226/221/350/247/204/345/210/231.md +51 -0
  506. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//347/224/237/346/264/273/346/265/201.md +51 -0
  507. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//347/240/264/351/225/234/351/207/215/345/234/206.md +109 -0
  508. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//350/201/214/345/234/272/345/226/234/345/211/247.md +51 -0
  509. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//350/261/252/351/227/250/345/251/232/346/201/213.md +51 -0
  510. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards//350/272/253/344/273/275/351/224/231/344/275/215.md +51 -0
  511. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards.md +92 -0
  512. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/mechanism-loop.md +282 -0
  513. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/multi-episode-intake.md +128 -0
  514. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/premise-devices.md +211 -0
  515. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/reveal-reversal-payoff.md +99 -0
  516. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/serial-character-and-memory.md +293 -0
  517. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/stage-contract.md +88 -0
  518. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/story-craft.md +359 -0
  519. package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/episode_intake.py +699 -0
  520. package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/selftest.py +47 -0
  521. package/resources/skills/drama-production/upstream/skills/short-drama-edit/SKILL.md +146 -0
  522. package/resources/skills/drama-production/upstream/skills/short-drama-edit/agents/openai.yaml +4 -0
  523. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/README.md +60 -0
  524. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/package.json +15 -0
  525. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/remotion.config.ts +6 -0
  526. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Root.tsx +26 -0
  527. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Subtitles.tsx +88 -0
  528. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/font.ts +46 -0
  529. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/index.ts +4 -0
  530. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/schema.ts +32 -0
  531. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/tsconfig.json +13 -0
  532. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets//345/211/252/350/276/221/345/215/225.md +43 -0
  533. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/cut-craft.md +38 -0
  534. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/delivery-verify.md +29 -0
  535. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/generated-footage.md +54 -0
  536. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/sound-and-subtitles.md +60 -0
  537. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/stage-contract.md +51 -0
  538. package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/edit_tool.py +1156 -0
  539. package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/selftest.py +520 -0
  540. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/SKILL.md +73 -0
  541. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/agents/openai.yaml +4 -0
  542. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompt-spec.jsonl.md +187 -0
  543. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompts.md +42 -0
  544. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-frame-spec.jsonl.md +128 -0
  545. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-prompts.md +34 -0
  546. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/examples/minimal-image-prompt-specs.jsonl +2 -0
  547. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/character-and-look.md +153 -0
  548. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/common-recipe.md +241 -0
  549. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/edit-and-revision.md +110 -0
  550. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/location-plate.md +151 -0
  551. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/look-and-state-variant.md +97 -0
  552. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/lookdev-frame.md +34 -0
  553. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/production-sheet-recipes.md +177 -0
  554. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/prop-plate.md +137 -0
  555. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/review-and-fixtures.md +92 -0
  556. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/stage-contract.md +32 -0
  557. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/image_prompt_check.py +443 -0
  558. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/selftest.py +95 -0
  559. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/SKILL.md +245 -0
  560. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/agents/openai.yaml +4 -0
  561. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/assets/episode-candidate.example.jsonl +3 -0
  562. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-triage.md +116 -0
  563. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-value.md +124 -0
  564. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/aggregation-and-entities.md +155 -0
  565. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/chapter-extraction.md +144 -0
  566. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/stage-contract.md +67 -0
  567. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/novel_index.py +651 -0
  568. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/selftest.py +51 -0
  569. package/resources/skills/drama-production/upstream/skills/short-drama-produce/SKILL.md +183 -0
  570. package/resources/skills/drama-production/upstream/skills/short-drama-produce/agents/openai.yaml +4 -0
  571. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/adapter-contract.md +219 -0
  572. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/gpt-image-2.md +24 -0
  573. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-h3-video.md +86 -0
  574. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-music.md +25 -0
  575. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-speech.md +41 -0
  576. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/seedance.md +64 -0
  577. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/fixture_adapter.py +77 -0
  578. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/production_tool.py +2205 -0
  579. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/provider_adapters.py +1747 -0
  580. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/selftest.py +135 -0
  581. package/resources/skills/drama-production/upstream/skills/short-drama-review/SKILL.md +118 -0
  582. package/resources/skills/drama-production/upstream/skills/short-drama-review/agents/openai.yaml +4 -0
  583. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/finding-template.jsonl +2 -0
  584. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/supersession-decision.example.json +42 -0
  585. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/verdict-template.json +32 -0
  586. package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-findings.jsonl +2 -0
  587. package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-verdict.json +34 -0
  588. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/anti-template-repair.md +109 -0
  589. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/production-quality-gates.md +276 -0
  590. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/project-calibration.md +83 -0
  591. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/review-method.md +81 -0
  592. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-assets-prompts.md +111 -0
  593. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-source-analysis.md +108 -0
  594. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-story-script.md +264 -0
  595. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-visual-motion.md +184 -0
  596. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/stage-contract.md +28 -0
  597. package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/review_check.py +325 -0
  598. package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/selftest.py +87 -0
  599. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/SKILL.md +175 -0
  600. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/agents/openai.yaml +4 -0
  601. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-audition.example.jsonl +2 -0
  602. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-template.json +49 -0
  603. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-prompts.md +36 -0
  604. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-template.jsonl +2 -0
  605. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/revision-lineage.fragment.json +12 -0
  606. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/scene-visual-plan.example.jsonl +2 -0
  607. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/shot-template.jsonl +2 -0
  608. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/blocking-playbooks.md +216 -0
  609. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md +156 -0
  610. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/coverage-audition.md +34 -0
  611. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/keyframe-craft.md +174 -0
  612. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/lighting-craft.md +39 -0
  613. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/production-shot-grammar.md +279 -0
  614. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/review-and-fixtures.md +36 -0
  615. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/scene-visual-plan.md +30 -0
  616. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md +155 -0
  617. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-craft.md +266 -0
  618. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-revision-identity.md +25 -0
  619. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/stage-contract.md +57 -0
  620. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/selftest.py +191 -0
  621. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/storyboard_check.py +824 -0
  622. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/SKILL.md +154 -0
  623. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/agents/openai.yaml +4 -0
  624. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/coverage-scope.fragment.json +21 -0
  625. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/delivery-container.jsonl.md +101 -0
  626. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-spec.jsonl.md +217 -0
  627. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-terminal.example.jsonl +2 -0
  628. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/music-spec.jsonl.md +31 -0
  629. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/performance.fragment.json +38 -0
  630. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/video-prompts.md +67 -0
  631. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/examples/minimal-music-specs.jsonl +2 -0
  632. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/camera-audio-continuity.md +259 -0
  633. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/delivery-profile.md +273 -0
  634. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/generability.md +93 -0
  635. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/minimax-h3.md +253 -0
  636. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/motion-recipe.md +315 -0
  637. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/performance-action-timing.md +209 -0
  638. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/production-prompt-grammar.md +304 -0
  639. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/review-and-fixtures.md +139 -0
  640. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.0.md +50 -0
  641. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.5.md +122 -0
  642. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/stage-contract.md +60 -0
  643. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/target-model-profile.md +116 -0
  644. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/container_check.py +329 -0
  645. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/motion_timing_check.py +450 -0
  646. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/music_spec_check.py +327 -0
  647. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/selftest.py +82 -0
  648. package/resources/skills/drama-production/upstream/skills/short-drama-write/SKILL.md +99 -0
  649. package/resources/skills/drama-production/upstream/skills/short-drama-write/agents/openai.yaml +4 -0
  650. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/beats.jsonl +2 -0
  651. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card-standalone.json +120 -0
  652. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card.json +55 -0
  653. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/screenplay.md +36 -0
  654. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/voice-record-sheet.jsonl.md +89 -0
  655. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/dialogue-craft.md +526 -0
  656. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/production-format-dialect.md +273 -0
  657. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-handoff-capsule.md +25 -0
  658. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-sound-dramaturgy.md +43 -0
  659. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/screenplay-format.md +266 -0
  660. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/script-craft.md +745 -0
  661. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/stage-contract.md +36 -0
  662. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/substitutable-realization.md +107 -0
  663. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/duration_estimate.py +309 -0
  664. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/screenplay_index.py +1091 -0
  665. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/selftest.py +229 -0
  666. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/voice_sheet_check.py +416 -0
  667. package/resources/skills/viora-canvas-production/manifest.json +23 -0
  668. package/resources/skills/viora-canvas-production/references/canvas-contract.md +50 -0
  669. package/resources/skills/viora-canvas-production/references/creative-production.md +50 -0
  670. package/resources/skills/viora-canvas-production/references/generation-delivery.md +36 -0
  671. package/resources/skills/viora-canvas-production/references/production-ledger.md +25 -0
@@ -0,0 +1,174 @@
1
+ # Frozen Keyframe Craft
2
+
3
+ ## 目录
4
+
5
+ - [Boundary and instant tests](#boundary-and-instant-tests)
6
+ - [Purpose](#purpose)
7
+ - [Ordered recipe](#ordered-recipe)
8
+ - [尾帧:什么时候可以有,以及它换来什么代价](#尾帧什么时候可以有以及它换来什么代价sht-17)
9
+ - [Start-only drafting discipline](#start-only-drafting-discipline)
10
+ - [Static test](#static-test)
11
+
12
+ ## Boundary and instant tests
13
+
14
+ - `SHT-05` — Project exactly one accepted shot boundary and bind the exact
15
+ Character/Look, Location/View, and Prop/State variants visible there.
16
+ - `SHT-06` — Describe one freezeable instant. Ordered action, expression arcs,
17
+ camera movement, and transforming weather belong to motion, not the keyframe.
18
+
19
+ ## Purpose
20
+
21
+ Describe one frame that can exist at a single instant and accurately anchors the
22
+ accepted shot. A keyframe is not a compressed video prompt.
23
+
24
+ ## Ordered recipe
25
+
26
+ 1. **Purpose:** what the audience must notice now.
27
+ 2. **Focal subject:** exact asset and variant IDs.
28
+ 3. **Frame:** shot size, angle, lens intent, aspect-aware composition.
29
+ 4. **Geography:** Location/View, fixed anchors, foreground/background zones.
30
+ 5. **Boundary projection:** exact start position, body facing, pose, gaze, hands,
31
+ held props. Give body facing for every person — it fixes which screen side they
32
+ hold and which side the next reverse cuts from; `gaze` does not cover it. Add
33
+ head facing only when it differs from body facing.
34
+ 6. **Performance instant:** one visible expression/tension state, not an arc.
35
+ Pick a channel the current shot size can actually read — gaze, breath, body
36
+ set, object handling, or a held decision. A wide shot cannot carry an eyelid;
37
+ a close-up cannot carry a full-body retreat. Naming only the emotion ("愤怒")
38
+ leaves the translation to a downstream stage, and the keyframe is the first
39
+ frame — a mistranslation there is wrong from frame one.
40
+ 7. **Light and atmosphere:** inherit accepted direction/time/weather; add only
41
+ frame-relevant detail.
42
+ 8. **Text policy:** readable/symbolic/blank/postproduction for visible surfaces.
43
+ 9. **Exclusions:** contradictions or drift likely for this frame.
44
+
45
+ Identity and boundary facts remain source references. The keyframe owns focal,
46
+ composition, camera/lens, frame-only staging, and exclusions.
47
+
48
+ ### 写完之后过一遍可渲染检查
49
+
50
+ 判据是一句话:**接手的人能不能照着画出来,而不用自己发明任何事实**。逐条对照,
51
+ 缺哪条补哪条——这些不是可选修辞,缺一条执行端就得替你决定一次:
52
+
53
+ | 必须写出来 | 缺了会发生什么 |
54
+ |---|---|
55
+ | 每个人在哪、彼此距离多少("站在他正前方约两步") | 人物间距逐镜漂移,观众读成换了场地 |
56
+ | 前景、中景、背景各有什么 | 纵深塌成一层,主体贴在背景上 |
57
+ | 视线该落在哪(本镜的视觉重点) | 画面平均用力,观众不知道该看谁 |
58
+ | 构图方式与景别 | 同一场每镜构图随机,剪不到一起 |
59
+ | 机位在轴线哪一侧、俯仰角度、焦段意图 | 越轴;正反打方向对不上 |
60
+ | 光从哪来、什么质感 | 同场光位逐镜跳变 |
61
+ | 每个在场者的姿态、朝向、手部、持物 | 下一镜接不住,道具凭空易手 |
62
+ | 哪些与上一镜相同 | 执行端把"没写"读成"可以变" |
63
+
64
+ 最后一条最容易漏,也最便宜:与上一镜一致的部分**写一句"与上一镜相同"即可**,
65
+ 不必重述细节;真正变了的才展开写。这一句是连续性的承载点。
66
+
67
+ **写紧**:一件事只说一次,能并进一句就不另起一句。上表十二项写满大约五百字就够;
68
+ 写到八百字往上,多出来的通常是连接词、铺垫句和把同一件事换个说法再说一遍——它们不增加
69
+ 可渲染的事实,却按字数付费。检查办法:删掉任意一句,如果画面没有变得更不确定,那句就是
70
+ 多的。
71
+
72
+ 写出来是这样(合成材料,四百余字覆盖上表全部十二项):
73
+
74
+ ```text
75
+ 竖屏 9:16 中近景。机位在轴线左侧、高约一米二,平视略低约五度,中焦 50mm。前景是长凳
76
+ 扶手与半张湿报纸(占下缘约六分之一);中景是两人对峙;背景是虚焦的候车牌。三分构图,
77
+ 她落在右三分线上。她:坐长凳右端,双手交叠压膝,身体朝向正前,视线落在对方鞋尖,
78
+ 无持物。人物乙:站她正前方约两步、略偏画面左,双手插袋,身体朝向她,头略偏向出口。
79
+ 光自画面右上顶棚缝隙斜下为主光(硬),左侧留暗,无补光。视觉重点在她压膝的双手——
80
+ 本镜唯一不动的东西。位置与持物与上一镜相同,只有她的视线从水洼移到对方鞋尖。
81
+ 排除:无动作过程,无雨丝拖影。
82
+ ```
83
+
84
+ Every visible entry the finished frame carries is listed in the shot's required
85
+ `视觉依据` field, resolving to a real `视觉设定.md` entry; an `IMG-...` prompt item
86
+ in `图片提示词.md` is a separate axis and does not stand in for it, and
87
+ `视觉设定.md` itself does not define `IMG-...` IDs. Write that list from the
88
+ finished frame, not from the shot's intent — the subject that gets missed is the
89
+ one that entered the composition while the frame was being written. A frozen frame may determine whether the surface
90
+ is legible in this composition; it may not replace the exact wording or policy
91
+ with an untraceable prose instruction. If the policy is still undecided, say so
92
+ instead of inventing a hidden candidate state.
93
+
94
+ ## 尾帧:什么时候可以有,以及它换来什么代价(`SHT-17`)
95
+
96
+ 默认每镜一张关键帧,冻结的是 start。但首尾帧接续是 AI 视频里最常用的工作流之一:把首帧
97
+ 和尾帧一起交给执行端,中间由它补。套件此前没有尾帧的位置,于是这条路要么走不通,要么被
98
+ 私自绕过——后者更糟,因为绕过时尾帧往往是**独立画出来的**,它就成了第二个终点权威,与
99
+ 镜头 `end_boundary` 各说各话。
100
+
101
+ **`structural_invariant`**:关键帧记录必须声明 `boundary_role`(`start` 或 `end`),
102
+ `boundary_ref` 指向同一镜头对应的那个边界字段。**尾帧是 `end_boundary` 的投影,
103
+ 不是新的终点事实**——它与首帧对 `start_boundary` 的关系完全一样:可以决定这一帧怎么构图、
104
+ 用什么景别镜头、光怎么落,不能决定人在哪、手里有什么、看着谁。尾帧与镜头终点不一致时,
105
+ 错的是尾帧。
106
+
107
+ 每镜的关键帧数量**不是固定的**。默认一张首帧;只有当交付工作流真的要消费尾帧时才加一张,
108
+ 不为凑齐而画。补尾帧不改变 `SHT-10`:首帧仍然只能写 start 事实,尾帧只能写 end 事实,
109
+ 两张各自守自己的边界,不互相借用。
110
+
111
+ **代价要说清楚:交出一对首尾帧,等于把两帧之间的运动交给了执行端插值**。 而运动路径本来
112
+ 是运动规格拥有的东西。所以选了首尾帧接续的镜头,其运动规格不是"照旧再写一遍",而是被
113
+ 两端夹住了:它仍然要写清中间必须发生什么(动作顺序、对白落点、摄影机行为),但要意识到
114
+ 执行端会优先满足两端的画面一致性。因此——
115
+
116
+ - 中间必须被看到的动作**不要只靠插值兑现**。如果一个动作是本镜存在的理由,两端之间没有
117
+ 任何东西保证它会发生,就该拆镜,或者让该动作落在其中一端。
118
+ - 两端差异越大,插值越自由,中间越不可控。首尾帧接续适合"状态改变清楚、路径无所谓"的
119
+ 镜头(转身、递交完成、坐下),不适合"路径本身是戏"的镜头。
120
+ - 终点报告仍然对照镜头 `end_boundary`,不对照尾帧。尾帧只是它的投影,不能自证到达。
121
+
122
+ ## Start-only drafting discipline
123
+
124
+ **`SHT-10 · reviewed_invariant`**: rendered keyframe prose may contain only facts
125
+ from the boundary that frame declares. 首帧写进任何由运动或终点首次产生的事实是漂移;
126
+ 尾帧写进在它之前就已经消耗掉的事实同样是漂移。两帧各守各的边界,不互相借用。
127
+
128
+ Keyframe 默认是 shot start,不是“本镜最有戏的时刻”。为避免把 end 提前:
129
+
130
+ 1. 先明确本帧冻结 `SHOT-...` 的起点,草拟正文时暂不读终点与运动描述;
131
+ 2. 只填 start 已成立的 position/pose/gaze/hands/held props/visible state;
132
+ 3. 再与 end 做“新出现事实”差集;差集中的事实不得出现在 keyframe prompt;
133
+ 4. 写完 Markdown 后从自然语言反向提取手位、持物、目光和可见状态,与镜头起点再比一次;
134
+ 不能只看条目说明而忽略真正交付的正文。
135
+
136
+ 反例:start 是“右手空置、看对方”,end 是“右手握铃绳、看门”。冻结帧写
137
+ “手已握铃绳”即使很好看,也属于 boundary drift。
138
+
139
+ ## Static test
140
+
141
+ Ask: could a still photographer capture every described fact at once?
142
+
143
+ Move these to motion:
144
+
145
+ - ordered verbs (先、再、随后、最终);
146
+ - expression changing from A to B;
147
+ - camera push/pan/track over time;
148
+ - entering/leaving/turning/reaching sequences;
149
+ - dialogue delivery arc or sound progression;
150
+ - light/weather transforming during the shot.
151
+
152
+ A single held pose may imply tension, but it must not require several moments.
153
+
154
+ ## Prompt economy
155
+
156
+ Do not restate full character or location 设定集s. Bind accepted variants and
157
+ repeat only facts the frame needs to prevent ambiguity: distinguishing anchor,
158
+ current Look, crucial spatial anchor, held prop, light direction, text state.
159
+
160
+ Generic “cinematic, 8K, masterpiece” language cannot replace subject identity,
161
+ geography, composition, or continuity.
162
+
163
+ ## Failure examples
164
+
165
+ - incompatible Looks appear in the same frame;
166
+ - “turns, runs, then looks back” appears in a still;
167
+ - the start hand/prop differs from the shot boundary;
168
+ - background changes location identity or orientation;
169
+ - light direction resets without source change;
170
+ - readable evidence is paired with no-text;
171
+ - prompt lists subjects but not their spatial relationship;
172
+ - framing has no focal hierarchy.
173
+ - structured projection matches start but rendered prompt describes a fact that
174
+ first appears in the shot end or motion.
@@ -0,0 +1,39 @@
1
+ # 光的设计
2
+
3
+ ## 分工
4
+
5
+ - 《视觉设定.md》的地点条目记录光源、窗户位置和已经确定的光线状态。
6
+ - 分镜选择本镜的注意中心,说明哪些脸、动作或证据必须可读。
7
+ - 提示词把这些选择写成可观察的画面结果。
8
+
9
+ 开灯、停电和时段变化会改变场景事实,应来自剧本或已接受的视觉设定。
10
+
11
+ ## 按镜头职责设计
12
+
13
+ 先确定观众需要看清什么,再选择亮暗关系、光比与背景分离程度。
14
+ 需要读表情时保留相关面部细节;需要隐藏身份时可以用剪影或遮暗。
15
+ 关注点可以靠亮度、色彩、轮廓或局部对比突出,不要求它总是全画面最亮的部分。
16
+
17
+ 竖屏按实际构图检查人物与背景是否分得开。近景中的脸部光线、多人纵深中的背景光,
18
+ 各自承担不同信息;不要仅按画幅省略环境或默认加轮廓光。
19
+
20
+ ## 把光位与画面效果一起写清
21
+
22
+ 光位术语后补充它在画面上的结果,并明确左右指画面还是人物自身。例如:
23
+
24
+ > 主光来自画面左侧;画面左侧脸颊较亮,另一侧留柔和阴影,眼睛仍可辨认。
25
+
26
+ 仅写「电影感、氛围感强」不足以决定画面。一次图片模型对照中,描述受光结果比只写
27
+ 光位更稳定;这可以作为起步写法,不能据此保证其他模型或视频同样执行。
28
+ 暗部深度、边缘亮光和背景亮度按本镜需要写,不把例子中的效果全部照搬。
29
+
30
+ ## 参考板与跨镜连续性
31
+
32
+ 参考板的均匀照明用于看清形制,不自动成为每个镜头的打光方案。
33
+ 绑定角色板时说明保留身份与造型;本镜的光仍依据场景事实。
34
+
35
+ 同一连续场景维持光源关系与既定色调;视角、取景范围和人物位置变化可以带来正常的
36
+ 画面亮度差异。不要要求所有镜头的平均 RGB 相同。
37
+
38
+ 生成后对比相邻镜头中可比较的脸、衣物或场景表面。曝光和白平衡的小幅偏差交给剪辑
39
+ 校正;光源方向或剧情光态错误回上游修订。测量用于定位差异,是否有问题仍结合画面判断。
@@ -0,0 +1,279 @@
1
+ # 生产分镜工艺:把剧本事实编成可审查镜头
2
+
3
+ ## 目录
4
+
5
+ - [贯穿原则](#一贯穿原则)
6
+ - [编号与文本](#二编号与文本分工)
7
+ - [拆分](#三拍镜拆分规则)
8
+ - [动作顺序交接](#四动作顺序交接给视频提示词环节的输入)
9
+ - [镜头叙事](#五镜头叙事学摄影决策问题)
10
+ - [戏型诊断](#六场景戏型诊断问题)
11
+ - [项目选择](#七项目选择craft_default)
12
+ - [单集时长加总](#七之二单集时长加总sht-16)
13
+ - [人物反应](#八人物反应sht-11)
14
+ - [自检](#九自检清单)
15
+ - [范例](#十范例合成决策记录不是镜头配额)
16
+ - [反模式](#十一反模式)
17
+
18
+ 来自对剧本拍、分镜、关键帧与视频提示词如何衔接的定性案例阅读,示例均为合成改写。
19
+ 方法论见 [shot-craft.md](shot-craft.md) 与 [keyframe-craft.md](keyframe-craft.md);
20
+ 本文档是生产端的转换规则和判断依据。出现的数字只有被创作者纳入项目方案
21
+ (`craft_default`)后才是验收条件,不能只因偏离示例就判为问题。
22
+
23
+ 核心认知:**分镜先说明剪辑覆盖范围和可审查的起止边界,不是下游视频提示词**。
24
+ 它说明本镜为何存在、观众能知道什么、从哪一状态到哪一状态;只有已接受的制作方案
25
+ 需要时才补充时间段意图,完整动作措辞由视频提示词环节编写。`start_boundary` 可以是
26
+ 静止关键帧,也可以是上游明确的运动中瞬间,不能把“静帧输入”误写成故事必须静止。
27
+
28
+ ## 一、贯穿原则
29
+
30
+ 1. **一镜一职责**(SHT-03 的生产表述):每镜有一个主导叙事职责。台词、反应与动作
31
+ 可同镜存在,只要镜头时长、表演负荷和注意顺序可执行;过载时按行动转向、听者后果或
32
+ 力学阶段拆镜,不按句号机械切镜。
33
+ 2. **先后顺序守住上游内容**:镜头记录必要动作与反应的相对顺序,不代写完整运动提示词。
34
+ 3. **几何要可比较**:方向、距离、占比或停留只在能消除当前歧义时量化;数值来自
35
+ 已接受的项目方案,不是每镜必填。
36
+ 4. **摄影行为有职责**(SHT-04):运镜或有意固定机位都应能说明它如何服务注意力、
37
+ 压力、观众立场、揭示或节奏,而不是给每镜强加运镜。
38
+ 5. **连续性靠已确认边界比较**:精确绑定 `Location/View`、`start_boundary` 与
39
+ `end_boundary`;下游只
40
+ 重复执行必需的局部状态,不逐镜复制整份状态表。
41
+
42
+ ## 二、编号与文本分工
43
+
44
+ - 分镜号 = `场序-镜序`。**场序按 clip 内"地点组"顺位**:换地点才递增,同地点的
45
+ 多个剧本场共用前缀;剧本自带集号时用三段式 `64-1-1`。
46
+ - 文本分工:保留该镜覆盖的剧本原文;用简短中文纲要说明谁做什么以及镜头职责,供
47
+ 人工审阅;另记录镜头目的、起止边界和摄影意图。完整时间过程由视频提示词环节编写。
48
+ **纲要写差 = 人审索引
49
+ 失效**——"开场"两个字的纲要是真实事故案例。
50
+
51
+ ## 三、拍→镜拆分规则
52
+
53
+ | 剧本形态 | 拆法 |
54
+ |---|---|
55
+ | 一拍 = 一句台词 + 一个动作 | 若同一镜头目的和边界可承担,可保留一镜;不是等式 |
56
+ | 一拍含多次行动转向或听者后果 | 按议程变化、听者反应与可执行语速拆镜;不使用固定句数/字数配额 |
57
+ | 一拍是爆发动作 | 若单镜过载,可按起势/接触/结果等力学阶段拆,切点绑定精确状态 |
58
+ | 一拍是纯反应/沉默 | 只有承担反应或选择后果时独立成镜;停留由后果与节奏决定 |
59
+
60
+ **建立镜头要自己挣到位置**。新地点确实可能需要让观众定位人物、入口或冲突区域,但
61
+ “先给一个空景全景说明这是哪儿”是长片的开场习惯:它把最前面的时间花在观众还没有理由
62
+ 在意的信息上。竖屏快节奏交付里默认反过来——**地理在动作内部到达**:人物已经在做的事、
63
+ 已经在说的话带出空间,观众边看边拼。这与剧本环节“在压力活跃处进入、用具体行动证明进入
64
+ 状态”的默认是同一条,不要在分镜层把它撤销。
65
+
66
+ 交代空间的镜头在这两种情况下成立:空间事实本身承担本镜因果(距离决定来不来得及、出口
67
+ 决定能不能走、谁站在门口决定谁看见了),或后续镜头的方位判断依赖它而动作本身给不出。
68
+ 成立时它也不必是空景全景——带着人物和动作的取景通常能一并完成,还省一个镜头。
69
+
70
+ 若前镜已经建立地理,或上游有意让观众先迷失/延迟识别,同样不为凑“第一镜全景”自增。
71
+ 任何新增镜头仍须解释它覆盖的内容与信息职责。
72
+
73
+ **`craft_default`**:以上是快节奏竖屏短剧的默认取向。项目声明了不同的观看契约(长篇、
74
+ 剧场感、慢节奏、以空间为主角)时,创作者说明理由即可覆盖,审查者不得单据此阻断交付。
75
+
76
+ ## 四、动作顺序交接(给视频提示词环节的输入)
77
+
78
+ 需要把复杂动作交给视频提示词环节时,可用中性顺序草图:
79
+
80
+ ```text
81
+ 起点:<已接受镜头边界,可静止也可在运动中>
82
+ 唯一动作:<触发> → <主体完成一条可见状态转换;交接时写清接触与落点> → <必要反应>
83
+ 终点:<已接受镜头边界;逐项接住位置、双手、持物与可见状态>
84
+ 摄影意图:<固定/移动及其叙事职责>
85
+ ```
86
+
87
+ - 起点逐字段写入已接受的 `start_boundary`,不把静态关键帧的媒介性质改成“人物必须静止”;
88
+ - 结束状态由分镜文件记录,下一镜通过引用比较,不靠复制长篇说明获得权威;
89
+ - 「唯一动作」是本镜的主状态链,不是限制镜内只能发生一个原子动作;它把必要步骤放在同一条
90
+ 因果线上,确保上一个可见状态确实走到下一个可见状态。
91
+ - 并行槽只放有来源的变化:他人反应、环境压力或持续运动锚点可以
92
+ 帮助画面成立,但没有叙事/物理依据时宁可保持静止,不为满足配额发明微动态;
93
+ - 只有已接受的时长或制作方案要求时才写秒数、角度或位移;它们是当前镜头选择,
94
+ 不是跨项目动作质量公式;
95
+ - 台词保持精确引用与相对动作顺序;是否把动作展开成更多阶段取决于时长和表演负荷。
96
+
97
+ **质量问题**:不改动台词和上游顺序时,这个镜头是否仍明确谁承载信息、谁接收
98
+ 后果、画面从什么边界到什么边界,以及为什么此处需要切镜?
99
+
100
+ ## 五、镜头叙事学(摄影决策问题)
101
+
102
+ | 需要解决的问题 | 先核对 | 可选实现,不是映射答案 |
103
+ |---|---|---|
104
+ | 信息必须被读到 | 通过脸、手、道具文字、空间关系还是声音呈现?何时允许看见? | 固定机位、跟随信息所在位置、改变焦点或切到接收者 |
105
+ | 观众立场改变 | 观众此前与谁同知、此刻为何要靠近或疏离? | 保持原视点、换主观侧、拉开关系或有意拒绝切换 |
106
+ | 空间压力改变 | 谁控制入口、距离、路径或画外威胁?地理是否已经建立? | 调整机位、跟位移、用遮挡,或保持固定让调度自己改变关系 |
107
+ | 力学动作需要理解 | 起势、接触、结果中哪些必须连续看清,哪些切点已有精确状态? | 单镜保持、按力学阶段拆、补细节镜头或反应镜头 |
108
+ | 情绪后果需要落地 | 哪个可见处理或选择证明人物接收了后果? | 留在同镜、切反应、延迟到后镜;景别由信息或表演所在位置决定 |
109
+
110
+ 一场通常比它真正要演的景别先开宽一档,第二镜就落到本场的**工作景别**,之后多数切镜在
111
+ 这一档上下一格来回;宽景和特写是**离开**工作景别的标记事件,用过就回来,场尾略微放开是
112
+ 常见收法。例如两人在客厅摊牌:第 1 镜全景交代谁堵着门口,第 2 镜落到中景这个工作景别,
113
+ 之后在中景与中近景之间对切,只有她把信封推过茶几时切一次特写,随即回到中近景,场尾退回
114
+ 中景收住。一路单调收紧的场次到中段就没有余量了。也可以用细节、背影、负空间或不切镜保持
115
+ 压力;顶点后的拉远同样只是选项。选择必须回应本场注意力、观众立场和信息揭示变化,不从
116
+ “情绪顶点=大特写”“结束=上帝视角”套模板。正反打、过肩和轴线策略服从已建立地理
117
+ 与有意的视角变化。
118
+
119
+ ### 切点必须带来可见变化
120
+
121
+ 上一段拒绝的是“按情绪套景别”,不是“景别可以原地不动”。两者的分界线是**这里到底切
122
+ 不切**:
123
+
124
+ - **不切镜**:同一景别持续本身就是选择。压力累积、人物在同一构图里自己改变距离、
125
+ 观众被迫一直看着不肯变的画面,都是有效理由。
126
+ - **已经切镜**:新镜必须在景别、机位角度或人物关系里至少改变一项。相邻两镜景别相同、
127
+ 角度相同、关系也没变时,观众读到的不是节奏,是跳切或穿帮——这个切点没有存在理由。
128
+ 修法只有三种:让收放跟着注意重点走(最常见是沿阶梯相邻一格一收一放:
129
+ 中景↔中近景↔近景↔特写),换轴线侧或视点,或者干脆并成一镜、用调度在镜内改变关系。
130
+ - **新空间的第一镜**通常先给得开一些,让观众定位后再逐步收进去;但前镜已经建立地理,
131
+ 或上游有意延迟识别时,不为“第一镜要宽”自增镜头(见第三节)。
132
+
133
+ 这条规则只在已经决定切镜时生效。它不是为景别多样性增加切点的理由:切多少镜仍由动作
134
+ 边界、听者反应和信息变化解释,收放幅度也要能说出注意力或观众立场变化在哪里。
135
+
136
+ 变焦推拉(Dolly Zoom)、荷兰角或甩镜是点睛手段;只有视角、失衡或注意力突然改变时才使用。
137
+ 重复使用会让每个节点失去差异,但不能靠固定次数判断(SHT-07)。
138
+
139
+ ### 角度、机位高度与焦段:三件常被写成一件的事
140
+
141
+ 景别有受控词表,角度长期只有一句"有动机的角度",结果三种彼此独立的选择被压进同一个词。
142
+ 最常见的具体后果:写"俯拍"时其实想要的是"从她背后越过肩膀"(那是**水平角度**,不是高度),
143
+ 下游按字面给了一个从上往下的机位,权力关系当场反了。
144
+
145
+ 分三栏写,缺哪栏就说明哪栏无所谓:
146
+
147
+ | 维度 | 词表 | 它在故事里回答什么 | 记在哪 |
148
+ |---|---|---|---|
149
+ | **水平角度** | `正面 / 斜侧(四分之三)/ 正侧 / 后斜侧 / 背面` | 观众被允许读到多少表情,以及站在谁的一侧 | 镜头 `framing.angle`,同时说明在轴线哪一侧 |
150
+ | **机位高度** | `地平 / 低(仰)/ 平视 / 高(俯)/ 顶视` | 谁在这一刻大于谁;平视是**主动**表示势均力敌,不是"没选" | 镜头 `framing.camera_height` |
151
+ | **焦段意图** | `广(空间关系优先)/ 标准(接近肉眼)/ 长(压缩纵深、隔离主体)` | 人与人的距离该显得更远还是更近 | 关键帧 `camera.lens_intent`(**帧级选择**) |
152
+
153
+ 前两栏是镜头拥有的调度事实,关键帧只投影不覆盖;焦段意图是关键帧自己的选择,因为它
154
+ 决定的是这一帧怎么被看,不改变人在哪、谁大于谁。不要在镜头记录里再写一次焦段——
155
+ 同一事实两处各写一份,改动时必然只改一处。
156
+
157
+ 三者互不推导,写死一栏不代表另两栏有了答案:
158
+
159
+ - 仰拍不等于正面。从背后仰拍是"我们跟在他身后而他正在变大",从正面仰拍是"他正压向我们"。
160
+ - 长焦不等于特写。用长焦拍全景会把纵深压平,让两个人看起来贴在一起——这可能正是要的,
161
+ 也可能是把"隔着半个房间对峙"拍成了"面对面"。
162
+ - 焦段意图属于 `taste_option`(`SHT-07`):写的是**要什么效果**,不是器材参数。写"长焦"
163
+ 是意图,写具体毫米数是把创作者的器材决定替他做了。
164
+
165
+ 竖屏还有一条不能忽略:**高度变化在竖屏里比横屏更贵**。9:16 的画面纵向本来就长,俯仰会
166
+ 迅速吃掉人物所在的可用高度,同样的俯角在竖屏里读起来比横屏强得多。要靠角度表达权力时,
167
+ 先看水平角度和距离能不能承担,再动高度。
168
+
169
+ ## 六、场景戏型诊断问题
170
+
171
+ - **对峙戏**:双方议程和可用筹码是什么?哪次行动真正改变距离、证据、关系或退出
172
+ 能力?谁必须接收改变?只有这些转向需要新镜头。
173
+ - **动作戏**:观众必须理解哪条路径、接触和结果?人物选择与代价落在哪里?先保证
174
+ 地理和道具归属,再决定连续保持、拆力学阶段或切反应。
175
+ - **情绪戏**:触发是什么,人物如何可见地处理,它促成什么选择或抑制?沉默、对白、
176
+ 手部、空间距离和不切镜都可承载,不把情绪名自动匹配到特写或推拉摇移。
177
+ - **悬疑/恐怖**:观众、角色与威胁分别知道什么?`show_now/withhold_now/reveal_trigger`
178
+ 分别由什么画面或声音呈现?遮挡既不能提前泄露,也不能藏掉本镜负责交付的证据。
179
+ - **喜剧**:铺垫事实、误读和纠正由谁看到?笑点可能来自节奏时机、构图内并存或切换,
180
+ 不要求固定反应次数,也不让反应镜解释已经成立的笑点。
181
+
182
+ ## 七、项目选择(`craft_default`)
183
+
184
+ | 决策 | 如何确定 |
185
+ |---|---|
186
+ | 拍如何拆镜 | 由动作边界、听者反应、空间变化与可执行时长共同决定,不追求固定比值。 |
187
+ | 台词如何分配 | 先保证一次可表演语气与口型负载;过长时按行动转向拆分,而非机械按字数。 |
188
+ | 单镜还是镜头组 | 先把每个镜头写成可单独审查的记录,再按目标交付方式编组;编组不改变镜头身份。本环节只负责镜头本身:定清每个镜头的目的、起止边界与已接受时长。编组之后由谁承担时长加总与成员资格,属于交付环节的事,不在这里决定,也不因为将来会编组就提前合并镜头。 |
189
+ | 子镜密度 | 9:16 信息流上的注意力是按切镜买的:`craft_default` 是可看的切镜密度大致每 4–8 秒一次,爽点更紧、情感处理更松在这条带宽内浮动,每次切换仍要有注意、压力或状态理由。项目把生成单元固定在更长的一档时,这条带宽由镜内调度承担——一镜里要有景别或视点的实际变化、或一次完整的动作与反应交接,否则无论单帧多好,观众读到的都是幻灯片。 |
190
+ | 单元时长 | 先从必须保留的动作、反应、对白与最终状态反推这一镜需要多久;放不下就删减、拆镜或请求改边界。项目已经定下可用的生成长度档位时,取容得下它的最短一档;没定就按反推出的秒数写,并把用到的档位报给创作者。超过约五到八秒后,一张冻结关键帧只描述了镜头开头,其余部分实际上没有规格:更长的镜头要么按精确状态边界拆开,要么由创作者明确接受它是一个宽规格镜头。 |
191
+
192
+ ## 七之二、单集时长加总(`SHT-16`)
193
+
194
+ 创作者在项目里写下的每集目标时长,如果全流程没有一处消费它,它就只是一个愿望。
195
+ 真实的失效是这样发生的:分镜逐镜看都合理,每一镜的时长也都是有理由的,直到全集镜头
196
+ 装到一起才发现比目标长出三分之一——而此时台词、资产、关键帧提示词都已经按这些镜头
197
+ 做完了,唯一还能改的只剩硬删。
198
+
199
+ `structural_invariant`:覆盖记录带一个 `episode_duration`,它的 `shot_seconds_total`
200
+ 必须是本集镜头 `duration_seconds` 的**算术和**,且覆盖里列出的每个镜头要么贡献一个数字,
201
+ 要么出现在 `unresolved_durations` 里。这条只管账目对不对:**不允许有镜头无声地不进总和**。
202
+ 时长未定的镜头显式挂起是正常状态,静默漏掉不是。
203
+
204
+ 项目声明了 `target_seconds_per_episode` 时,记录还要绑定该字段并写出带符号的
205
+ `delta_seconds` 与一个 `disposition`:
206
+
207
+ | disposition | 含义 |
208
+ |---|---|
209
+ | `no_target_declared` | 项目没有声明目标,本项只留总和 |
210
+ | `within_creator_tolerance` | 差值在创作者可接受范围内 |
211
+ | `creator_accepted_overrun` | 超出但创作者明确接受,附理由 |
212
+ | `to_revise` | 需要回到内容层处理 |
213
+
214
+ `craft_default`:差值本身**不阻断交付**。目标时长是计划,不是质量门槛;`to_revise` 的
215
+ 处理手段是回到内容层(合并同质节拍、把说明改成传递、拆集),不是按数字均匀删镜头或
216
+ 砍台词——后者砍掉的往往正是兑现。
217
+
218
+ 这条与分集阶段的量级估算是两件事,不要互相代替:估算用项目已接受集的比值预测**还没写的
219
+ 集**,第一集因为没有基准而跳过;加总用**已经存在的镜头**做测量,第一集同样成立。第一集
220
+ 拿不到估算,但拿得到测量。
221
+
222
+ ## 八、人物反应(SHT-11)
223
+
224
+ 对白覆盖存在不等于后果被接收。关键信息改变听者的权力、关系、知识或选择时,必须
225
+ 在本镜或后续独立镜中给出可见处理与最终状态;景别、时长和是否切镜由后果重量、表演动作
226
+ 及项目节奏决定。群像可用全场与个体两级反应,但这只是表现选项,不是固定组合。
227
+
228
+ ## 九、自检清单
229
+
230
+ 只检查与当前镜头有关的项目;不要为通过清单补写无来源动作、镜头或文字。
231
+
232
+ 1. 台词、行动、证据或沉默由什么可见/可听载体承担?有没有把以对白为主的合法镜头
233
+ 误判成必须添加动作?
234
+ 2. `start_boundary` 与 `end_boundary` 是否逐字段可比较?运动中边界、停顿和静止都与上游内容相容吗?
235
+ 3. 摄影选择或有意固定机位能回答它怎样服务注意力、观众立场、信息揭示、
236
+ 空间或节奏吗?
237
+ 4. 并行微动态有上游或环境依据吗?没有时是否避免为“画面活”而硬加?
238
+ 5. 表演状态的变化或保持是否符合触发、人物策略与局部结果?克制不变是否正是选择?
239
+ 6. 当前理解若依赖新地理,是否交代了必要锚点?若有意延迟识别,是否记录观众可见边界?
240
+ 7. 台词与反应在所选时长/语速内可执行吗?对照剧本是否遗漏或改变相对动作顺序?
241
+ 8. 镜头数量能由覆盖内容、动作边界、听者反应和时长解释吗?本集时长总和是否已加出来,
242
+ 时长未定的镜头是否显式挂起而不是漏掉?
243
+ 9. 每镜人物站位与上一镜衔接吗?(位置漂移是高频退回原因)
244
+ 10. 手部与持物能否逐步执行?放下、换手、双手动作、递交/取回是否有可见来源?
245
+ 11. 上游 `exact_readable` 字段是否有显示位置和处理方式,且没有被通用 `no_text` 覆盖?
246
+
247
+ ## 十、范例(合成决策记录,不是镜头配额)
248
+
249
+ ### 对峙中的证据递交
250
+
251
+ - **上游必保内容**:甲把账页交给乙;乙读到签名后停止否认。
252
+ - **为何切镜**:递交改变道具归属,乙的停顿证明信息被接收;两项可同镜完成时不拆。
253
+ - **观众可见边界**:账页内容只需让乙可读,观众通过签名位置和乙的选择理解,不自动补
254
+ 大特写或屏显全文。
255
+ - **摄影意图**:若同一构图能同时保住交接与反应则固定机位;若手部遮掉签名位置,
256
+ 才调整焦点或切细节镜头。选择由信息所在位置决定,不由“对峙戏”标签决定。
257
+
258
+ ### 动作是否拆镜
259
+
260
+ - **上游必保内容**:角色越过桌面夺走钥匙并退到门边。
261
+ - **单镜成立条件**:路径、接触、道具归属和退路都可读,且已接受时长足以完成。
262
+ - **拆镜条件**:遮挡使钥匙易手不可读,或退到门边需要新的空间边界;切点绑定钥匙
263
+ 在谁手中、双方位置和朝向,而不是套“起势—发力—结果”固定链。
264
+
265
+ ### 保持不动也可能是有效表演
266
+
267
+ - **上游必保内容**:威胁落下后,角色拒绝给对方可利用的反应。
268
+ - **实现判断**:稳定目光、没有退让和有意固定机位可以是人物策略;不为通过
269
+ “情绪必须变化”检查添加吞咽、握拳或无来源微动作。
270
+
271
+ ## 十一、反模式
272
+
273
+ 1. 旁白切片当分镜(小说旁白按逗号切进纲要,视频提示词全是“嘴唇开合说话”空壳)。
274
+ 2. 资产管理名泄漏进画面文本(占位文件名出现在视频提示词正文里)。
275
+ 3. 图片引用标记侵入台词内文。
276
+ 4. 无动机运镜("镜头静止。"单独出现不解释)。
277
+ 5. 台词标点+句式句号叠加("血口喷人!。"——收尾句号只加在无标点台词后)。
278
+ 6. 负面约束堆砌淹没内容(防缺陷补丁头尾重复 150+ 字,正文动作被稀释——补丁
279
+ 只在目标模型确有该缺陷时使用)。
@@ -0,0 +1,36 @@
1
+ # 分镜完成前检查
2
+
3
+ 这份清单只检查 `分镜.md` 能直接证明的结构事实,把审查注意力留给真正需要读懂戏的判断。
4
+ 检查发现问题就修正文档,不另建 coverage、QA 或校验结果文件。
5
+
6
+ ## 可直接核对
7
+
8
+ - 每个 `SHOT-...` ID 唯一,来源场景 ID 能在 `剧本.md` 找到;
9
+ - 每个制作相关的动作、对白、VO/OS、SFX、画面文字与连续性要求都由镜头承载,或有明确创作理由;
10
+ - 同一来源动作只有一个主要落实镜头,其他镜头只增加反应、细节或重新解释;
11
+ - 每镜时长是正数,全剧时长等于可见镜头时长之和;目标时长只用于报告差值,不是质量门槛;
12
+ - 起点和终点都写绝对事实,不使用“同上”“保持不变”代替;
13
+ - 相邻镜头的站位、朝向、视线、持物、伤势、光态与可读文字连续;
14
+ - 每镜都有「视觉依据」字段,条目名称能在《视觉设定.md》找到同名标题;关键帧正文点名的人物、地点、道具全部在列,「控制」不超过这一格画面承担得起的范围;
15
+ - 已用的 `IMG-...` 必须是《图片提示词.md》的可见标题,并带中文名称和控制范围;没有合适条目时明写「无」,不伪造 ID;
16
+ - 提示词条目与真实输入图片分开记录;只有创作者已提供或经确认生产、且当前可读的实际图片才能声称为「输入参考图」,并用独立稳定的 `REF-...` 槽位、显式顺序、仅用 `/` 分隔的项目相对路径、中文名称、用途、控制与不得控制范围定位;每个槽位的 `用途` 取自封闭词表,一镜最多一张起始帧与一张结束帧;图片由创作者在项目外准备、生成时自行挂载时,改用 `PLAN-...` 槽位,定位符写它对应的 `IMG-...` 或 `SHOT-...` 条目,其余字段与 `REF-...` 相同——它同样不声称项目里有文件;
17
+ 一张都没有、只准备了一部分、已有真实文件、由创作者自备和创作者明确选择文生视频必须如实区分;
18
+ - 冻结关键帧只投影所声明的边界:默认起点;外部工作流确实需要时才增加终点帧;
19
+ - 可复制关键帧正文不含 ID、文件路径、工作流状态或工艺说明。
20
+
21
+ 结构检查失败时点名文件、场景或镜头 ID、冲突事实和负责 owner,不回显整段私有文本。
22
+
23
+ ## 需要语义审查
24
+
25
+ 下列问题不能靠字段数量或脚本替代:
26
+
27
+ - 镜头是否守住来源原意和观众知情时机;
28
+ - 重复覆盖是否真的增加新的反应、证据或理解;
29
+ - 景别、机位、运动和切点是否由注意、压力、关系、空间或节奏变化驱动;
30
+ - 多人调度是否让主要关系和注意交接可读;
31
+ - 证据文字、决定性手部动作、脸与眼神是否会被遮挡;
32
+ - 关键帧是否既可冻结,又保留镜头下一步需要发生的动作空间;
33
+ - 画面里没有被名字点到、但仍需要认出身份的小比例或背景人物,是否也进了「视觉依据」——机械核对只抓被点名的那一类。
34
+
35
+ 关键帧数量、镜头数量、景别比例和目标时长差值都不是通用质量门槛。审查 finding 必须给出位置、
36
+ 证据、影响和必须达到的修订结果,不能只说“镜头不够电影感”或“看起来像 AI”。
@@ -0,0 +1,30 @@
1
+ # 场次视觉戏剧计划
2
+
3
+ 场次视觉计划是正式分镜前的可选思考层,回答整场怎样改变观众位置、空间压力、观看节奏和声音注意。
4
+ 它不是第二份剧本,也不拥有镜头边界。
5
+
6
+ ## 什么时候使用
7
+
8
+ 只在导演选择明显影响体验时使用:主要人物亮相、身份/证据揭示、关系反转、高潮或结尾、复杂多人
9
+ 调度、延迟信息的悬念场、承担视觉母题的场景。普通场景直接写镜头,不增加表单。
10
+
11
+ ## 在上下文比较什么
12
+
13
+ 使用场景标题 ID,例如 `EP001-SC003`,并结合当前视觉设定比较:
14
+
15
+ 1. **戏剧转向**:哪一种公开关系、信息或选择不可逆地改变;
16
+ 2. **观众立场**:开场站在哪一方,结束被移到哪里;
17
+ 3. **空间压力**:入口、距离、占位、遮挡、让路或退路怎样承载人物策略;
18
+ 4. **视觉推进**:什么时候让信息、反应或空间先于特写落地;
19
+ 5. **摄影节奏**:固定、移动、切近和停留分别由什么变化触发;
20
+ 6. **反应落点**:结尾画面由谁的选择或空间后果承担;
21
+ 7. **声音策略**:主导声源、主动留白、距离变化、撤出/恢复和 sound bridge。
22
+
23
+ 只有真正不同的方案才比较;不固定方案数、宫格、景别或镜头数。选定后直接把结果投影进
24
+ `分镜.md` 的镜头职责、景别/机位、起止边界与声音,不另存 audition、plan 或接受记录。
25
+
26
+ ## 检查
27
+
28
+ 不按字段完整度打分。检查观众立场、知情时机、空间压力或节奏是否发生有意变化;有意保持同一观看
29
+ 位置也可以成立,但必须说明它怎样制造观察、困住感或重新解释同构画面。再检查空间、摄影和声音是否
30
+ 共同承担同一转向,而不是重复“中近景—反打—推镜”。