@lemoncat7/dsh-partner 2.5.0 → 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 (642) hide show
  1. package/README.md +4 -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 +1 -1
  6. package/docs/releases/2.6.0.md +11 -0
  7. package/docs/releases/2.7.0.md +21 -0
  8. package/lib/agent-runtime.d.ts +3 -1
  9. package/lib/agent-runtime.d.ts.map +1 -1
  10. package/lib/agent-runtime.js +35 -11
  11. package/lib/agent-runtime.js.map +1 -1
  12. package/lib/api/features/attachments-api.d.ts.map +1 -1
  13. package/lib/api/features/attachments-api.js +31 -1
  14. package/lib/api/features/attachments-api.js.map +1 -1
  15. package/lib/api.d.ts +1 -1
  16. package/lib/api.d.ts.map +1 -1
  17. package/lib/api.js +1 -1
  18. package/lib/api.js.map +1 -1
  19. package/lib/attachments/grouped-storage.d.ts +5 -0
  20. package/lib/attachments/grouped-storage.d.ts.map +1 -0
  21. package/lib/attachments/grouped-storage.js +47 -0
  22. package/lib/attachments/grouped-storage.js.map +1 -0
  23. package/lib/attachments/service.d.ts +17 -0
  24. package/lib/attachments/service.d.ts.map +1 -1
  25. package/lib/attachments/service.js +100 -8
  26. package/lib/attachments/service.js.map +1 -1
  27. package/lib/attachments/shared-storage.d.ts +7 -0
  28. package/lib/attachments/shared-storage.d.ts.map +1 -0
  29. package/lib/attachments/shared-storage.js +44 -0
  30. package/lib/attachments/shared-storage.js.map +1 -0
  31. package/lib/attachments/storage-admin.d.ts +6 -0
  32. package/lib/attachments/storage-admin.d.ts.map +1 -0
  33. package/lib/attachments/storage-admin.js +43 -0
  34. package/lib/attachments/storage-admin.js.map +1 -0
  35. package/lib/attachments/storage-types.d.ts +33 -0
  36. package/lib/attachments/storage-types.d.ts.map +1 -0
  37. package/lib/attachments/storage-types.js +2 -0
  38. package/lib/attachments/storage-types.js.map +1 -0
  39. package/lib/attachments/tool.d.ts.map +1 -1
  40. package/lib/attachments/tool.js +16 -5
  41. package/lib/attachments/tool.js.map +1 -1
  42. package/lib/channels/delivery-policy.d.ts.map +1 -1
  43. package/lib/channels/delivery-policy.js +6 -4
  44. package/lib/channels/delivery-policy.js.map +1 -1
  45. package/lib/channels/direct/message-format.js +418 -281
  46. package/lib/channels/direct/message-format.js.map +4 -4
  47. package/lib/channels/manager.d.ts +6 -3
  48. package/lib/channels/manager.d.ts.map +1 -1
  49. package/lib/channels/manager.js +64 -44
  50. package/lib/channels/manager.js.map +1 -1
  51. package/lib/channels/weixin/api.d.ts.map +1 -1
  52. package/lib/channels/weixin/api.js +7 -2
  53. package/lib/channels/weixin/api.js.map +1 -1
  54. package/lib/channels/weixin/errors.d.ts +14 -0
  55. package/lib/channels/weixin/errors.d.ts.map +1 -0
  56. package/lib/channels/weixin/errors.js +29 -0
  57. package/lib/channels/weixin/errors.js.map +1 -0
  58. package/lib/channels/weixin/poll.d.ts +14 -0
  59. package/lib/channels/weixin/poll.d.ts.map +1 -0
  60. package/lib/channels/weixin/poll.js +50 -0
  61. package/lib/channels/weixin/poll.js.map +1 -0
  62. package/lib/client-controller.d.ts.map +1 -1
  63. package/lib/client-controller.js +3 -3
  64. package/lib/client-controller.js.map +1 -1
  65. package/lib/client.d.ts.map +1 -1
  66. package/lib/client.js +996 -645
  67. package/lib/client.js.map +4 -4
  68. package/lib/collaboration/composition.d.ts.map +1 -1
  69. package/lib/collaboration/composition.js +16 -6
  70. package/lib/collaboration/composition.js.map +1 -1
  71. package/lib/collaboration/domain.d.ts +6 -0
  72. package/lib/collaboration/domain.d.ts.map +1 -1
  73. package/lib/collaboration/domain.js.map +1 -1
  74. package/lib/collaboration/service.d.ts.map +1 -1
  75. package/lib/collaboration/service.js +33 -3
  76. package/lib/collaboration/service.js.map +1 -1
  77. package/lib/concern-notification.d.ts.map +1 -1
  78. package/lib/concern-notification.js +2 -1
  79. package/lib/concern-notification.js.map +1 -1
  80. package/lib/concern-tool.js +1 -1
  81. package/lib/concern-tool.js.map +1 -1
  82. package/lib/execution/reply-progress.d.ts.map +1 -1
  83. package/lib/execution/reply-progress.js +4 -2
  84. package/lib/execution/reply-progress.js.map +1 -1
  85. package/lib/execution/service.d.ts +1 -1
  86. package/lib/execution/service.d.ts.map +1 -1
  87. package/lib/execution/service.js +4 -7
  88. package/lib/execution/service.js.map +1 -1
  89. package/lib/index.d.ts.map +1 -1
  90. package/lib/index.js +3 -1
  91. package/lib/index.js.map +1 -1
  92. package/lib/memory-reflection.js +2 -2
  93. package/lib/memory-reflection.js.map +1 -1
  94. package/lib/message-source.d.ts +25 -0
  95. package/lib/message-source.d.ts.map +1 -0
  96. package/lib/message-source.js +8 -0
  97. package/lib/message-source.js.map +1 -0
  98. package/lib/observation-loop.js +4 -4
  99. package/lib/observation-loop.js.map +1 -1
  100. package/lib/pendant/reader.js +1 -1
  101. package/lib/pendant/reader.js.map +1 -1
  102. package/lib/pendant/settings-panel.js +1 -1
  103. package/lib/pendant/settings-panel.js.map +1 -1
  104. package/lib/persona/service.js +1 -1
  105. package/lib/persona/service.js.map +1 -1
  106. package/lib/requirements/attachments.d.ts +7 -0
  107. package/lib/requirements/attachments.d.ts.map +1 -0
  108. package/lib/requirements/attachments.js +26 -0
  109. package/lib/requirements/attachments.js.map +1 -0
  110. package/lib/requirements/domain.d.ts +1 -1
  111. package/lib/requirements/domain.d.ts.map +1 -1
  112. package/lib/requirements/service.d.ts.map +1 -1
  113. package/lib/requirements/service.js +4 -1
  114. package/lib/requirements/service.js.map +1 -1
  115. package/lib/scheduler/channel-origin.d.ts +7 -0
  116. package/lib/scheduler/channel-origin.d.ts.map +1 -0
  117. package/lib/scheduler/channel-origin.js +27 -0
  118. package/lib/scheduler/channel-origin.js.map +1 -0
  119. package/lib/scheduler/continuations.d.ts +2 -2
  120. package/lib/scheduler/continuations.d.ts.map +1 -1
  121. package/lib/scheduler/continuations.js +28 -8
  122. package/lib/scheduler/continuations.js.map +1 -1
  123. package/lib/scheduler/domain.d.ts +13 -0
  124. package/lib/scheduler/domain.d.ts.map +1 -1
  125. package/lib/scheduler/final-reply.d.ts +13 -0
  126. package/lib/scheduler/final-reply.d.ts.map +1 -0
  127. package/lib/scheduler/final-reply.js +21 -0
  128. package/lib/scheduler/final-reply.js.map +1 -0
  129. package/lib/skills/builtin-resources.d.ts +6 -0
  130. package/lib/skills/builtin-resources.d.ts.map +1 -0
  131. package/lib/skills/builtin-resources.js +47 -0
  132. package/lib/skills/builtin-resources.js.map +1 -0
  133. package/lib/skills/builtin.d.ts +2 -5
  134. package/lib/skills/builtin.d.ts.map +1 -1
  135. package/lib/skills/builtin.js +6 -0
  136. package/lib/skills/builtin.js.map +1 -1
  137. package/lib/skills/director-builtins.d.ts +8 -0
  138. package/lib/skills/director-builtins.d.ts.map +1 -0
  139. package/lib/skills/director-builtins.js +65 -0
  140. package/lib/skills/director-builtins.js.map +1 -0
  141. package/lib/skills/drama-builtin.d.ts +3 -0
  142. package/lib/skills/drama-builtin.d.ts.map +1 -0
  143. package/lib/skills/drama-builtin.js +49 -0
  144. package/lib/skills/drama-builtin.js.map +1 -0
  145. package/lib/skills/long-task-continuation.d.ts +2 -2
  146. package/lib/skills/long-task-continuation.d.ts.map +1 -1
  147. package/lib/skills/long-task-continuation.js +2 -2
  148. package/lib/skills/service.d.ts.map +1 -1
  149. package/lib/skills/service.js +8 -3
  150. package/lib/skills/service.js.map +1 -1
  151. package/lib/skills/viora-canvas-builtin.d.ts +3 -0
  152. package/lib/skills/viora-canvas-builtin.d.ts.map +1 -0
  153. package/lib/skills/viora-canvas-builtin.js +19 -0
  154. package/lib/skills/viora-canvas-builtin.js.map +1 -0
  155. package/lib/storage/migrate-layout.d.ts.map +1 -1
  156. package/lib/storage/migrate-layout.js +13 -4
  157. package/lib/storage/migrate-layout.js.map +1 -1
  158. package/lib/tasks/context.js +1 -0
  159. package/lib/tasks/context.js.map +1 -1
  160. package/lib/tasks/continuation.d.ts.map +1 -1
  161. package/lib/tasks/continuation.js +3 -0
  162. package/lib/tasks/continuation.js.map +1 -1
  163. package/lib/tasks/domain.d.ts +2 -0
  164. package/lib/tasks/domain.d.ts.map +1 -1
  165. package/lib/tasks/service.d.ts +2 -1
  166. package/lib/tasks/service.d.ts.map +1 -1
  167. package/lib/tasks/service.js +15 -1
  168. package/lib/tasks/service.js.map +1 -1
  169. package/lib/ui/attachment-storage.d.ts +2 -0
  170. package/lib/ui/attachment-storage.d.ts.map +1 -0
  171. package/lib/ui/attachment-storage.js +59 -0
  172. package/lib/ui/attachment-storage.js.map +1 -0
  173. package/lib/ui/capability-editor.js +1 -1
  174. package/lib/ui/capability-editor.js.map +1 -1
  175. package/lib/ui/companion-access-panel.js +1 -1
  176. package/lib/ui/companion-access-panel.js.map +1 -1
  177. package/lib/ui/companion-create.js +1 -1
  178. package/lib/ui/companion-create.js.map +1 -1
  179. package/lib/ui/companion-picker.js +1 -1
  180. package/lib/ui/companion-picker.js.map +1 -1
  181. package/lib/ui/identity-editor.js +1 -1
  182. package/lib/ui/identity-editor.js.map +1 -1
  183. package/lib/ui/mcp-capabilities.js +1 -1
  184. package/lib/ui/mcp-capabilities.js.map +1 -1
  185. package/lib/ui/mcp-panel.js +1 -1
  186. package/lib/ui/mcp-panel.js.map +1 -1
  187. package/lib/ui/memory/concern-board.js +2 -2
  188. package/lib/ui/memory/concern-board.js.map +1 -1
  189. package/lib/ui/memory/concern-deletion.d.ts +1 -1
  190. package/lib/ui/memory/concern-deletion.d.ts.map +1 -1
  191. package/lib/ui/memory/concern-deletion.js +9 -4
  192. package/lib/ui/memory/concern-deletion.js.map +1 -1
  193. package/lib/ui/memory/concern-panel.js +1 -1
  194. package/lib/ui/memory/concern-panel.js.map +1 -1
  195. package/lib/ui/memory/memory-library.js +1 -1
  196. package/lib/ui/memory/memory-library.js.map +1 -1
  197. package/lib/ui/memory/memory-panel.js +1 -1
  198. package/lib/ui/memory/memory-panel.js.map +1 -1
  199. package/lib/ui/partner-components.js +1 -1
  200. package/lib/ui/partner-components.js.map +1 -1
  201. package/lib/ui/requirement-board.js +1 -1
  202. package/lib/ui/requirement-board.js.map +1 -1
  203. package/lib/ui/requirement-dialog.js +1 -1
  204. package/lib/ui/requirement-dialog.js.map +1 -1
  205. package/lib/ui/requirement-tasks-panel.js +1 -1
  206. package/lib/ui/requirement-tasks-panel.js.map +1 -1
  207. package/lib/ui/schedule-panel.js +1 -1
  208. package/lib/ui/schedule-panel.js.map +1 -1
  209. package/lib/ui/skills-panel.js +1 -1
  210. package/lib/ui/skills-panel.js.map +1 -1
  211. package/lib/ui/storage-settings.d.ts.map +1 -1
  212. package/lib/ui/storage-settings.js +2 -1
  213. package/lib/ui/storage-settings.js.map +1 -1
  214. package/lib/ui/task-board-stage.js +1 -1
  215. package/lib/ui/task-board-stage.js.map +1 -1
  216. package/lib/ui/workspace-components.js +1 -1
  217. package/lib/ui/workspace-components.js.map +1 -1
  218. package/lib/ui/workspace-navigation.d.ts +16 -16
  219. package/lib/ui/workspace-navigation.js +1 -1
  220. package/lib/ui/workspace-navigation.js.map +1 -1
  221. package/package.json +53 -41
  222. package/resources/skills/cinematic-director/manifest.json +205 -0
  223. package/resources/skills/cinematic-director/upstream/CHANGELOG.md +213 -0
  224. package/resources/skills/cinematic-director/upstream/CONTRIBUTING.md +316 -0
  225. package/resources/skills/cinematic-director/upstream/LICENSE +21 -0
  226. package/resources/skills/cinematic-director/upstream/README.md +507 -0
  227. package/resources/skills/cinematic-director/upstream/SKILL.md +420 -0
  228. package/resources/skills/cinematic-director/upstream/assets/beat-sheet-template.md +97 -0
  229. package/resources/skills/cinematic-director/upstream/assets/director-book-template.md +254 -0
  230. package/resources/skills/cinematic-director/upstream/assets/edit-timeline-template.md +147 -0
  231. package/resources/skills/cinematic-director/upstream/assets/keyframe-prompt-template.md +334 -0
  232. package/resources/skills/cinematic-director/upstream/assets/qc-checklist.md +153 -0
  233. package/resources/skills/cinematic-director/upstream/assets/shot-plan-template.md +95 -0
  234. package/resources/skills/cinematic-director/upstream/assets/sound-plan-template.md +181 -0
  235. package/resources/skills/cinematic-director/upstream/assets/video-prompt-template.md +305 -0
  236. package/resources/skills/cinematic-director/upstream/evals/run.md +69 -0
  237. package/resources/skills/cinematic-director/upstream/references/ai-video-tool-adapters.md +527 -0
  238. package/resources/skills/cinematic-director/upstream/references/blocking-and-staging.md +424 -0
  239. package/resources/skills/cinematic-director/upstream/references/cinematic-language.md +595 -0
  240. package/resources/skills/cinematic-director/upstream/references/continuity-bible.md +410 -0
  241. package/resources/skills/cinematic-director/upstream/references/director_styles/01_spielberg.md +192 -0
  242. package/resources/skills/cinematic-director/upstream/references/director_styles/02_hitchcock.md +193 -0
  243. package/resources/skills/cinematic-director/upstream/references/director_styles/03_kubrick.md +196 -0
  244. package/resources/skills/cinematic-director/upstream/references/director_styles/04_kurosawa.md +196 -0
  245. package/resources/skills/cinematic-director/upstream/references/director_styles/05_scorsese.md +195 -0
  246. package/resources/skills/cinematic-director/upstream/references/director_styles/06_fellini.md +197 -0
  247. package/resources/skills/cinematic-director/upstream/references/director_styles/07_bergman.md +197 -0
  248. package/resources/skills/cinematic-director/upstream/references/director_styles/08_tarkovsky.md +184 -0
  249. package/resources/skills/cinematic-director/upstream/references/director_styles/09_wong_kar_wai.md +189 -0
  250. package/resources/skills/cinematic-director/upstream/references/director_styles/10_nolan.md +185 -0
  251. package/resources/skills/cinematic-director/upstream/references/director_styles/11_villeneuve.md +188 -0
  252. package/resources/skills/cinematic-director/upstream/references/director_styles/12_fincher.md +185 -0
  253. package/resources/skills/cinematic-director/upstream/references/director_styles/13_refn.md +186 -0
  254. package/resources/skills/cinematic-director/upstream/references/director_styles/14_bi_gan.md +188 -0
  255. package/resources/skills/cinematic-director/upstream/references/director_styles/15_zhang_yimou.md +192 -0
  256. package/resources/skills/cinematic-director/upstream/references/director_styles/16_hou_hsiao_hsien.md +192 -0
  257. package/resources/skills/cinematic-director/upstream/references/director_styles/17_park_chan_wook.md +192 -0
  258. package/resources/skills/cinematic-director/upstream/references/director_styles/18_malick.md +191 -0
  259. package/resources/skills/cinematic-director/upstream/references/director_styles/19_michael_mann.md +192 -0
  260. package/resources/skills/cinematic-director/upstream/references/director_styles/20_coen_brothers.md +194 -0
  261. package/resources/skills/cinematic-director/upstream/references/director_styles/README.md +89 -0
  262. package/resources/skills/cinematic-director/upstream/references/director_styles/example_comparisons.md +140 -0
  263. package/resources/skills/cinematic-director/upstream/references/editing-and-assembly.md +263 -0
  264. package/resources/skills/cinematic-director/upstream/references/failure-modes.md +594 -0
  265. package/resources/skills/cinematic-director/upstream/references/genre-playbooks.md +407 -0
  266. package/resources/skills/cinematic-director/upstream/references/image-model-adapters.md +290 -0
  267. package/resources/skills/cinematic-director/upstream/references/lighting-and-color.md +349 -0
  268. package/resources/skills/cinematic-director/upstream/references/product-and-macro.md +207 -0
  269. package/resources/skills/cinematic-director/upstream/references/production-workflow.md +238 -0
  270. package/resources/skills/cinematic-director/upstream/references/prompt-lexicon.md +602 -0
  271. package/resources/skills/cinematic-director/upstream/references/sound-and-dialogue.md +364 -0
  272. package/resources/skills/director-skills/manifest.json +541 -0
  273. package/resources/skills/director-skills/upstream/CHANGELOG.md +32 -0
  274. package/resources/skills/director-skills/upstream/LICENSE +21 -0
  275. package/resources/skills/director-skills/upstream/MANIFEST.md +366 -0
  276. package/resources/skills/director-skills/upstream/README.md +251 -0
  277. package/resources/skills/director-skills/upstream/RESEARCH_PROVENANCE.md +37 -0
  278. package/resources/skills/director-skills/upstream/SKILL.md +114 -0
  279. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/SKILL.md +81 -0
  280. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/checklists/continuity_checklist.md +8 -0
  281. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/character_continuity_update.md +9 -0
  282. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/location_continuity_update.md +9 -0
  283. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/continuity_system.md +21 -0
  284. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/golden_image_workflow.md +29 -0
  285. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/identity_anchors.md +14 -0
  286. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/visual_bible_system.md +15 -0
  287. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/character_profile.md +15 -0
  288. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/continuity_checklist.md +11 -0
  289. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/costume_profile.md +12 -0
  290. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/location_profile.md +14 -0
  291. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/prop_profile.md +13 -0
  292. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/visual_style_bible.md +15 -0
  293. package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/tests/continuity_tests.md +6 -0
  294. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/SKILL.md +80 -0
  295. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/checklists/image_prompt_quality_checklist.md +10 -0
  296. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/examples/shot_list_to_image_prompts.md +4 -0
  297. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/image_prompt_components.md +22 -0
  298. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/lighting_and_photorealism.md +19 -0
  299. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/negative_prompt_patterns.md +18 -0
  300. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/prompt_anatomy.md +18 -0
  301. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/character_reference_sheet_prompt.md +5 -0
  302. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/cinematic_still_prompt.md +3 -0
  303. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/keyframe_prompt.md +6 -0
  304. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/location_reference_prompt.md +3 -0
  305. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/prop_prompt.md +3 -0
  306. package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/tests/image_prompt_completeness_tests.md +5 -0
  307. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/SKILL.md +84 -0
  308. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/checklists/video_prompt_quality_checklist.md +9 -0
  309. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/examples/image_prompt_to_video_prompt.md +3 -0
  310. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/ai_film_production_pipeline.md +21 -0
  311. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/audio_motion_timing.md +16 -0
  312. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/camera_lens_movement.md +26 -0
  313. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/negative_prompt_patterns.md +18 -0
  314. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/prompt_anatomy.md +18 -0
  315. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/video_prompt_components.md +25 -0
  316. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/image_to_video_prompt.md +5 -0
  317. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/text_to_video_prompt.md +5 -0
  318. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/video_beat_prompt.md +9 -0
  319. package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/tests/video_prompt_completeness_tests.md +5 -0
  320. package/resources/skills/director-skills/upstream/skills/model-adaptation/SKILL.md +82 -0
  321. package/resources/skills/director-skills/upstream/skills/model-adaptation/checklists/model_export_checklist.md +9 -0
  322. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/failed_model_transfer_diagnosis.md +5 -0
  323. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/image_prompt_translation.md +10 -0
  324. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/same_scene_across_models.md +9 -0
  325. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/universal_prompt_to_model_specific_exports.md +14 -0
  326. package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/video_prompt_translation.md +9 -0
  327. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/failure_modes_by_model.md +13 -0
  328. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/image_model_profiles.md +226 -0
  329. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_capability_matrix.md +24 -0
  330. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_update_protocol.md +10 -0
  331. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/parameter_compatibility.md +20 -0
  332. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/prompt_translation_rules.md +18 -0
  333. package/resources/skills/director-skills/upstream/skills/model-adaptation/references/video_model_profiles.md +251 -0
  334. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_comparison_table.md +4 -0
  335. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_specific_prompt_export.md +21 -0
  336. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/multi_model_export_package.md +18 -0
  337. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/prompt_translation_report.md +13 -0
  338. package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/universal_prompt_brief.md +25 -0
  339. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/model_routing_tests.md +8 -0
  340. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/prompt_translation_tests.md +7 -0
  341. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/research_provenance_tests.md +6 -0
  342. package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/unknown_capability_tests.md +7 -0
  343. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/SKILL.md +82 -0
  344. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/diagnostic_checklist.md +8 -0
  345. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/release_quality_checklist.md +9 -0
  346. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/failed_output_to_revised_prompt.md +10 -0
  347. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/final_prompt_package_export.md +10 -0
  348. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/failure_modes.md +13 -0
  349. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/iteration_diagnostics.md +17 -0
  350. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/revision_loops.md +17 -0
  351. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/story_voice_release_qc.md +30 -0
  352. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/failed_output_intake.md +13 -0
  353. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/final_production_package.md +11 -0
  354. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/prompt_revision_report.md +17 -0
  355. package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/tests/prompt_quality_checklist_tests.md +6 -0
  356. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/SKILL.md +81 -0
  357. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/checklists/scene_quality_checklist.md +8 -0
  358. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/examples/scene_to_screenplay_excerpt.md +18 -0
  359. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/dialogue_and_subtext.md +15 -0
  360. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/fountain_workflow.md +29 -0
  361. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/scene_construction.md +20 -0
  362. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/screenplay_format.md +18 -0
  363. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/beat_sheet.md +6 -0
  364. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/dialogue_pass.md +9 -0
  365. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/fountain_scene.md +25 -0
  366. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/screenplay_scene.md +19 -0
  367. package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/tests/screenplay_scene_tests.md +6 -0
  368. package/resources/skills/director-skills/upstream/skills/short-film-development/SKILL.md +83 -0
  369. package/resources/skills/director-skills/upstream/skills/short-film-development/checklists/concept_quality_checklist.md +8 -0
  370. package/resources/skills/director-skills/upstream/skills/short-film-development/examples/idea_to_logline.md +13 -0
  371. package/resources/skills/director-skills/upstream/skills/short-film-development/examples/logline_to_outline.md +10 -0
  372. package/resources/skills/director-skills/upstream/skills/short-film-development/references/ai_storytelling_workflow.md +46 -0
  373. package/resources/skills/director-skills/upstream/skills/short-film-development/references/continuity_handoff.md +8 -0
  374. package/resources/skills/director-skills/upstream/skills/short-film-development/references/screenplay_structure.md +19 -0
  375. package/resources/skills/director-skills/upstream/skills/short-film-development/references/story_development_workflow.md +23 -0
  376. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/beat_sheet.md +7 -0
  377. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/idea_intake.md +16 -0
  378. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/logline.md +10 -0
  379. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_film_treatment.md +23 -0
  380. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_story_plan.md +22 -0
  381. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_premise.md +19 -0
  382. package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_revision_audit.md +22 -0
  383. package/resources/skills/director-skills/upstream/skills/short-film-development/tests/output_format_tests.md +3 -0
  384. package/resources/skills/director-skills/upstream/skills/short-film-development/tests/routing_tests.md +7 -0
  385. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/SKILL.md +77 -0
  386. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/checklists/shotlist_quality_checklist.md +8 -0
  387. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/examples/screenplay_scene_to_shot_list.md +8 -0
  388. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/camera_plan.md +11 -0
  389. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/production_breakdown.md +11 -0
  390. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/shotlist_schema.md +21 -0
  391. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/asset_list.md +7 -0
  392. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/camera_plan.md +10 -0
  393. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/scene_breakdown.md +16 -0
  394. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/shot_list.md +5 -0
  395. package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/tests/screenplay_to_shotlist_tests.md +5 -0
  396. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/SKILL.md +77 -0
  397. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/checklists/style_quality_checklist.md +8 -0
  398. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/examples/genre_to_visual_direction.md +15 -0
  399. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/camera_lens_movement.md +26 -0
  400. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/cinematic_language.md +32 -0
  401. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/genre_style_tone.md +17 -0
  402. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/lighting_and_photorealism.md +19 -0
  403. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/templates/visual_style_bible.md +33 -0
  404. package/resources/skills/director-skills/upstream/skills/style-cinematography-director/tests/style_translation_tests.md +5 -0
  405. package/resources/skills/director-skills/upstream/tests/master_router_tests.md +80 -0
  406. package/resources/skills/drama-production/manifest.json +933 -0
  407. package/resources/skills/drama-production/upstream/LICENSE +21 -0
  408. package/resources/skills/drama-production/upstream/skills/short-drama/SKILL.md +153 -0
  409. package/resources/skills/drama-production/upstream/skills/short-drama/agents/openai.yaml +4 -0
  410. package/resources/skills/drama-production/upstream/skills/short-drama/assets/creator-decision.example.jsonl +4 -0
  411. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/app.js +1263 -0
  412. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/index.html +114 -0
  413. package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/styles.css +297 -0
  414. package/resources/skills/drama-production/upstream/skills/short-drama/assets/production-observation.example.jsonl +2 -0
  415. package/resources/skills/drama-production/upstream/skills/short-drama/assets/project-template/short-drama.json +36 -0
  416. package/resources/skills/drama-production/upstream/skills/short-drama/assets/reference-observation.example.jsonl +2 -0
  417. package/resources/skills/drama-production/upstream/skills/short-drama/references/audience-reveal.md +21 -0
  418. package/resources/skills/drama-production/upstream/skills/short-drama/references/contract-and-ownership.md +45 -0
  419. package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-documents.md +230 -0
  420. package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-workflow.md +98 -0
  421. 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
  422. 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
  423. 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
  424. package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//345/256/236/346/213/215.md +75 -0
  425. 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
  426. 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
  427. package/resources/skills/drama-production/upstream/skills/short-drama/references/knowhow-index.md +85 -0
  428. package/resources/skills/drama-production/upstream/skills/short-drama/references/look-development.md +51 -0
  429. package/resources/skills/drama-production/upstream/skills/short-drama/references/pickup-and-alternate.md +24 -0
  430. package/resources/skills/drama-production/upstream/skills/short-drama/references/production-form-profiles.md +126 -0
  431. package/resources/skills/drama-production/upstream/skills/short-drama/references/reference-roles.md +53 -0
  432. package/resources/skills/drama-production/upstream/skills/short-drama/references/runtime-preflight.md +24 -0
  433. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/creator_markdown_check.py +1413 -0
  434. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/dashboard_server.py +1798 -0
  435. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/project_tool.py +2454 -0
  436. package/resources/skills/drama-production/upstream/skills/short-drama/scripts/selftest.py +287 -0
  437. package/resources/skills/drama-production/upstream/skills/short-drama-assets/SKILL.md +76 -0
  438. package/resources/skills/drama-production/upstream/skills/short-drama-assets/agents/openai.yaml +4 -0
  439. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/character-look.example.jsonl +3 -0
  440. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/continuity.example.jsonl +4 -0
  441. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/decisions.example.jsonl +5 -0
  442. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/location-view.example.jsonl +3 -0
  443. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/occurrences.example.jsonl +5 -0
  444. package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/prop-state.example.jsonl +3 -0
  445. package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/characters.jsonl +2 -0
  446. package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/looks.jsonl +2 -0
  447. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/asset-review-checklist.md +82 -0
  448. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/character-and-look.md +190 -0
  449. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-delta.md +120 -0
  450. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-lock.md +122 -0
  451. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/identity-vs-variant.md +140 -0
  452. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/location-and-view.md +84 -0
  453. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/occurrence-extraction.md +108 -0
  454. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/prop-and-state.md +126 -0
  455. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/stage-contract.md +43 -0
  456. package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/voice-direction.md +179 -0
  457. package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/asset_check.py +267 -0
  458. package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/selftest.py +89 -0
  459. package/resources/skills/drama-production/upstream/skills/short-drama-develop/SKILL.md +157 -0
  460. package/resources/skills/drama-production/upstream/skills/short-drama-develop/agents/openai.yaml +4 -0
  461. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/adaptation-map.example.jsonl +1 -0
  462. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/creative-brief.md +120 -0
  463. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/episode-map.jsonl +1 -0
  464. package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/story-engine.md +181 -0
  465. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/adaptation-craft.md +219 -0
  466. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/creative-reference-intake.md +57 -0
  467. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/director-brief-craft.md +113 -0
  468. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/episode-design.md +509 -0
  469. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-and-hook-playbook.md +240 -0
  470. 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
  471. 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
  472. 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
  473. 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
  474. 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
  475. 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
  476. 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
  477. 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
  478. 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
  479. 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
  480. 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
  481. 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
  482. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards.md +92 -0
  483. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/mechanism-loop.md +282 -0
  484. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/multi-episode-intake.md +128 -0
  485. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/premise-devices.md +211 -0
  486. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/reveal-reversal-payoff.md +99 -0
  487. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/serial-character-and-memory.md +293 -0
  488. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/stage-contract.md +88 -0
  489. package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/story-craft.md +359 -0
  490. package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/episode_intake.py +699 -0
  491. package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/selftest.py +47 -0
  492. package/resources/skills/drama-production/upstream/skills/short-drama-edit/SKILL.md +146 -0
  493. package/resources/skills/drama-production/upstream/skills/short-drama-edit/agents/openai.yaml +4 -0
  494. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/README.md +60 -0
  495. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/package.json +15 -0
  496. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/remotion.config.ts +6 -0
  497. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Root.tsx +26 -0
  498. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Subtitles.tsx +88 -0
  499. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/font.ts +46 -0
  500. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/index.ts +4 -0
  501. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/schema.ts +32 -0
  502. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/tsconfig.json +13 -0
  503. package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets//345/211/252/350/276/221/345/215/225.md +43 -0
  504. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/cut-craft.md +38 -0
  505. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/delivery-verify.md +29 -0
  506. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/generated-footage.md +54 -0
  507. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/sound-and-subtitles.md +60 -0
  508. package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/stage-contract.md +51 -0
  509. package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/edit_tool.py +1156 -0
  510. package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/selftest.py +520 -0
  511. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/SKILL.md +73 -0
  512. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/agents/openai.yaml +4 -0
  513. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompt-spec.jsonl.md +187 -0
  514. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompts.md +42 -0
  515. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-frame-spec.jsonl.md +128 -0
  516. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-prompts.md +34 -0
  517. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/examples/minimal-image-prompt-specs.jsonl +2 -0
  518. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/character-and-look.md +153 -0
  519. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/common-recipe.md +241 -0
  520. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/edit-and-revision.md +110 -0
  521. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/location-plate.md +151 -0
  522. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/look-and-state-variant.md +97 -0
  523. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/lookdev-frame.md +34 -0
  524. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/production-sheet-recipes.md +177 -0
  525. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/prop-plate.md +137 -0
  526. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/review-and-fixtures.md +92 -0
  527. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/stage-contract.md +32 -0
  528. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/image_prompt_check.py +443 -0
  529. package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/selftest.py +95 -0
  530. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/SKILL.md +245 -0
  531. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/agents/openai.yaml +4 -0
  532. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/assets/episode-candidate.example.jsonl +3 -0
  533. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-triage.md +116 -0
  534. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-value.md +124 -0
  535. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/aggregation-and-entities.md +155 -0
  536. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/chapter-extraction.md +144 -0
  537. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/stage-contract.md +67 -0
  538. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/novel_index.py +651 -0
  539. package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/selftest.py +51 -0
  540. package/resources/skills/drama-production/upstream/skills/short-drama-produce/SKILL.md +183 -0
  541. package/resources/skills/drama-production/upstream/skills/short-drama-produce/agents/openai.yaml +4 -0
  542. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/adapter-contract.md +219 -0
  543. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/gpt-image-2.md +24 -0
  544. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-h3-video.md +86 -0
  545. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-music.md +25 -0
  546. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-speech.md +41 -0
  547. package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/seedance.md +64 -0
  548. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/fixture_adapter.py +77 -0
  549. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/production_tool.py +2205 -0
  550. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/provider_adapters.py +1747 -0
  551. package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/selftest.py +135 -0
  552. package/resources/skills/drama-production/upstream/skills/short-drama-review/SKILL.md +118 -0
  553. package/resources/skills/drama-production/upstream/skills/short-drama-review/agents/openai.yaml +4 -0
  554. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/finding-template.jsonl +2 -0
  555. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/supersession-decision.example.json +42 -0
  556. package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/verdict-template.json +32 -0
  557. package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-findings.jsonl +2 -0
  558. package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-verdict.json +34 -0
  559. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/anti-template-repair.md +109 -0
  560. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/production-quality-gates.md +276 -0
  561. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/project-calibration.md +83 -0
  562. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/review-method.md +81 -0
  563. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-assets-prompts.md +111 -0
  564. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-source-analysis.md +108 -0
  565. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-story-script.md +264 -0
  566. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-visual-motion.md +184 -0
  567. package/resources/skills/drama-production/upstream/skills/short-drama-review/references/stage-contract.md +28 -0
  568. package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/review_check.py +325 -0
  569. package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/selftest.py +87 -0
  570. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/SKILL.md +175 -0
  571. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/agents/openai.yaml +4 -0
  572. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-audition.example.jsonl +2 -0
  573. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-template.json +49 -0
  574. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-prompts.md +36 -0
  575. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-template.jsonl +2 -0
  576. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/revision-lineage.fragment.json +12 -0
  577. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/scene-visual-plan.example.jsonl +2 -0
  578. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/shot-template.jsonl +2 -0
  579. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/blocking-playbooks.md +216 -0
  580. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md +156 -0
  581. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/coverage-audition.md +34 -0
  582. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/keyframe-craft.md +174 -0
  583. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/lighting-craft.md +39 -0
  584. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/production-shot-grammar.md +279 -0
  585. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/review-and-fixtures.md +36 -0
  586. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/scene-visual-plan.md +30 -0
  587. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md +155 -0
  588. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-craft.md +266 -0
  589. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-revision-identity.md +25 -0
  590. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/stage-contract.md +57 -0
  591. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/selftest.py +191 -0
  592. package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/storyboard_check.py +824 -0
  593. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/SKILL.md +154 -0
  594. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/agents/openai.yaml +4 -0
  595. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/coverage-scope.fragment.json +21 -0
  596. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/delivery-container.jsonl.md +101 -0
  597. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-spec.jsonl.md +217 -0
  598. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-terminal.example.jsonl +2 -0
  599. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/music-spec.jsonl.md +31 -0
  600. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/performance.fragment.json +38 -0
  601. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/video-prompts.md +67 -0
  602. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/examples/minimal-music-specs.jsonl +2 -0
  603. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/camera-audio-continuity.md +259 -0
  604. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/delivery-profile.md +273 -0
  605. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/generability.md +93 -0
  606. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/minimax-h3.md +253 -0
  607. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/motion-recipe.md +315 -0
  608. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/performance-action-timing.md +209 -0
  609. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/production-prompt-grammar.md +304 -0
  610. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/review-and-fixtures.md +139 -0
  611. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.0.md +50 -0
  612. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.5.md +122 -0
  613. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/stage-contract.md +60 -0
  614. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/target-model-profile.md +116 -0
  615. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/container_check.py +329 -0
  616. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/motion_timing_check.py +450 -0
  617. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/music_spec_check.py +327 -0
  618. package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/selftest.py +82 -0
  619. package/resources/skills/drama-production/upstream/skills/short-drama-write/SKILL.md +99 -0
  620. package/resources/skills/drama-production/upstream/skills/short-drama-write/agents/openai.yaml +4 -0
  621. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/beats.jsonl +2 -0
  622. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card-standalone.json +120 -0
  623. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card.json +55 -0
  624. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/screenplay.md +36 -0
  625. package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/voice-record-sheet.jsonl.md +89 -0
  626. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/dialogue-craft.md +526 -0
  627. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/production-format-dialect.md +273 -0
  628. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-handoff-capsule.md +25 -0
  629. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-sound-dramaturgy.md +43 -0
  630. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/screenplay-format.md +266 -0
  631. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/script-craft.md +745 -0
  632. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/stage-contract.md +36 -0
  633. package/resources/skills/drama-production/upstream/skills/short-drama-write/references/substitutable-realization.md +107 -0
  634. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/duration_estimate.py +309 -0
  635. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/screenplay_index.py +1091 -0
  636. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/selftest.py +229 -0
  637. package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/voice_sheet_check.py +416 -0
  638. package/resources/skills/viora-canvas-production/manifest.json +23 -0
  639. package/resources/skills/viora-canvas-production/references/canvas-contract.md +50 -0
  640. package/resources/skills/viora-canvas-production/references/creative-production.md +50 -0
  641. package/resources/skills/viora-canvas-production/references/generation-delivery.md +36 -0
  642. package/resources/skills/viora-canvas-production/references/production-ledger.md +25 -0
@@ -0,0 +1,190 @@
1
+ # Character / Look 设计
2
+
3
+ ## 目录
4
+
5
+ 1. 分工
6
+ 2. Character:最小稳定识别集
7
+ 3. Look:一次相容的外观组合
8
+ 4. 可选声音方向:身份锚点不等于本场 delivery
9
+ 5. 制作形态与身份锚点的可表达性
10
+ 6. 合成例:顾禾
11
+ 7. 角色 设定集 的实用检查
12
+
13
+ ## 分工
14
+
15
+ - **Character** 回答“这个人持续是谁、怎样被再次认出”。
16
+ - **Look** 回答“这个人在一个明确时段以怎样的完整外观出现”。
17
+
18
+ 把两者拆开,是为了换装、受伤、湿污和年龄变化时仍能复用人物身份,同时让图片提示
19
+ 词与分镜精确选择一个相容造型。
20
+
21
+
22
+ ## 画面代称要覆盖每一种正文语言
23
+
24
+ `画面代称` 是下游覆盖检查唯一用来匹配的字符串:冻结关键帧、图片提示词、视频提示词里出现了这个词,
25
+ 才算「这一镜点了这个资产的名」。匹配是逐字的,不做翻译。
26
+
27
+ 问题在于三份正文的语言不一定相同:图片提示词与冻结关键帧跟 `format/prompt_language`,
28
+ 视频提示词优先跟已接受的 `video_prompt_language`。而校验器只按后者的解析结果决定要不要强制
29
+ 「代称不能等于名字」——于是一个 zh + en 混配的项目很容易写成**只有英文代称**,
30
+ 然后中文正文里这个资产永远匹配不上。
31
+
32
+ **这种失败是静默的**:匹配不上不会报错,只会让覆盖检查对这条资产整个不生效,
33
+ 看起来一路绿灯。所以:
34
+
35
+ - 一个资产的 `画面代称` 要**把它在各份正文里实际会出现的写法都列上**(中文名与英文代称并列),
36
+ 不是二选一;
37
+ - 正文里确实不该靠名字识别时才写 `画面代称:无`,那是明确的弃权,不是省事。
38
+
39
+ ## Character:最小稳定识别集
40
+
41
+ 从剧本与 creator reference 中选择足以区别此人的持久锚点:
42
+
43
+ - 叙事身份与关系(用于消歧,不是外观替代品);
44
+ - 稳定的面部/头部比例、体态轮廓、永久特征;
45
+ - 基础发质/发际等稳定部分;具体梳法可属于 Look;
46
+ - 永久性饰物仅在确实不随 Look 变化时作为 anchor;
47
+ - 表演/声音的持续事实可写入 设定集,供后续提示词或 casting 参考,但不伪装成可见外观。
48
+
49
+ 锚点要**有区分度且能被观察**。“漂亮年轻女性”“霸总气质”“电影感”都不足以认人。
50
+ 也不要过度指定剧本没有要求的肤色、年龄、五官或身体特征;以
51
+ `creator_decision_needed` 暴露空缺。
52
+
53
+ 锚点集合里至少有一条在**侧面**成立、一条在**背面**成立。很多镜头只给到侧身、背影或
54
+ 远景,只在正脸可读的特征(眉眼间距、瞳色、唇形)不能是唯一识别通道;轮廓与重心、
55
+ 发型剪影与发际形状、肩背线、固定配饰的外形都可以承担这两个方向。写法示例:
56
+ `["方额窄下颌", "后颈发际收成尖角", "右肩比左肩低约两指、起步时先出右肩"]`——第一条正面
57
+ 成立,第二条背面成立,第三条侧面与背影都成立。
58
+
59
+ 同时写出全组**可比较的尺度次序**:谁高于谁、差多少量级,并给一个绝对参照点。示例:
60
+ 「甲最高,乙比甲矮约一个头,丙比乙再矮半头;甲站直时头顶与门框上沿齐平」。这条次序由
61
+ Character 拥有,换鞋、加厚外套、盘发都不改写它(那些属于 Look)。剧本没有给出身高
62
+ 关系时,以 `creator_decision_needed` 暴露,由创作者定,不由角色表模板的默认体型补齐。
63
+
64
+ 人物关系帮助理解谁控制空间、谁观察谁、谁会保护或攻击谁,但**不自动决定美丑、肤色、
65
+ 体型或面部善恶感**。主角不因“主角”字段自动变漂亮,反派也不因“反派”字段自动变丑。
66
+ 需要视觉层级时,从创作者已接受的社会位置、职业使用痕迹、轮廓区别、服装职责、姿态和
67
+ 调度中取证;审美理想化、夸张或反类型都是创作者选择,不能由关系标签偷偷补完。
68
+
69
+ **`reviewed_invariant` AST-04**: 临时淤青、制服、雨水、当天妆容不得成为 Character
70
+ 持久锚点,否则同一人恢复后会被误判成另一身份。
71
+
72
+ ## Look:一次相容的外观组合
73
+
74
+ 一个 Look 只容纳能同时存在的组合:
75
+
76
+ - 服装层次与鞋履;
77
+ - 发型整理、妆容、伪装;
78
+ - 伤势、包扎、污渍、湿度、天气化;
79
+ - 与身体绑定的可见配件;手持道具仍绑定 Prop,不吞进 Look;
80
+ - cause、valid_from、valid_until 和 source refs。
81
+
82
+ 写 Look 时先引用 Character identity,再只写相对 base/前一 Look 的差异。不要复制整段
83
+ 脸部描述形成第二份权威。
84
+
85
+ ## 可选声音方向:身份锚点不等于本场 delivery
86
+
87
+ **`AST-07 · reviewed_invariant`**:项目需要跨集保持声音时,可在 Character 记录 `voice_direction`:语言/方言范围、
88
+ **创作者授权的参考音频绑定**、用于选型与验收的判据、已接受的专名发音。紧张、淋雨、受伤、
89
+ 耳语、某句重音和临时音量属于场景/台词 delivery,不要固化成声音身份;变声、年龄跨度或
90
+ 伪装若跨段持续,则记录有来源和有效范围的变体。
91
+
92
+ 音色的载体是参考音频,不是一段文字描述。没有参考时保持 `reference: null` 并标「待选型」,
93
+ 不要用形容词冒充音色身份。参考绑定要写清这次借用它的什么、哪些内容不能跟着来
94
+ (那条参考里的情绪、录音空间、背景内容永远不进身份),以及证据到了哪一步——
95
+ 详见 [声音方向](voice-direction.md)。声音方向直接写在对应人物的 `视觉设定.md` 条目中,不另建
96
+ 配音表或第二份权威。
97
+
98
+ 文本引用只能保证角色、台词、声音方向与引用关系没有被改写,不能保证任何真实合成结果、
99
+ 口型或音色复现。引用使用 `视觉设定.md` 内的可见 ID,不把网址、外部任务字段或服务参数写进设定;
100
+ 参考音频本身留在 `输入/`,不复制进 `视觉设定.md`,也不进公开交付。
101
+
102
+ **资产阶段不生成音频,也不调用任何语音、合成或克隆服务**。 记录先落进文件、由创作者
103
+ 确认;实际 TTS 交给 `$short-drama-produce`,并须对它展示的本次任务预览明确确认。
104
+
105
+ ### 什么时候值得新 Look
106
+
107
+ **`craft_default` AST-03**: 满足任一条件时提议:跨多个 block/scene 持续;会重复使用;
108
+ 需要独立角色参考图;改变观众识别/剧情信息;下游必须精确绑定。瞬时表情、姿势、
109
+ 视线和手位由 shot/continuity 处理,通常不新建 Look。
110
+
111
+ ### 造型不能互相污染
112
+
113
+ - “工作服”和“庆典礼服”如果时空不重叠,就不能在同一 Look 中同时出现;
114
+ - 包扎在 source block 后才生效,前面镜头不能提前绑定;
115
+ - 外套脱下后仍是同一 Character,但应切换 Look 或记录可追踪的 layer delta;
116
+ - 若雨水只造成短暂局部湿痕,可用 delta;若跨集保持并需视觉复现,再升为 Look。
117
+
118
+ ## 制作形态与身份锚点的可表达性
119
+
120
+ 写最小稳定识别集之前,先读 `视觉设定.md` 的“项目视觉方向”和已明确的制作形态;尚未决定且会
121
+ 实质影响识别通道时,向创作者给出选择,不从对话记忆补造。
122
+
123
+ 原因很直接:**形态决定观众靠什么通道认人**,因而决定哪些锚点在这个项目里根本可被表达。
124
+
125
+ | 主要识别通道 | 值得写的锚点 | 写了也看不见的锚点 |
126
+ |---|---|---|
127
+ | 面部结构 | 面部比例、眉眼鼻唇相对关系、下颌与颧骨体积 | 只有大远景才成立的体量差 |
128
+ | 剪影与线条 | 轮廓与肩背重心、发型剪影与发际形状、固定配饰外形、服装廓形、步态负重 | 细微的五官不对称、浅色小痣、依赖真实皮肤纹理的痕迹 |
129
+ | 材质与表面 | 皮肤/毛发/布料的可比较表面状态、长期使用痕迹 | 需要柔和过渡才能读出的体积差 |
130
+
131
+ ### 写实细节与身份连续性
132
+
133
+ **`craft_default`**:写实项目可以在稳定识别特征之外,补充皮肤纹理、自然不对称或使用痕迹。
134
+ 远景中不易读出的细节,不宜单独承担跨镜识别。
135
+
136
+ 痣、疤和牙齿形态等如果是人物既定特征,仍须保持;不能因它们难生成就允许随镜变化。
137
+ 毛孔、细纹等微观纹理不必逐像素一致。是否需要这些细节由画面尺度与已接受风格决定。
138
+
139
+ **`taste_option`**:偶像化、漫画或其他风格可采用更平滑的表面,不以写实程度判错。
140
+
141
+ ### 边界:形态选通道,身份定事实
142
+
143
+ - **`reviewed_invariant`**:形态可以改变锚点的**表达通道与颗粒度**,不得改写身份事实本身。
144
+ 不能因为“不好画”把五十岁写成二十五岁、把厚重体格写成修长,也不能为了轮廓好看新增
145
+ 疤痕、异色瞳或不存在的配饰。
146
+ - 已确认身份在当前形态下找不到可靠表达通道时,标为“需创作者决定”:由创作者决定
147
+ 换形态还是改身份,资产环节不静默调整。
148
+ - Look 层同理:形态决定服装层次、材质响应能表达到多细,不决定 Look 由哪些单品组成,也不
149
+ 决定 cause、valid_from、valid_until。
150
+ - 形态同样不改写地理、持物归属、可读文字政策与故事状态;这四项分别属于 Location/View、
151
+ Prop/State、text policy 与 write/develop owner。
152
+
153
+ ### 模板槽位不得覆盖身份锚点
154
+
155
+ **`reviewed_invariant`**:模板槽位不得覆盖已确认的身份锚点;当模板默认值与当前身份冲突时,
156
+ **身份优先,模板让位**。
157
+
158
+ 合成例:角色甲的锚点是五十岁上下、体格厚重、肩背略沉。若角色表模板对每一条记录
159
+ 机械填入“九头身黄金比例、极度修长的双腿”,角色甲的身份就在没有任何创作者决定的情况下被
160
+ 改写;而且因为每个角色都带同一句,下游会把它读成风格统一,不会当成冲突。角色乙即使确实
161
+ 修长,也应由自己的当前视觉设定写出,不由模板默认值代写。
162
+
163
+ 排查方式:把同一批角色记录并排看,找出**逐字重复且与该角色无关**的描述句;不能追溯到某条
164
+ 当前视觉设定的,删除或改写成该角色的真实锚点,并在预览里说明改动。
165
+
166
+ ## 合成例:顾禾
167
+
168
+ Character `CHAR-GUHE` 的当前锚点:窄长脸、左眉尾短缺口、自然卷黑发、肩背略前倾。
169
+ 这些锚点不会因本集换装改变。
170
+
171
+ - `LOOK-GUHE-WORK`:灰绿工作夹克、深色长裤、头发低束;渡站值班期有效。
172
+ - `LOOK-GUHE-RAIN`:在工作装外加橙色旧雨衣,兜帽放下;从 SC004 出门前穿上,
173
+ 到 SC006 脱下。
174
+ - SC005 右肩湿痕:若只维持几镜,作为 delta 指向 `LOOK-GUHE-RAIN`,不是
175
+ `CHAR-GUHE-WET`。
176
+
177
+ 反例:“橙色雨衣女人,湿头发,脸上有伤”被直接写成 Character identity。这样雨衣
178
+ 脱下、头发变干、伤口愈合时,人物就失去所有所谓“身份锚点”。
179
+
180
+ ## 角色 设定集 的实用检查
181
+
182
+ - 去掉本集服装和伤污后,这个人还能与其他角色区分吗?
183
+ - 每个 Look 是否只引用一个 Character,并且内部状态能同时成立?
184
+ - 造型变化是否有 source/cause/validity,而不是凭审美换装?
185
+ - 相同显示名是否误合并,不同称谓是否误拆分?
186
+ - 手持物是否仍由 Prop/State 拥有,未被埋进角色描述?
187
+ - creator 是否接受了新增身份锚点,而不是系统替其补完?
188
+
189
+ 群演可以按制作需要使用 group Character;一旦某个个体有台词、关键交接或跨镜连续,
190
+ 应提议独立身份。此颗粒度是 **`taste_option`**,但选择要能满足故事追踪。
@@ -0,0 +1,120 @@
1
+ # 资产连续性与变化记录
2
+
3
+ ## 目录
4
+
5
+ - [边界匹配](#边界匹配-con-01)
6
+ - [状态表与变化记录](#状态表与变化记录的区别)
7
+ - [各环节负责什么](#各环节负责什么)
8
+ - [需要追踪的状态](#需要追踪的五组状态)
9
+ - [记录步骤](#写变化记录的步骤)
10
+ - [状态链示例](#合成状态链)
11
+ - [非线性时间](#非线性时间与有意断裂)
12
+ - [修订影响](#修订影响)
13
+ - [交接检查](#交接检查)
14
+
15
+ ## 边界匹配 (`CON-01`)
16
+
17
+ 对相连镜头,逐字段比较前一镜已接受的结束状态与下一镜已接受的开始状态。
18
+ 只有上游负责人已经记录变化,或负责人明确提出的修订仍在处理中,差异才有依据;
19
+ 不得靠运动提示词悄悄“补过去”。
20
+
21
+ ## 状态表与变化记录的区别
22
+
23
+ - **状态表**回答某个边界“现在是什么状态”。
24
+ - **变化记录**回答“什么发生了变化、变化前后分别是什么、原因是什么、何时生效、影响谁”。
25
+
26
+ 不要在每场复制完整设定表;只记录下游会依赖的状态和变化。这样既能发现无来源的跳变,
27
+ 也能在剧本修改后准确标记 `stale`,不必重做整个项目。
28
+
29
+ ## 各环节负责什么
30
+
31
+ 资产技能负责身份、资产版本和场景级资产状态变化,例如造型何时切换、道具何时转手、
32
+ 场景光线何时由正常变为停电。故事开发技能负责计划中的故事状态;剧本技能负责已经
33
+ 写出的知情情况、信念、目标、关系与权力、情绪变化及其故事意义。资产状态表只引用
34
+ 这些来源,不得在 `after` 中另写一套故事事实。
35
+
36
+ 分镜技能负责每个镜头的开始和结束边界,包括姿态、位置、目光、双手、持物和可见状态。
37
+ 资产可以引用这些边界,但不能另写一套相冲突的手位和走位。
38
+
39
+ **`structural_invariant` CON-04**: 每条变化都要有前态、后态、原因或来源、有效范围,以及受影响的
40
+ 现有 `IMG-...`、`SHOT-...` 或 `MOTION-...`。没有变化时不能只写“更新了”。
41
+
42
+ **`structural_invariant` CON-06**:受影响列表要覆盖所有已经存在的使用方;尚未建立的工作只说明
43
+ 负责 owner 和需要同步的事实,不预建占位记录。
44
+
45
+ ## 需要追踪的五组状态
46
+
47
+ 1. **人物的故事状态**:知情情况、信念、目标、关系与权力、情绪。只在它们会影响后续
48
+ 行动或审稿时追踪,并指向故事开发或剧本中的准确来源;它们不属于资产技能自行创造的变化。
49
+ 2. **人物的可见状态**:准确造型、伤势、污湿和场景级携带物。单镜内的姿势由分镜负责。
50
+ 3. **地点状态**:地点、观察视角、可用入口、时段、天气、光线和关键陈设。
51
+ 4. **道具状态**:准确版本、负责人、持有人、位置、状况、内容物和可读文字。
52
+ 5. **场次或集间交接**:上一场或上一集的结束状态、下一场或下一集的进入状态,以及
53
+ 依赖这些状态的提示词和镜头。
54
+
55
+ **`craft_default` CON-03**: 只跟踪后续可能引用的事实。顾禾鞋带的颜色若不影响识别或
56
+ 动作,不必在每场重复;她带走的唯一号牌必须进入结束状态。
57
+
58
+ ## 写变化记录的步骤
59
+
60
+ 1. 在资产出现记录中发现明确变化或边界不一致。
61
+ 2. 读取 `视觉设定.md` 中上一处明确状态,绝不从下游提示词反推。
62
+ 3. 写清单一的 `before` 和 `after`;一个复合事件可以拆成多条同因变化。
63
+ 4. 写明导致变化的场景 ID、动作/对白或视觉设定条目,让原因能在当前五文档中直接核对。
64
+ 5. 声明从哪个剧本段、场次或集开始生效,到何时结束;没有明确终点时写 `open_ended`。
65
+ 6. 已经存在的使用方列出受影响的 `IMG-...`、`SHOT-...` 或 `MOTION-...`;未来工作只说明需要
66
+ 同步,不预建占位引用。
67
+ 7. 与下一处相连的开始状态比较:一致就通过,不一致就明确提出修订。
68
+
69
+ ### “未知”不等于“恢复默认”
70
+
71
+ 上一集结尾人物仍带伤,本集没有提伤势,不能自动恢复为无伤。保留最后一次确认的状态,
72
+ 并建立 `unresolved` 的连续性问题:仍然带伤、发生了有意省略的治疗,还是剧本遗漏?
73
+
74
+ ### 知道事实不等于知道对方也知道
75
+
76
+ 身份或秘密场景至少区分:甲是否知道事实、乙是否知道事实、甲是否知道乙已经知道。
77
+ 如果本集进入状态已经声明“双方互知身份”,就不能把“他确认对方认出自己”当成本集
78
+ 新的揭示。要么修正进入状态,要么重新说明本场真正改变的是哪种信念或策略。
79
+
80
+ ### 有来源不等于变化合理
81
+
82
+ 引用某个剧本段只能证明变化有文字来源,不能自动证明因果成立。例如“灯闪了一下”
83
+ 不足以解释整栋渡站永久断电。**`reviewed_invariant` CON-02**: 审查者要结合剧本
84
+ 证据,判断伤势、知情情况、道具归属、天气和光线变化是否可信;字段非空不能代替判断。
85
+
86
+ ## 合成状态链
87
+
88
+ SC004 开始:顾禾穿 `LOOK-GUHE-RAIN`;铁皮匣闭合,号牌在里面;值班室灯亮。
89
+
90
+ 1. 她开匣取牌:匣从“闭合、装有号牌”变为“打开、空”;号牌从匣内转到顾禾右手。
91
+ 2. 她把号牌交给魏叔:号牌从顾禾右手转到魏叔右手,原因指向交付动作。
92
+ 3. 配电箱跳闸:场景由正常夜间照明变为停电,直到维修;若集末仍未维修就写 `open_ended`。
93
+ 4. 暴雨从破窗打湿雨衣右肩:人物可见状态变湿;若跨集复用或需要参考图,再建立新造型版本。
94
+
95
+ 结束状态至少声明:魏叔持号牌、铁皮匣空且打开、值班室断电、顾禾雨衣右肩湿。
96
+ 下一集若直接写顾禾手持号牌,必须有归还记录或由创作者接受的修订,不能静默“对齐”。
97
+
98
+ ## 非线性时间与有意断裂
99
+
100
+ 蒙太奇、省略、梦境和主观画面可以不遵守普通的前后相接,但要明确写出断裂类型、
101
+ 进入和退出边界,以及哪些状态仍可信。这属于 **`taste_option` CON-05**,不是逃避记录的
102
+ 理由。闪回不会重写当前时间线的状态表;它在自己的时间分支中使用相应的历史版本。
103
+
104
+ ## 修订影响
105
+
106
+ - 修改伤势开始的剧本段:列出直接读取该段的造型、提示词、镜头或运动提示词;需要刷新时由各 owner 更新。
107
+ - 只修改道具显示名,ID 和事实不变:通常只更新显示文本,不重做无关分镜。
108
+ - 修改镜头构图:不自动修改资产文件。
109
+ - 修改截图说明或提示词文案:不得反向改写当前视觉状态。
110
+
111
+ ## 交接检查
112
+
113
+ - 每个相连镜头的结束状态与下一镜开始状态一致,或已有负责人明确提出修订。
114
+ - 转手同时说明从谁手中到谁手中,物件不会在两人手里复制。
115
+ - 伤势、造型、天气和光线不会无原因复位。
116
+ - 道具内容状态与人物知情情况分开记录。
117
+ - 变化的有效范围覆盖所有依赖镜头,而且不会提前生效。
118
+ - 受影响列表覆盖所有已经存在的提示词、镜头和运动提示词使用方;修订时重新
119
+ 计算实际使用方,不只沿用旧清单。
120
+ - 结束状态足以让下一集继续,不依赖创作者脑内记忆。
@@ -0,0 +1,122 @@
1
+ # 跨镜一致性锁
2
+
3
+ ## 目录
4
+
5
+ - [为什么识别锚点还不够](#为什么识别锚点还不够)
6
+ - [什么值得上锁](#什么值得上一把锁)
7
+ - [锁面怎么写](#锁面怎么写)
8
+ - [语法](#语法)
9
+ - [谁负责把锁面带走](#谁负责把锁面带走)
10
+ - [反例](#反例)
11
+ - [校验](#校验)
12
+
13
+ ## 为什么识别锚点还不够
14
+
15
+ 识别锚点是写给创作者读的事实;执行端读不到它,只读得到每条提示词自己的正文。同一件毛衣第一镜
16
+ 织的是蓝色、第二镜变成红色,通常不是资产写错了,而是**没有任何一条提示词把颜色带进去**:视觉
17
+ 设定写了,关键帧写了一半,运动提示词以为参考帧已经交代过就把重复描述删掉了。
18
+
19
+ 参考图也补不上这一层。一张角色板只能约束它自己画到的部分;正在编织、只成形一半的毛衣,被手挡住
20
+ 的道具,每镜重新构图的服装细节,都落在身份参考“默认不能控制”的一侧。
21
+
22
+ 一致性锁补的就是这一段:把跨镜不变的那几个字固定下来,并要求它原样出现在每条受影响的提示词里。
23
+
24
+ ## 什么值得上一把锁
25
+
26
+ 三条同时成立才值得上锁:
27
+
28
+ 1. 这个可见事实在本集出现于两个以上镜头,或一个镜头加一张资产板;
29
+ 2. 观众能直接看出前后不一致;
30
+ 3. 它不随剧情改变——会变的是状态,**状态不上锁**。
31
+
32
+ 典型:服装主色与形制、道具主色与材质、发型长度、伤口位置与形状、招牌或界面的形制配色。
33
+ 不典型:情绪、姿势、左右手、镜头角度、时段光线、破损进度、持有人——这些是状态或镜头瞬态,
34
+ 分别归 `本集状态` 与分镜。
35
+
36
+ **`craft_default`**: 一集里的锁通常是个位数。把每条识别锚点都升级成锁,每条提示词都会被同一串
37
+ 名词短语撑满,反而挤掉本镜真正要执行的动作。
38
+
39
+ ## 锁面怎么写
40
+
41
+ `锁面` 是**要被逐字带进提示词正文的那一小段字**,不是描述,也不是给人读的说明:
42
+
43
+ - 锁面必须**逐字出现在它管到的每一份可复制正文里**。校验器会在三处查同一个字符串:
44
+ 图片提示词正文、冻结关键帧提示词、视频提示词正文。
45
+ - 图片与冻结关键帧使用 `format/prompt_language`,视频可能使用另选的 `video_prompt_language`。
46
+ 语言不同时,优先使用确实适合各份正文的共同色值、型号或专名。
47
+ 当前 `镜头:` 同时约束本镜首帧与视频正文,不能靠拆成两把锁分别约束两种语言。
48
+ 没有合适共同词组时,在视觉设定中保留事实并报告此限制,暂不声明这把逐字锁;
49
+ 不缩小事实实际出现的镜头范围来绕过检查,也不自行改变用户选择的正文语言。
50
+
51
+ - 只保留最小可辨识名词短语,通常是「颜色 + 材质/形制 + 物体」,例如
52
+ `pale blue chunky knit wool sweater`;
53
+ - 不含句号、动作、状态、数量、镜头信息和剧情;
54
+ - 不写会随镜头变化的词(`in her hands`、`half-finished`、`on the sofa`);
55
+ - 一个实体一把锁;同一实体的两种造型是两把锁,各写各的生效镜头。
56
+
57
+ 比较时忽略大小写,换行按空格处理(可复制正文本来就渲染成一段,硬折行不影响匹配),其余字符
58
+ 逐字比较。提示词可以在锁面前后接语法(`she keeps knitting the pale blue chunky knit wool
59
+ sweater`),但不能改写锁面内部——少一个 `stand-collar`、多一个逗号都算漂移。
60
+
61
+ 还有两处刻意不算数,因为它们看起来命中、实际并没有把事实写进画面:
62
+
63
+ - **粘在词上的匹配不算**。锁面首尾是字母数字时,紧挨着的字母数字或连字符会让它落空:
64
+ `chipped white enamel mug` 不被 `unchipped white enamel mug` 满足,
65
+ `pale blue knit` 不被 `pale blue knitwear-print fleece` 满足。锁面要能作为一个完整的词组读出来。
66
+ - **负面提示词里的匹配不算**。写在 `no`/`not`/`without`/`avoid` 或 `不要`/`不能`/`没有`/`避免`
67
+ 之后的锁面说的是「不要出现它」,正好与锁的目的相反;`..., no pale blue chunky knit wool
68
+ sweater` 不能作为锁面在场的证据。锁面必须出现在描述画面内容的正文里。
69
+ 「粘在词上」只对 ASCII 词生效——中文本来不分词,`织着浅蓝色粗棒针毛线` 正常命中。
70
+
71
+ ## 语法
72
+
73
+ 写在 `视觉设定.md` 对应资产条目下,与识别锚点并列:
74
+
75
+ ```markdown
76
+ ## 道具 · 织了一半的毛衣
77
+
78
+ - 识别锚点:浅蓝色粗棒针手织毛线,竹制棒针两根,衣身只织到胸口。
79
+ - 本集状态:SC002 起衣身加长约一掌;颜色与针法不变。
80
+ - 连续性锁:LOCK-KNIT《织了一半的毛衣》(镜头:全集;图片提示词项:IMG-PROP-KNIT)· 锁面:pale blue chunky knit wool sweater
81
+ ```
82
+
83
+ - 列表记号写 `-`、`*` 还是 `+`,缩进几格,都不影响识别;一条看起来像锁却写不完整的行会被
84
+ 报成语法错误,不会被悄悄跳过——锁不能变成空转;
85
+ - `LOCK-...`:本集唯一稳定 ID,与 `IMG-...`、`REF-...`、`SHOT-...` 互不混用;
86
+ - `《中文名》`:给创作者读的名称,必须含中文;
87
+ - `镜头:`:`全集`,或 `、` 分隔的 `SHOT-...` 列表;两者不能混写;
88
+ - `图片提示词项:`:可选,`、` 分隔的 `IMG-...` 列表,整段省略即表示不约束图片提示词;
89
+ - `锁面:`:被逐字带走的那段字,写在行尾。
90
+
91
+ ## 谁负责把锁面带走
92
+
93
+ | 文档 | 义务 |
94
+ |---|---|
95
+ | `图片提示词.md` | 被点名的 `IMG-...` 可复制正文含锁面,让参考图本身就是对的 |
96
+ | `分镜.md` | 生效镜头的冻结关键帧提示词含锁面 |
97
+ | `视频提示词.md` | 对应 `MOTION-...` 可复制正文含锁面 |
98
+
99
+ **`structural_invariant` CON-07**: 锁面在生效范围内不得以“参考帧已经交代过”为由删除。图生视频
100
+ 删掉重复的静态描述是常规做法,但锁面是这条常规做法写明的例外——它正是为了挡住跨镜漂移才存在。
101
+
102
+ 状态变化不进锁面:毛衣越织越长写在 `本集状态`,颜色和针法写在锁面。两者同时存在时,提示词自己
103
+ 写长度,锁面负责颜色和针法。
104
+
105
+ ## 反例
106
+
107
+ - `锁面:蓝色毛衣`——提示词正文是英文时永远匹配不上,且“蓝色”分不出浅蓝和藏青;
108
+ - `锁面:a pale blue sweater that she has been knitting since the first scene`——含剧情和时态,
109
+ 下一镜必须改写它,锁当场失效;
110
+ - `锁面:high quality, detailed`——不是可辨识事实,锁住了也证明不了一致;
111
+ - 只把锁的 `镜头` 范围写到「文字已经对的那几镜」——范围要按这个事实**实际出现在哪几镜**来写,
112
+ 按已经写对的地方来写,等于把校验器指向没有风险的位置;
113
+ - 把 `镜头:全集` 用在只出现两镜的道具上——其余镜头会被迫写入与本镜无关的名词。
114
+
115
+ ## 校验
116
+
117
+ ```bash
118
+ python3 <core 技能目录>/scripts/creator_markdown_check.py 剧集/<EP> --project-root .
119
+ ```
120
+
121
+ 它只机械核对语法、范围可解析,以及锁面是否真的出现在被点名的正文里。该不该上这把锁、锁面写得
122
+ 准不准,仍由创作者和审查判断。
@@ -0,0 +1,140 @@
1
+ # 身份、版本与复用判断
2
+
3
+ ## 目录
4
+
5
+ - [三个问题](#三个问题)
6
+ - [身份与状态](#持续身份与可变状态)
7
+ - [判断步骤](#判断步骤)
8
+ - [容易误判的情况](#容易误判的情况)
9
+ - [合成示例](#合成判断例)
10
+ - [决定记录](#决定记录要说明理由)
11
+ - [制作案例](#制作案例说明)
12
+
13
+ ## 三个问题
14
+
15
+ 不要先问“要不要新建文件”,按顺序问:
16
+
17
+ 1. **持续身份是否相同**? 去掉临时状态后,人物、空间或物体仍是不是同一个?
18
+ 2. **下游是否需要区分一个可复用状态**? 变化会持续、再次出现,或影响参考图、
19
+ 分镜绑定和连续性吗?
20
+ 3. **若不建新版本,只写变化记录是否够用**? 一瞬的动作、姿势、表情或摄影机角度,
21
+ 通常交给出现记录、连续性或镜头,不要为它们建立大量资产组合。
22
+
23
+ 结果只能是 `reuse`、`new_variant`、`new_asset` 或 `unresolved`。
24
+ **`structural_invariant`**: 不能用“已处理”代替这四类,也不能让未决项带着假 ID 流入下游。
25
+
26
+ ## 持续身份与可变状态
27
+
28
+ | 类别 | 持续身份通常由什么区分 | 通常属于版本或状态 | 通常不建新版本 |
29
+ |---|---|---|---|
30
+ | 人物 | 同一人物、稳定面部与体态、永久特征、叙事身份 | 服装、发型整理、妆容、伤势、污湿、年龄阶段、伪装 | 瞬时表情、姿势、视线、景别 |
31
+ | 地点 | 同一空间地理、分区关系、入口、固定锚点、主要材料 | 可复用观察视角、陈设阶段、时段、天气、光线状态 | 单一镜头角度、焦段、演员站位 |
32
+ | 道具 | 同一物件或同一可复用型号的形制、尺度、材料、功能、唯一标记 | 持有人、持有手、位置、开闭、破损、内容物、文字、启停 | 被抬起的一瞬、画面左右位置 |
33
+
34
+ 这张表属于 **`craft_default`**,不是见词建档的公式。变化是否值得成为新版本,取决于
35
+ 持续时间、重复使用、故事辨识度和下游绑定需要。
36
+
37
+ ## 判断步骤
38
+
39
+ ### A. 先排除“只属于镜头的事实”
40
+
41
+ “侧脸”“从背后看”“俯拍柜台”“杯子在画面右侧”都不改变资产。若事实只在一个镜头的
42
+ 一瞬成立,就交给分镜边界或关键帧。
43
+
44
+ ### B. 寻找同一身份的证据
45
+
46
+ 用已有 ID 的稳定识别点、剧情连续、来源与去向和唯一标记来对齐,不要只按显示名。
47
+ 两个都叫“值班员”的人不一定是同一个;同一人换了称谓也不会因此变成另一个人。
48
+
49
+ ### C. 判断变化是否值得建立新版本
50
+
51
+ 同时问:
52
+
53
+ - 有明确原因和来源吗?例如换装、受伤、停电、拆封、转交。
54
+ - 有清楚的有效范围吗?从哪个剧本段、场次或集生效,到何时失效或仍未知。
55
+ - 下游需要准确选择吗?角色带伤跨三场时,造型版本值得建立;手指刚沾一滴水又擦掉,
56
+ 一条变化记录可能就够了。
57
+ - 它能否只写差异,而不篡改基础身份?新版本只写变化,不重写成另一个身份。
58
+
59
+ 在 `视觉设定.md` 中把基础身份与当前变体放在同一项目下。变体只写相对基础身份发生的变化;
60
+ 跨文档需要引用视觉事实时直接使用该项目标题;只有引用《图片提示词.md》的可见提示词条目时才使用
61
+ 稳定 `IMG-...` ID。`IMG-...` 不表示真实图片,不建立隐藏的来源声明。
62
+
63
+ ### D. 只有持续身份不同才建新资产
64
+
65
+ - 剧本确认是另一个人,即使穿着相同。
66
+ - 空间拥有不同地理、入口或固定锚点,即使同属一个建筑。
67
+ - 两件需要独立追踪的同款物件,或形制、功能、材料身份真正不同。
68
+
69
+ 证据不足时选择 `unresolved`,不要靠常识补齐。
70
+
71
+ ## 容易误判的情况
72
+
73
+ ### 年龄、替身与伪装
74
+
75
+ - 同一人物的少年和成年阶段通常是不同造型版本。即使制作上由不同演员扮演,仍可以
76
+ 保持一个人物身份,并在造型版本中写明表演或演员限制。
77
+ - 剧情中的双胞胎、复制体和冒名者是不同人物,即使视觉识别点近似。
78
+ - 易容或制服伪装是造型版本,不要把“伪装身份”写成真实人物身份。观众暂时不知道时,
79
+ 可以限制显示名,但不能破坏内部事实。
80
+
81
+ ### 同址空间
82
+
83
+ “渡站大厅”和“渡站值班室”若有各自可制作的地理和入口,适合建立两个地点,再用关系
84
+ 引用连接;不要把整栋建筑所有房间塞进一组观察视角。相反,同一值班室停电前后仍是
85
+ 同一地点,不因光线变化新建地点。
86
+
87
+ ### 同款多件道具
88
+
89
+ 两枚外观相同、分别由不同人物保管并且会被交换的号牌,需要两个道具身份;十只没有
90
+ 连续性要求的白杯可以作为一类普通布景。是否逐件建立身份由故事追踪需要决定,不由
91
+ 外观相似决定。
92
+
93
+ ### 损坏与改造
94
+
95
+ 裂纹、血迹、装入文件通常属于道具状态。若物体被不可逆地改造成另一种功能,例如门牌
96
+ 被熔成钥匙,而且之后按新物件使用,可以提出新资产,并保留由原物改造而来的关系。
97
+ 这个决定需要创作者接受。
98
+
99
+ ## 合成判断例
100
+
101
+ 已有 `CHAR-GUHE` 与 `LOOK-GUHE-WORK`。本集顾禾套上橙色雨衣进入渡站,第三场雨衣
102
+ 右肩被淋湿。
103
+
104
+ - 橙色雨衣会跨两场并用于参考图:选择 `new_variant`,基础身份仍是顾禾,不是新角色。
105
+ - 右肩湿痕只持续半场:先写连续性变化,不必自动生成第三个造型版本。
106
+ - 若下一集仍需准确复现湿痕并绑定参考图,再由创作者接受一个湿雨衣造型版本。
107
+
108
+ 若文本只写“穿橙雨衣的人”,且无法证明就是顾禾,决定必须保持 `unresolved`。
109
+
110
+ ## 决定记录要说明理由
111
+
112
+ 每条决定至少展示:来源场景、选择、稳定证据、差异、原因、有效范围和下游影响。
113
+
114
+ - `new_asset` 要说明为什么不能复用现有资产。
115
+ - `new_variant` 要说明基础身份中哪些内容不变。
116
+ - `reuse` 要说明现有版本怎样覆盖本次事实。
117
+
118
+ 能从剧本与既有视觉事实直接判断的内容直接写入 `视觉设定.md`;真正存在多个成立选择时,把它标为
119
+ “未决”并列出会改变的下游影响,等创作者选择后再改正文。不要伪造决定 ID、接受状态或额外决策文件。
120
+
121
+ **`reviewed_invariant` AST-04**: 审查者检查身份识别点与临时状态是否混写,不以
122
+ “资产越少越好”作为评价标准。
123
+
124
+ ## 制作案例说明
125
+
126
+ 对完整制作链的定性案例阅读表明,下面这些命名和拆分做法可以减少换装、伤势和观察
127
+ 视角变化带来的重复资产。它们属于可调整的常用做法,不是固定格式:
128
+
129
+ - **版本后缀命名**:同一人物的状态或造型放在身份名之后,例如“苏某—火灾后无伤”
130
+ 或“祁某—红色礼服”。下游一眼就能看出身份和当前版本。
131
+ - **空间按观察方向区分**:同一地点可以按方向或分区命名,例如“医院走廊(北)”和
132
+ “办公室(东)”,每个观察视角可以单独绑定参考图。
133
+ - **稳定识别字段**:性别、年龄段和人物类别可以用于制作追踪。少年到成年这样的大跨度,
134
+ 通常用不同造型版本处理。
135
+ - **参考图绑定**:需要稳定识别的人物和空间逐一绑定参考图;没有个体连续性的路人按
136
+ 普通布景处理,不必建立身份。
137
+ - **命名分层**:主角可用实名;功能人物可用姓氏加职务;只作背景的人物可用类型加序号。
138
+ 资产名与描述中的名字必须一致,不能写甲的名字却描述乙。
139
+ - **持续多集的大状态**:被俘或重伤若会持续多集,可以直接建立新的造型参考。若状态只
140
+ 在一镜内发生,就先留在镜头边界或变化记录中,不要提前扩张资产表。
@@ -0,0 +1,84 @@
1
+ # Location / View 设计
2
+
3
+ ## 分工
4
+
5
+ - **Location** 保存空间身份:可行走的地理、分区关系、入口、固定锚点和主要材料。
6
+ - **View** 保存可复用的观看方向/生产状态:面向哪个区域、哪些锚点同时可见,以及
7
+ 陈设阶段、时段、天气、光态。
8
+
9
+ Location 不是场景标题字符串,View 也不是每个相机角度。目标是让参考图、分镜和相邻
10
+ 镜头共享同一空间逻辑,而不是为每镜创建“新场景”。
11
+
12
+ ## 先画脑内平面,再写氛围
13
+
14
+ 读取剧本时先整理:
15
+
16
+ 1. 内/外与可通行边界;
17
+ 2. 区域之间的相对关系;
18
+ 3. 人和道具会使用的入口/出口;
19
+ 4. 不能移动的识别锚点;
20
+ 5. 主要材料、尺度和功能;
21
+ 6. 剧本明确的时间、天气与有因果的光源。
22
+
23
+ “潮湿、压迫、怀旧”可以辅助气氛,却不能替代“北门通走廊、窗口面向河面、配电箱
24
+ 在柜台后”这样的地理事实。也不能为了画面好看新增一扇后来影响追逐路线的门。
25
+
26
+ ## Location 边界
27
+
28
+ ### 新 Location
29
+
30
+ 当空间具有不同、可独立生产的地理/入口/固定锚点时新建。例如同一渡站建筑里的候船
31
+ 厅和值班室各自有完整动作和明确连接,适合两个 Location,并记录 `connected_to`。
32
+
33
+ ### 同一 Location
34
+
35
+ 停电前后、白天夜晚、晴雨、临时布置变化都不改变空间身份。若只因镜头转向就新建
36
+ 地点,会让门窗方向和演员动线互相矛盾。
37
+
38
+ **`reviewed_invariant` AST-04**: 固定地理与临时时段/天气/灯光不得混成两个
39
+ Location identity。
40
+
41
+ ## View 边界
42
+
43
+ View 值得存在,是因为下游要反复引用一种稳定、能说明空间的方向或状态:
44
+
45
+ - 从柜台侧朝北门,能同时看到门、河窗和配电箱;
46
+ - 停电后的同方向,主灯灭、只剩河窗冷光;
47
+ - 暴雨期外景,站牌、台阶和河岸关系保持,天气和地面状态变化。
48
+
49
+ 单纯“低机位”“特写门把手”“35mm”属于 shot/keyframe,不建 View。演员站在左边也
50
+ 不是地点事实。**`craft_default` AST-03**: 一组镜头能共用方向/状态并需要参考 plate
51
+ 时才建 View。
52
+
53
+ ## 光、天气和陈设必须有来源
54
+
55
+ - 剧本写停电,则 View 可从 `normal_night` 变为 `blackout`,cause 指向断电 block;
56
+ - 创作者选择蓝调夜景是 visual direction,可记录 creator source;
57
+ - 不能因 prompt 惯性擅加霓虹、雾、逆光或移动窗户;
58
+ - 临时海报、散落文件、积水若会影响故事/连续性,进入 View state 或 delta;普通可替换
59
+ 装饰可留作 set dressing。
60
+
61
+ ## 合成例:旧渡站值班室
62
+
63
+ `LOC-FERRY-OFFICE`:狭长室内;北门通候船厅;东侧河窗;西侧整面旧柜台;配电箱
64
+ 固定在柜台后墙。Location 不写“夜”“暴雨”“顾禾站在门口”。
65
+
66
+ - `VIEW-FERRY-OFFICE-NORTH-NIGHT`:从柜台内侧朝北门,河窗位于画面右后方;夜间
67
+ 顶灯正常,柜台上只有铁皮匣。
68
+ - `VIEW-FERRY-OFFICE-NORTH-BLACKOUT`:同一地理和方向;断电后顶灯灭,河窗冷光
69
+ 保留,铁皮匣位置不变。它是 View/state 变体,不是“黑暗值班室”新 Location。
70
+
71
+ 如果剧本只需要一次门把手特写,无需 `VIEW-FERRY-OFFICE-DOOR-CLOSEUP`;镜头可以
72
+ 引用 Location/既有 View 后自行拥有 framing。
73
+
74
+ ## 检查问题
75
+
76
+ - 不看氛围词,仍能判断入口、固定锚点和区域关系吗?
77
+ - 同一空间各 View 的门窗/光向是否保持可调和?
78
+ - View 是否错误拥有相机焦段、演员站位或 shot boundary?
79
+ - 时段、天气、光态与陈设变化有 source/cause/validity 吗?
80
+ - 相邻空间该拆 Location 还是做 View,是否依据地理和制作复用,而非名称习惯?
81
+ - creator 是否明确选择空景/含角色政策?该政策由后续 image prompt 具体实现。
82
+
83
+ 空间拆分颗粒度可以是 **`taste_option`**;但无论选粗或细,入口关系和连续性必须可
84
+ 解释,不能用风格选择掩盖矛盾。