@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.
- package/README.md +8 -0
- package/docs/THIRD_PARTY_LICENSES.md +13 -0
- package/docs/attachment-storage.md +18 -0
- package/docs/director-skills.md +24 -0
- package/docs/long-task-continuation.md +51 -0
- package/docs/releases/2.5.0.md +13 -0
- package/docs/releases/2.6.0.md +11 -0
- package/docs/releases/2.7.0.md +21 -0
- package/lib/agent-runtime.d.ts +9 -1
- package/lib/agent-runtime.d.ts.map +1 -1
- package/lib/agent-runtime.js +117 -17
- package/lib/agent-runtime.js.map +1 -1
- package/lib/api/features/attachments-api.d.ts.map +1 -1
- package/lib/api/features/attachments-api.js +31 -1
- package/lib/api/features/attachments-api.js.map +1 -1
- package/lib/api.d.ts +1 -1
- package/lib/api.d.ts.map +1 -1
- package/lib/api.js +1 -1
- package/lib/api.js.map +1 -1
- package/lib/attachments/grouped-storage.d.ts +5 -0
- package/lib/attachments/grouped-storage.d.ts.map +1 -0
- package/lib/attachments/grouped-storage.js +47 -0
- package/lib/attachments/grouped-storage.js.map +1 -0
- package/lib/attachments/service.d.ts +17 -0
- package/lib/attachments/service.d.ts.map +1 -1
- package/lib/attachments/service.js +100 -8
- package/lib/attachments/service.js.map +1 -1
- package/lib/attachments/shared-storage.d.ts +7 -0
- package/lib/attachments/shared-storage.d.ts.map +1 -0
- package/lib/attachments/shared-storage.js +44 -0
- package/lib/attachments/shared-storage.js.map +1 -0
- package/lib/attachments/storage-admin.d.ts +6 -0
- package/lib/attachments/storage-admin.d.ts.map +1 -0
- package/lib/attachments/storage-admin.js +43 -0
- package/lib/attachments/storage-admin.js.map +1 -0
- package/lib/attachments/storage-types.d.ts +33 -0
- package/lib/attachments/storage-types.d.ts.map +1 -0
- package/lib/attachments/storage-types.js +2 -0
- package/lib/attachments/storage-types.js.map +1 -0
- package/lib/attachments/tool.d.ts.map +1 -1
- package/lib/attachments/tool.js +16 -5
- package/lib/attachments/tool.js.map +1 -1
- package/lib/channels/delivery-policy.d.ts.map +1 -1
- package/lib/channels/delivery-policy.js +7 -4
- package/lib/channels/delivery-policy.js.map +1 -1
- package/lib/channels/direct/message-format.js +418 -281
- package/lib/channels/direct/message-format.js.map +4 -4
- package/lib/channels/manager.d.ts +7 -3
- package/lib/channels/manager.d.ts.map +1 -1
- package/lib/channels/manager.js +73 -38
- package/lib/channels/manager.js.map +1 -1
- package/lib/channels/weixin/api.d.ts.map +1 -1
- package/lib/channels/weixin/api.js +7 -2
- package/lib/channels/weixin/api.js.map +1 -1
- package/lib/channels/weixin/errors.d.ts +14 -0
- package/lib/channels/weixin/errors.d.ts.map +1 -0
- package/lib/channels/weixin/errors.js +29 -0
- package/lib/channels/weixin/errors.js.map +1 -0
- package/lib/channels/weixin/poll.d.ts +14 -0
- package/lib/channels/weixin/poll.d.ts.map +1 -0
- package/lib/channels/weixin/poll.js +50 -0
- package/lib/channels/weixin/poll.js.map +1 -0
- package/lib/client-api.d.ts +1 -23
- package/lib/client-api.d.ts.map +1 -1
- package/lib/client-api.js.map +1 -1
- package/lib/client-controller.d.ts.map +1 -1
- package/lib/client-controller.js +3 -3
- package/lib/client-controller.js.map +1 -1
- package/lib/client.d.ts.map +1 -1
- package/lib/client.js +1078 -679
- package/lib/client.js.map +4 -4
- package/lib/collaboration/composition.d.ts.map +1 -1
- package/lib/collaboration/composition.js +32 -8
- package/lib/collaboration/composition.js.map +1 -1
- package/lib/collaboration/domain.d.ts +8 -0
- package/lib/collaboration/domain.d.ts.map +1 -1
- package/lib/collaboration/domain.js.map +1 -1
- package/lib/collaboration/service.d.ts.map +1 -1
- package/lib/collaboration/service.js +38 -5
- package/lib/collaboration/service.js.map +1 -1
- package/lib/concern-notification.d.ts.map +1 -1
- package/lib/concern-notification.js +2 -1
- package/lib/concern-notification.js.map +1 -1
- package/lib/concern-tool.js +1 -1
- package/lib/concern-tool.js.map +1 -1
- package/lib/execution/reply-progress.d.ts.map +1 -1
- package/lib/execution/reply-progress.js +4 -2
- package/lib/execution/reply-progress.js.map +1 -1
- package/lib/execution/service.d.ts +1 -1
- package/lib/execution/service.d.ts.map +1 -1
- package/lib/execution/service.js +4 -7
- package/lib/execution/service.js.map +1 -1
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +7 -1
- package/lib/index.js.map +1 -1
- package/lib/memory-reflection.js +2 -2
- package/lib/memory-reflection.js.map +1 -1
- package/lib/message-source.d.ts +25 -0
- package/lib/message-source.d.ts.map +1 -0
- package/lib/message-source.js +8 -0
- package/lib/message-source.js.map +1 -0
- package/lib/observation-loop.js +4 -4
- package/lib/observation-loop.js.map +1 -1
- package/lib/pendant/reader.js +1 -1
- package/lib/pendant/reader.js.map +1 -1
- package/lib/pendant/settings-panel.js +1 -1
- package/lib/pendant/settings-panel.js.map +1 -1
- package/lib/persona/service.js +1 -1
- package/lib/persona/service.js.map +1 -1
- package/lib/requirements/attachments.d.ts +7 -0
- package/lib/requirements/attachments.d.ts.map +1 -0
- package/lib/requirements/attachments.js +26 -0
- package/lib/requirements/attachments.js.map +1 -0
- package/lib/requirements/domain.d.ts +1 -1
- package/lib/requirements/domain.d.ts.map +1 -1
- package/lib/requirements/service.d.ts.map +1 -1
- package/lib/requirements/service.js +4 -1
- package/lib/requirements/service.js.map +1 -1
- package/lib/scheduler/channel-origin.d.ts +7 -0
- package/lib/scheduler/channel-origin.d.ts.map +1 -0
- package/lib/scheduler/channel-origin.js +27 -0
- package/lib/scheduler/channel-origin.js.map +1 -0
- package/lib/scheduler/continuations.d.ts +29 -0
- package/lib/scheduler/continuations.d.ts.map +1 -0
- package/lib/scheduler/continuations.js +286 -0
- package/lib/scheduler/continuations.js.map +1 -0
- package/lib/scheduler/domain.d.ts +40 -0
- package/lib/scheduler/domain.d.ts.map +1 -1
- package/lib/scheduler/final-reply.d.ts +13 -0
- package/lib/scheduler/final-reply.d.ts.map +1 -0
- package/lib/scheduler/final-reply.js +21 -0
- package/lib/scheduler/final-reply.js.map +1 -0
- package/lib/scheduler/service.d.ts +2 -0
- package/lib/scheduler/service.d.ts.map +1 -1
- package/lib/scheduler/service.js +30 -1
- package/lib/scheduler/service.js.map +1 -1
- package/lib/scheduler/wakeup-context.d.ts +7 -0
- package/lib/scheduler/wakeup-context.d.ts.map +1 -0
- package/lib/scheduler/wakeup-context.js +14 -0
- package/lib/scheduler/wakeup-context.js.map +1 -0
- package/lib/scheduler/wakeup.d.ts +11 -0
- package/lib/scheduler/wakeup.d.ts.map +1 -0
- package/lib/scheduler/wakeup.js +52 -0
- package/lib/scheduler/wakeup.js.map +1 -0
- package/lib/skills/builtin-resources.d.ts +6 -0
- package/lib/skills/builtin-resources.d.ts.map +1 -0
- package/lib/skills/builtin-resources.js +47 -0
- package/lib/skills/builtin-resources.js.map +1 -0
- package/lib/skills/builtin.d.ts +2 -5
- package/lib/skills/builtin.d.ts.map +1 -1
- package/lib/skills/builtin.js +11 -0
- package/lib/skills/builtin.js.map +1 -1
- package/lib/skills/director-builtins.d.ts +8 -0
- package/lib/skills/director-builtins.d.ts.map +1 -0
- package/lib/skills/director-builtins.js +65 -0
- package/lib/skills/director-builtins.js.map +1 -0
- package/lib/skills/drama-builtin.d.ts +3 -0
- package/lib/skills/drama-builtin.d.ts.map +1 -0
- package/lib/skills/drama-builtin.js +49 -0
- package/lib/skills/drama-builtin.js.map +1 -0
- package/lib/skills/long-task-continuation.d.ts +4 -0
- package/lib/skills/long-task-continuation.d.ts.map +1 -0
- package/lib/skills/long-task-continuation.js +43 -0
- package/lib/skills/long-task-continuation.js.map +1 -0
- package/lib/skills/service.d.ts.map +1 -1
- package/lib/skills/service.js +8 -3
- package/lib/skills/service.js.map +1 -1
- package/lib/skills/viora-canvas-builtin.d.ts +3 -0
- package/lib/skills/viora-canvas-builtin.d.ts.map +1 -0
- package/lib/skills/viora-canvas-builtin.js +19 -0
- package/lib/skills/viora-canvas-builtin.js.map +1 -0
- package/lib/storage/migrate-layout.d.ts.map +1 -1
- package/lib/storage/migrate-layout.js +13 -4
- package/lib/storage/migrate-layout.js.map +1 -1
- package/lib/store.d.ts.map +1 -1
- package/lib/store.js +2 -0
- package/lib/store.js.map +1 -1
- package/lib/tasks/context.js +1 -0
- package/lib/tasks/context.js.map +1 -1
- package/lib/tasks/continuation-yield.d.ts +4 -0
- package/lib/tasks/continuation-yield.d.ts.map +1 -0
- package/lib/tasks/continuation-yield.js +27 -0
- package/lib/tasks/continuation-yield.js.map +1 -0
- package/lib/tasks/continuation.d.ts +13 -0
- package/lib/tasks/continuation.d.ts.map +1 -0
- package/lib/tasks/continuation.js +106 -0
- package/lib/tasks/continuation.js.map +1 -0
- package/lib/tasks/domain.d.ts +2 -0
- package/lib/tasks/domain.d.ts.map +1 -1
- package/lib/tasks/scheduling.d.ts.map +1 -1
- package/lib/tasks/scheduling.js +7 -0
- package/lib/tasks/scheduling.js.map +1 -1
- package/lib/tasks/service.d.ts +2 -1
- package/lib/tasks/service.d.ts.map +1 -1
- package/lib/tasks/service.js +19 -1
- package/lib/tasks/service.js.map +1 -1
- package/lib/ui/attachment-storage.d.ts +2 -0
- package/lib/ui/attachment-storage.d.ts.map +1 -0
- package/lib/ui/attachment-storage.js +59 -0
- package/lib/ui/attachment-storage.js.map +1 -0
- package/lib/ui/capability-editor.js +1 -1
- package/lib/ui/capability-editor.js.map +1 -1
- package/lib/ui/companion-access-panel.js +1 -1
- package/lib/ui/companion-access-panel.js.map +1 -1
- package/lib/ui/companion-create.js +1 -1
- package/lib/ui/companion-create.js.map +1 -1
- package/lib/ui/companion-picker.js +1 -1
- package/lib/ui/companion-picker.js.map +1 -1
- package/lib/ui/identity-editor.js +1 -1
- package/lib/ui/identity-editor.js.map +1 -1
- package/lib/ui/mcp-capabilities.js +1 -1
- package/lib/ui/mcp-capabilities.js.map +1 -1
- package/lib/ui/mcp-panel.js +1 -1
- package/lib/ui/mcp-panel.js.map +1 -1
- package/lib/ui/memory/concern-board.js +2 -2
- package/lib/ui/memory/concern-board.js.map +1 -1
- package/lib/ui/memory/concern-deletion.d.ts +1 -1
- package/lib/ui/memory/concern-deletion.d.ts.map +1 -1
- package/lib/ui/memory/concern-deletion.js +9 -4
- package/lib/ui/memory/concern-deletion.js.map +1 -1
- package/lib/ui/memory/concern-panel.js +1 -1
- package/lib/ui/memory/concern-panel.js.map +1 -1
- package/lib/ui/memory/memory-library.js +1 -1
- package/lib/ui/memory/memory-library.js.map +1 -1
- package/lib/ui/memory/memory-panel.js +1 -1
- package/lib/ui/memory/memory-panel.js.map +1 -1
- package/lib/ui/partner-components.js +1 -1
- package/lib/ui/partner-components.js.map +1 -1
- package/lib/ui/requirement-board.js +1 -1
- package/lib/ui/requirement-board.js.map +1 -1
- package/lib/ui/requirement-dialog.js +1 -1
- package/lib/ui/requirement-dialog.js.map +1 -1
- package/lib/ui/requirement-tasks-panel.js +1 -1
- package/lib/ui/requirement-tasks-panel.js.map +1 -1
- package/lib/ui/schedule-panel.d.ts.map +1 -1
- package/lib/ui/schedule-panel.js +20 -4
- package/lib/ui/schedule-panel.js.map +1 -1
- package/lib/ui/skills-panel.js +1 -1
- package/lib/ui/skills-panel.js.map +1 -1
- package/lib/ui/storage-settings.d.ts.map +1 -1
- package/lib/ui/storage-settings.js +2 -1
- package/lib/ui/storage-settings.js.map +1 -1
- package/lib/ui/task-board-stage.js +1 -1
- package/lib/ui/task-board-stage.js.map +1 -1
- package/lib/ui/workspace-components.js +1 -1
- package/lib/ui/workspace-components.js.map +1 -1
- package/lib/ui/workspace-navigation.d.ts +16 -16
- package/lib/ui/workspace-navigation.js +1 -1
- package/lib/ui/workspace-navigation.js.map +1 -1
- package/package.json +55 -41
- package/resources/skills/cinematic-director/manifest.json +205 -0
- package/resources/skills/cinematic-director/upstream/CHANGELOG.md +213 -0
- package/resources/skills/cinematic-director/upstream/CONTRIBUTING.md +316 -0
- package/resources/skills/cinematic-director/upstream/LICENSE +21 -0
- package/resources/skills/cinematic-director/upstream/README.md +507 -0
- package/resources/skills/cinematic-director/upstream/SKILL.md +420 -0
- package/resources/skills/cinematic-director/upstream/assets/beat-sheet-template.md +97 -0
- package/resources/skills/cinematic-director/upstream/assets/director-book-template.md +254 -0
- package/resources/skills/cinematic-director/upstream/assets/edit-timeline-template.md +147 -0
- package/resources/skills/cinematic-director/upstream/assets/keyframe-prompt-template.md +334 -0
- package/resources/skills/cinematic-director/upstream/assets/qc-checklist.md +153 -0
- package/resources/skills/cinematic-director/upstream/assets/shot-plan-template.md +95 -0
- package/resources/skills/cinematic-director/upstream/assets/sound-plan-template.md +181 -0
- package/resources/skills/cinematic-director/upstream/assets/video-prompt-template.md +305 -0
- package/resources/skills/cinematic-director/upstream/evals/run.md +69 -0
- package/resources/skills/cinematic-director/upstream/references/ai-video-tool-adapters.md +527 -0
- package/resources/skills/cinematic-director/upstream/references/blocking-and-staging.md +424 -0
- package/resources/skills/cinematic-director/upstream/references/cinematic-language.md +595 -0
- package/resources/skills/cinematic-director/upstream/references/continuity-bible.md +410 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/01_spielberg.md +192 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/02_hitchcock.md +193 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/03_kubrick.md +196 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/04_kurosawa.md +196 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/05_scorsese.md +195 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/06_fellini.md +197 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/07_bergman.md +197 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/08_tarkovsky.md +184 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/09_wong_kar_wai.md +189 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/10_nolan.md +185 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/11_villeneuve.md +188 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/12_fincher.md +185 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/13_refn.md +186 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/14_bi_gan.md +188 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/15_zhang_yimou.md +192 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/16_hou_hsiao_hsien.md +192 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/17_park_chan_wook.md +192 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/18_malick.md +191 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/19_michael_mann.md +192 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/20_coen_brothers.md +194 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/README.md +89 -0
- package/resources/skills/cinematic-director/upstream/references/director_styles/example_comparisons.md +140 -0
- package/resources/skills/cinematic-director/upstream/references/editing-and-assembly.md +263 -0
- package/resources/skills/cinematic-director/upstream/references/failure-modes.md +594 -0
- package/resources/skills/cinematic-director/upstream/references/genre-playbooks.md +407 -0
- package/resources/skills/cinematic-director/upstream/references/image-model-adapters.md +290 -0
- package/resources/skills/cinematic-director/upstream/references/lighting-and-color.md +349 -0
- package/resources/skills/cinematic-director/upstream/references/product-and-macro.md +207 -0
- package/resources/skills/cinematic-director/upstream/references/production-workflow.md +238 -0
- package/resources/skills/cinematic-director/upstream/references/prompt-lexicon.md +602 -0
- package/resources/skills/cinematic-director/upstream/references/sound-and-dialogue.md +364 -0
- package/resources/skills/director-skills/manifest.json +541 -0
- package/resources/skills/director-skills/upstream/CHANGELOG.md +32 -0
- package/resources/skills/director-skills/upstream/LICENSE +21 -0
- package/resources/skills/director-skills/upstream/MANIFEST.md +366 -0
- package/resources/skills/director-skills/upstream/README.md +251 -0
- package/resources/skills/director-skills/upstream/RESEARCH_PROVENANCE.md +37 -0
- package/resources/skills/director-skills/upstream/SKILL.md +114 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/SKILL.md +81 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/checklists/continuity_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/character_continuity_update.md +9 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/examples/location_continuity_update.md +9 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/continuity_system.md +21 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/golden_image_workflow.md +29 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/identity_anchors.md +14 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/references/visual_bible_system.md +15 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/character_profile.md +15 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/continuity_checklist.md +11 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/costume_profile.md +12 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/location_profile.md +14 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/prop_profile.md +13 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/templates/visual_style_bible.md +15 -0
- package/resources/skills/director-skills/upstream/skills/character-location-prop-bible/tests/continuity_tests.md +6 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/SKILL.md +80 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/checklists/image_prompt_quality_checklist.md +10 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/examples/shot_list_to_image_prompts.md +4 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/image_prompt_components.md +22 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/lighting_and_photorealism.md +19 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/negative_prompt_patterns.md +18 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/references/prompt_anatomy.md +18 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/character_reference_sheet_prompt.md +5 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/cinematic_still_prompt.md +3 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/keyframe_prompt.md +6 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/location_reference_prompt.md +3 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/templates/prop_prompt.md +3 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-image-prompting/tests/image_prompt_completeness_tests.md +5 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/SKILL.md +84 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/checklists/video_prompt_quality_checklist.md +9 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/examples/image_prompt_to_video_prompt.md +3 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/ai_film_production_pipeline.md +21 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/audio_motion_timing.md +16 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/camera_lens_movement.md +26 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/negative_prompt_patterns.md +18 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/prompt_anatomy.md +18 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/references/video_prompt_components.md +25 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/image_to_video_prompt.md +5 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/text_to_video_prompt.md +5 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/templates/video_beat_prompt.md +9 -0
- package/resources/skills/director-skills/upstream/skills/cinematic-video-prompting/tests/video_prompt_completeness_tests.md +5 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/SKILL.md +82 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/checklists/model_export_checklist.md +9 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/failed_model_transfer_diagnosis.md +5 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/image_prompt_translation.md +10 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/same_scene_across_models.md +9 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/universal_prompt_to_model_specific_exports.md +14 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/examples/video_prompt_translation.md +9 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/failure_modes_by_model.md +13 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/image_model_profiles.md +226 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_capability_matrix.md +24 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/model_update_protocol.md +10 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/parameter_compatibility.md +20 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/prompt_translation_rules.md +18 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/references/video_model_profiles.md +251 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_comparison_table.md +4 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/model_specific_prompt_export.md +21 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/multi_model_export_package.md +18 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/prompt_translation_report.md +13 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/templates/universal_prompt_brief.md +25 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/model_routing_tests.md +8 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/prompt_translation_tests.md +7 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/research_provenance_tests.md +6 -0
- package/resources/skills/director-skills/upstream/skills/model-adaptation/tests/unknown_capability_tests.md +7 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/SKILL.md +82 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/diagnostic_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/checklists/release_quality_checklist.md +9 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/failed_output_to_revised_prompt.md +10 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/examples/final_prompt_package_export.md +10 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/failure_modes.md +13 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/iteration_diagnostics.md +17 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/revision_loops.md +17 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/references/story_voice_release_qc.md +30 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/failed_output_intake.md +13 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/final_production_package.md +11 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/templates/prompt_revision_report.md +17 -0
- package/resources/skills/director-skills/upstream/skills/prompt-iteration-and-diagnostics/tests/prompt_quality_checklist_tests.md +6 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/SKILL.md +81 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/checklists/scene_quality_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/examples/scene_to_screenplay_excerpt.md +18 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/dialogue_and_subtext.md +15 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/fountain_workflow.md +29 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/scene_construction.md +20 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/references/screenplay_format.md +18 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/beat_sheet.md +6 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/dialogue_pass.md +9 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/fountain_scene.md +25 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/templates/screenplay_scene.md +19 -0
- package/resources/skills/director-skills/upstream/skills/screenplay-and-scene-writing/tests/screenplay_scene_tests.md +6 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/SKILL.md +83 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/checklists/concept_quality_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/examples/idea_to_logline.md +13 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/examples/logline_to_outline.md +10 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/references/ai_storytelling_workflow.md +46 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/references/continuity_handoff.md +8 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/references/screenplay_structure.md +19 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/references/story_development_workflow.md +23 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/beat_sheet.md +7 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/idea_intake.md +16 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/logline.md +10 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_film_treatment.md +23 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/short_story_plan.md +22 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_premise.md +19 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/templates/story_revision_audit.md +22 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/tests/output_format_tests.md +3 -0
- package/resources/skills/director-skills/upstream/skills/short-film-development/tests/routing_tests.md +7 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/SKILL.md +77 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/checklists/shotlist_quality_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/examples/screenplay_scene_to_shot_list.md +8 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/camera_plan.md +11 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/production_breakdown.md +11 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/references/shotlist_schema.md +21 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/asset_list.md +7 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/camera_plan.md +10 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/scene_breakdown.md +16 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/templates/shot_list.md +5 -0
- package/resources/skills/director-skills/upstream/skills/shotlist-and-visual-breakdown/tests/screenplay_to_shotlist_tests.md +5 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/SKILL.md +77 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/checklists/style_quality_checklist.md +8 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/examples/genre_to_visual_direction.md +15 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/camera_lens_movement.md +26 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/cinematic_language.md +32 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/genre_style_tone.md +17 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/references/lighting_and_photorealism.md +19 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/templates/visual_style_bible.md +33 -0
- package/resources/skills/director-skills/upstream/skills/style-cinematography-director/tests/style_translation_tests.md +5 -0
- package/resources/skills/director-skills/upstream/tests/master_router_tests.md +80 -0
- package/resources/skills/drama-production/manifest.json +933 -0
- package/resources/skills/drama-production/upstream/LICENSE +21 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/SKILL.md +153 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/creator-decision.example.jsonl +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/app.js +1263 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/index.html +114 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/dashboard/styles.css +297 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/production-observation.example.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/project-template/short-drama.json +36 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/assets/reference-observation.example.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/audience-reveal.md +21 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/contract-and-ownership.md +45 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-documents.md +230 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/creator-workflow.md +98 -0
- 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
- 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
- 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
- package/resources/skills/drama-production/upstream/skills/short-drama/references/form-cards//345/256/236/346/213/215.md +75 -0
- 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
- 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
- package/resources/skills/drama-production/upstream/skills/short-drama/references/knowhow-index.md +85 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/look-development.md +51 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/pickup-and-alternate.md +24 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/production-form-profiles.md +126 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/reference-roles.md +53 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/references/runtime-preflight.md +24 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/scripts/creator_markdown_check.py +1413 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/scripts/dashboard_server.py +1798 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/scripts/project_tool.py +2454 -0
- package/resources/skills/drama-production/upstream/skills/short-drama/scripts/selftest.py +287 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/SKILL.md +76 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/character-look.example.jsonl +3 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/continuity.example.jsonl +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/decisions.example.jsonl +5 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/location-view.example.jsonl +3 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/occurrences.example.jsonl +5 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/assets/prop-state.example.jsonl +3 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/characters.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/examples/minimal/looks.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/asset-review-checklist.md +82 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/character-and-look.md +190 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-delta.md +120 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/continuity-lock.md +122 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/identity-vs-variant.md +140 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/location-and-view.md +84 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/occurrence-extraction.md +108 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/prop-and-state.md +126 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/stage-contract.md +43 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/references/voice-direction.md +179 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/asset_check.py +267 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-assets/scripts/selftest.py +89 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/SKILL.md +157 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/adaptation-map.example.jsonl +1 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/creative-brief.md +120 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/episode-map.jsonl +1 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/assets/story-engine.md +181 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/adaptation-craft.md +219 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/creative-reference-intake.md +57 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/director-brief-craft.md +113 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/episode-design.md +509 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-and-hook-playbook.md +240 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/genre-cards.md +92 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/mechanism-loop.md +282 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/multi-episode-intake.md +128 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/premise-devices.md +211 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/reveal-reversal-payoff.md +99 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/serial-character-and-memory.md +293 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/stage-contract.md +88 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/references/story-craft.md +359 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/episode_intake.py +699 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-develop/scripts/selftest.py +47 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/SKILL.md +146 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/README.md +60 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/package.json +15 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/remotion.config.ts +6 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Root.tsx +26 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/Subtitles.tsx +88 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/font.ts +46 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/index.ts +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/src/schema.ts +32 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets/remotion/tsconfig.json +13 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/assets//345/211/252/350/276/221/345/215/225.md +43 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/cut-craft.md +38 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/delivery-verify.md +29 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/generated-footage.md +54 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/sound-and-subtitles.md +60 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/references/stage-contract.md +51 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/edit_tool.py +1156 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-edit/scripts/selftest.py +520 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/SKILL.md +73 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompt-spec.jsonl.md +187 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/image-prompts.md +42 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-frame-spec.jsonl.md +128 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/assets/lookdev-prompts.md +34 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/examples/minimal-image-prompt-specs.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/character-and-look.md +153 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/common-recipe.md +241 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/edit-and-revision.md +110 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/location-plate.md +151 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/look-and-state-variant.md +97 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/lookdev-frame.md +34 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/production-sheet-recipes.md +177 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/prop-plate.md +137 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/review-and-fixtures.md +92 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/references/stage-contract.md +32 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/image_prompt_check.py +443 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-image-prompts/scripts/selftest.py +95 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/SKILL.md +245 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/assets/episode-candidate.example.jsonl +3 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-triage.md +116 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/adaptation-value.md +124 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/aggregation-and-entities.md +155 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/chapter-extraction.md +144 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/references/stage-contract.md +67 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/novel_index.py +651 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-novel-analyze/scripts/selftest.py +51 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/SKILL.md +183 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/adapter-contract.md +219 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/gpt-image-2.md +24 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-h3-video.md +86 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-music.md +25 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/minimax-speech.md +41 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/references/providers/seedance.md +64 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/fixture_adapter.py +77 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/production_tool.py +2205 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/provider_adapters.py +1747 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-produce/scripts/selftest.py +135 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/SKILL.md +118 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/finding-template.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/supersession-decision.example.json +42 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/assets/verdict-template.json +32 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-findings.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/examples/minimal-verdict.json +34 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/anti-template-repair.md +109 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/production-quality-gates.md +276 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/project-calibration.md +83 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/review-method.md +81 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-assets-prompts.md +111 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-source-analysis.md +108 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-story-script.md +264 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/rubric-visual-motion.md +184 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/references/stage-contract.md +28 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/review_check.py +325 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-review/scripts/selftest.py +87 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/SKILL.md +175 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-audition.example.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/coverage-template.json +49 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-prompts.md +36 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/keyframe-template.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/revision-lineage.fragment.json +12 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/scene-visual-plan.example.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/assets/shot-template.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/blocking-playbooks.md +216 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/comic-keyframe-lexicon.md +156 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/coverage-audition.md +34 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/keyframe-craft.md +174 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/lighting-craft.md +39 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/production-shot-grammar.md +279 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/review-and-fixtures.md +36 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/scene-visual-plan.md +30 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/screenplay-to-keyframe-example.md +155 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-craft.md +266 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/shot-revision-identity.md +25 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/references/stage-contract.md +57 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/selftest.py +191 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-storyboard/scripts/storyboard_check.py +824 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/SKILL.md +154 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/coverage-scope.fragment.json +21 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/delivery-container.jsonl.md +101 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-spec.jsonl.md +217 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/motion-terminal.example.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/music-spec.jsonl.md +31 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/performance.fragment.json +38 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/assets/video-prompts.md +67 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/examples/minimal-music-specs.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/camera-audio-continuity.md +259 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/delivery-profile.md +273 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/generability.md +93 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/minimax-h3.md +253 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/motion-recipe.md +315 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/performance-action-timing.md +209 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/production-prompt-grammar.md +304 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/review-and-fixtures.md +139 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.0.md +50 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/seedance-2.5.md +122 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/stage-contract.md +60 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/references/target-model-profile.md +116 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/container_check.py +329 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/motion_timing_check.py +450 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/music_spec_check.py +327 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-video-prompts/scripts/selftest.py +82 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/SKILL.md +99 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/agents/openai.yaml +4 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/beats.jsonl +2 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card-standalone.json +120 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/episode-card.json +55 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/screenplay.md +36 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/assets/voice-record-sheet.jsonl.md +89 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/dialogue-craft.md +526 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/production-format-dialect.md +273 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-handoff-capsule.md +25 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/scene-sound-dramaturgy.md +43 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/screenplay-format.md +266 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/script-craft.md +745 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/stage-contract.md +36 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/references/substitutable-realization.md +107 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/duration_estimate.py +309 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/screenplay_index.py +1091 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/selftest.py +229 -0
- package/resources/skills/drama-production/upstream/skills/short-drama-write/scripts/voice_sheet_check.py +416 -0
- package/resources/skills/viora-canvas-production/manifest.json +23 -0
- package/resources/skills/viora-canvas-production/references/canvas-contract.md +50 -0
- package/resources/skills/viora-canvas-production/references/creative-production.md +50 -0
- package/resources/skills/viora-canvas-production/references/generation-delivery.md +36 -0
- package/resources/skills/viora-canvas-production/references/production-ledger.md +25 -0
|
@@ -0,0 +1,282 @@
|
|
|
1
|
+
# 机制循环与耗尽
|
|
2
|
+
|
|
3
|
+
## 目录
|
|
4
|
+
|
|
5
|
+
1. 使用方式与规则分级
|
|
6
|
+
2. 循环是引擎与分集之间的那一层
|
|
7
|
+
3. 写清一次运行
|
|
8
|
+
4. 一次运行与一次重复的区别
|
|
9
|
+
5. 循环耗尽:症状与根因
|
|
10
|
+
6. 换代:先处置,再把紧迫性交过去
|
|
11
|
+
7. 一种常见变体:落差型循环
|
|
12
|
+
8. 循环与单集契约的关系
|
|
13
|
+
9. 合成示例
|
|
14
|
+
10. 失败征兆与审查问题
|
|
15
|
+
|
|
16
|
+
## 1. 使用方式与规则分级
|
|
17
|
+
|
|
18
|
+
在故事引擎已经成立、要把它切成单元故事与分集时使用本文件。它回答的是
|
|
19
|
+
"同一件事凭什么值得再看一次",不回答"这一集怎么写"。
|
|
20
|
+
|
|
21
|
+
| 分类 | 本层例子 | 谁可以执行 |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| `structural_invariant` | 循环内各次运行的引用、状态声明是否互相矛盾 | 校验器可阻断 |
|
|
24
|
+
| `reviewed_invariant` | 某次运行是否真的改变局面(沿用 `STY-03`) | 审查者引用证据 |
|
|
25
|
+
| `craft_default` | 声明循环、处置循环、交接紧迫性 | 创作者说明理由可覆盖 |
|
|
26
|
+
| `taste_option` | 循环长度、运行次数、结束气质 | 不得单独阻断 |
|
|
27
|
+
|
|
28
|
+
本文件不规定一个单元该跑几次、一次运行占几集、循环之间怎么排列。这些是创作者与
|
|
29
|
+
项目的选择。
|
|
30
|
+
|
|
31
|
+
## 2. 循环是引擎与分集之间的那一层
|
|
32
|
+
|
|
33
|
+
[story-craft.md](story-craft.md) 回答压力怎样反复生成,[episode-design.md](episode-design.md)
|
|
34
|
+
回答一集怎样完成一次状态变换。中间还有一层常被跳过:**一个单元故事通常是同一套机制
|
|
35
|
+
被反复运行**,观众的乐趣一半来自机制本身,一半来自"我已经知道它会怎么运作,我在等它
|
|
36
|
+
再运作一次"。
|
|
37
|
+
|
|
38
|
+
跳过这一层的典型后果是:每集都在发生事,事与事之间却没有共同的期待物。观众看完一集
|
|
39
|
+
知道发生了什么,却说不出下一集自己在等什么。
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
故事引擎:压力为什么会反复出现
|
|
43
|
+
→ 机制循环:这个单元里,什么东西被反复运行,观众每次期待什么
|
|
44
|
+
→ 单集契约:这一集把哪一次运行推进到哪里
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
**循环的乐趣建立在观众掌握机制之上**。 这带来一个反直觉的做法:**第一次运行要把机制
|
|
48
|
+
演示完整,宁可慢**。观众没看懂机制之前,后面每一次运行都只是又一个事件;看懂之后,
|
|
49
|
+
同样的动作会自动携带期待。把第一次运行压缩成和后面一样快,是这一层最常见的浪费。
|
|
50
|
+
|
|
51
|
+
循环通常是**套着的**,不是排成一列:几次小循环共同构成一个更大循环的一次运行,几个
|
|
52
|
+
大循环构成整部戏。下文为了说清楚只写单层,但每一条同样适用于外层——**外层的赌注要
|
|
53
|
+
更早建立**,因为观众正在跟的是小循环,而让他们留到几十集之后的是大循环。嵌套几层、
|
|
54
|
+
每层多长由创作者与项目决定,本文件不给层数与集数配方。
|
|
55
|
+
|
|
56
|
+
**`craft_default · STY-20`**:为每个单元声明它反复运行的机制、观众每次运行能预期的
|
|
57
|
+
回报,以及这个循环在什么条件下应当结束。第一次运行完整展示机制,后面的运行才能靠
|
|
58
|
+
"认得出来"生效。
|
|
59
|
+
|
|
60
|
+
## 3. 写清一次运行
|
|
61
|
+
|
|
62
|
+
一次运行不是"又赢了一次"。为每次运行记录:
|
|
63
|
+
|
|
64
|
+
- **谁在用什么已知优势**:主角掌握的信息、习惯、权限或关系,观众此刻知道多少;
|
|
65
|
+
- **对方基于什么行动**:对手不是变笨,而是依据他手里的事实作出合理选择;
|
|
66
|
+
- **观众提前知道什么**:这是期待的来源。观众可以比对手多知道一步,也可以和对手一样
|
|
67
|
+
被蒙住——但要选定一种;
|
|
68
|
+
- **本次改变什么状态**:知情者名单、对手的解释空间、主角的可用次数、代价的到期时间、
|
|
69
|
+
某段关系的位置;
|
|
70
|
+
- **本次的成本**:主角为这次运行付出了什么,或欠下了什么。
|
|
71
|
+
|
|
72
|
+
没有第五项的运行会让循环变成免费的。免费的循环耗尽得最快,因为观众很早就算出了
|
|
73
|
+
它可以无限进行。
|
|
74
|
+
|
|
75
|
+
## 4. 一次运行与一次重复的区别
|
|
76
|
+
|
|
77
|
+
判据只有一条:**把几次运行的顺序打乱,会不会损失东西**。
|
|
78
|
+
|
|
79
|
+
会损失,说明每次运行都改变了下一次的条件。不会损失,说明这是同一件事的复述,无论
|
|
80
|
+
场面换到哪里、金额加到多大。
|
|
81
|
+
|
|
82
|
+
具体可查的差异项:
|
|
83
|
+
|
|
84
|
+
- 对手对机制的认知——完全不知道 / 察觉异常 / 知道有人在做 / 知道是谁;
|
|
85
|
+
- 主角的执行难度——同样的手段这次要多付什么;
|
|
86
|
+
- 机制的适用范围——上次能用的条件,这次还在不在;
|
|
87
|
+
- 知情者名单——谁新看见了,谁因此必须选边;
|
|
88
|
+
- 退路——哪条原本可以撤退的路现在关上了。
|
|
89
|
+
|
|
90
|
+
指不出上述任一项变化而声称"这次更狠"时,它不是升级——这与 `STY-03` 判断升级用的是
|
|
91
|
+
同一条标准,本文件只是把它落到循环这一层。
|
|
92
|
+
|
|
93
|
+
### 4.1 避免重复时最容易走错的那一步
|
|
94
|
+
|
|
95
|
+
发现重复之后,通常有两个修法,只有一个是对的:
|
|
96
|
+
|
|
97
|
+
- **换靶心**(错):为了不重复,换一件全新的、与核心回报无关的事来写。重复消失了,
|
|
98
|
+
但观众追的那条线也断了。几次之后,整部戏会被描述成"后面不知道在讲什么"。
|
|
99
|
+
- **换向量、抬阈值、不换靶心**(对):同一个矛盾点,用不同性质的东西回应,且这次的
|
|
100
|
+
代价或规模比上次高一层。
|
|
101
|
+
|
|
102
|
+
举例说明差别。对手反复质疑主角"拿不出钱":
|
|
103
|
+
|
|
104
|
+
- 重复:第一次用一笔钱回应,第二次用更大一笔钱回应。方向没变,阈值没变,观众疲劳。
|
|
105
|
+
- 换向量:第一次用一笔钱回应;第二次对手改口说"东西是借的",回应它的不再是钱,而是
|
|
106
|
+
一个只有真正拥有者才会有的日常细节(有人来向他请示当晚的安排)。靶心仍是"他到底
|
|
107
|
+
有没有",但证明它的东西换了一类,阈值也抬了一层。
|
|
108
|
+
- 也可以换承担者:引入一个新人物,由她的态度来完成同一次回应。这仍然合格——**判据不是
|
|
109
|
+
"有没有换人换事",而是"换过之后,观众追的还是不是同一件事"**。
|
|
110
|
+
|
|
111
|
+
失效判据只有一条:这个新事件与本剧的核心优势、核心矛盾是否还有关系。答案是"关系很弱
|
|
112
|
+
但也说得通"时,它就已经偏了——短剧的篇幅不提供容纳弱关联的余地,而偏靶一次的损失会
|
|
113
|
+
一直带到后面。
|
|
114
|
+
|
|
115
|
+
## 5. 循环耗尽:症状与根因
|
|
116
|
+
|
|
117
|
+
任何循环都会耗尽。耗尽不是写坏了,是这一层的正常寿命;写坏的是**没有察觉耗尽**。
|
|
118
|
+
|
|
119
|
+
症状(出现两项以上即应处置):
|
|
120
|
+
|
|
121
|
+
- 观众能提前说出运行结果和对手反应,猜中之后不再有期待;
|
|
122
|
+
- 兑现的规模在变大(更大的场面、更高的筹码、更公开的场合),状态变化却在变小;
|
|
123
|
+
- 必须靠加大羞辱、加大金额或加多围观者来维持强度;
|
|
124
|
+
- 对手为了让机制继续生效,开始作出他自己都不该作的选择。
|
|
125
|
+
|
|
126
|
+
最后一项是根因,也是最容易被忽略的:**机制越有效,对手越必须变笨,世界越不可信**。
|
|
127
|
+
一个已经被反制三次的对手仍然按老办法上钩时,损失的不只是这一段,还有观众对整部戏
|
|
128
|
+
因果的信任。到这一步再修补,往往要回头重写更早的段落。
|
|
129
|
+
|
|
130
|
+
### 5.1 没有终点的循环一定会耗尽
|
|
131
|
+
|
|
132
|
+
题材说法("隐藏身份归来""高手回归""带着记忆重来")只描述了**推进方式**,没有描述
|
|
133
|
+
**去处**。只有推进方式的循环,唯一的续命办法是不断换上更强的对手重跑同一套流程——集数
|
|
134
|
+
可以很多,内容却很薄,观众第一轮就看到了头。
|
|
135
|
+
|
|
136
|
+
补法不是加强机制,是给它一个能被用完的去处:主角最终要让**哪件具体的事被改变**。
|
|
137
|
+
一旦这个去处成立,每次运行就都在朝它推进,循环自带终点,也自带"还差多少"的可感刻度。
|
|
138
|
+
|
|
139
|
+
去处不必宏大,但必须**具体到可以被核对**:"让当年那份名单被公开更正"比"变成最强的人"
|
|
140
|
+
更有用,因为前者能被完成,后者只能被无限延长。这也决定了故事能不能收得干净——
|
|
141
|
+
[story-craft.md](story-craft.md) 讲的终止条件,在循环这一层的表现就是它。
|
|
142
|
+
|
|
143
|
+
## 6. 换代:先处置,再把紧迫性交过去
|
|
144
|
+
|
|
145
|
+
### 6.1 三种处置
|
|
146
|
+
|
|
147
|
+
- **收束**:让循环以一次**不能再重复**的运行结束。常见办法是让机制被识破,或让代价
|
|
148
|
+
第一次落到主角自己或他保护的人身上。收束会同时结清观众的期待和主角的债,是最干净
|
|
149
|
+
的一种。
|
|
150
|
+
- **改造**:保留机制,换掉它的一项前提——适用范围、代价结构、知情者、或谁承担风险。
|
|
151
|
+
改造后的循环与原循环共享观众已经建立的理解,因此不需要重新教学,起步就有期待。
|
|
152
|
+
- **移交**:把机制交给另一个人物使用。观众的立场随之改变:原本站在使用者一侧看它奏效,
|
|
153
|
+
现在可能站在承受者一侧看它逼近。同一套机制因此获得完全不同的情绪。
|
|
154
|
+
|
|
155
|
+
**不成立的第四种:并接**。 不处置旧循环,直接在旁边开一个新的。
|
|
156
|
+
|
|
157
|
+
### 6.2 换代真正丢掉的是紧迫性
|
|
158
|
+
|
|
159
|
+
新循环往往更新奇却更弱。原因不是它写得不好,而是它**从零开始**:旧循环攒下的三样
|
|
160
|
+
东西没有交接过来。
|
|
161
|
+
|
|
162
|
+
1. **可感的时限或到期的代价**——旧循环里"再不做会怎样"是具体的,新循环里常常只剩
|
|
163
|
+
"情况不太好";
|
|
164
|
+
2. **主角不能退出的理由**——旧循环的退出成本是攒出来的,新循环若没有重新给出,主角
|
|
165
|
+
随时可以走开,观众也就随时可以走开;
|
|
166
|
+
3. **观众已经押上的赌注**——旧循环让观众在意某个具体的人或某样具体的东西,新循环若
|
|
167
|
+
换掉了这个对象,等于让观众重新下注。
|
|
168
|
+
|
|
169
|
+
检查办法:问"如果主角这一轮什么都不做,会发生什么"。新循环的答案必须比旧循环**更具体
|
|
170
|
+
且更糟**,而不是更抽象。答案变抽象时,先补时限与退出成本,再谈新机制好不好玩。
|
|
171
|
+
|
|
172
|
+
这也解释了并接为什么不成立:旧循环的期待没有结清,新循环又要从零建立理解,两边同时
|
|
173
|
+
变弱。观众的说法通常是"后面不如前面好看",实际发生的是前面那笔账没有还。
|
|
174
|
+
|
|
175
|
+
### 6.3 做法:把下一个循环埋在这一个里面
|
|
176
|
+
|
|
177
|
+
不要等到换代那一刻才让观众第一次听说下一件事。在当前循环还在运行时,就让下一个循环
|
|
178
|
+
需要的东西以次要身份出现过一次:一个还没解释的人、一份被顺手放下的文件、一句当时不
|
|
179
|
+
重要的话。它们此刻只是背景,旧循环收束时才被提起——观众会感到"原来那个东西是有用的",
|
|
180
|
+
而不是"怎么突然又来一件事"。
|
|
181
|
+
|
|
182
|
+
代价很低:每次只需要一处,不必额外加场,也不必在当时解释。真正的成本是**必须提前
|
|
183
|
+
知道下一个循环大概是什么**,所以它属于分集地图,不属于写正文时的临场发挥。
|
|
184
|
+
|
|
185
|
+
换代之间还需要一段缓冲。一个循环刚收束就立刻拉满下一个,观众来不及感受刚才那次兑现;
|
|
186
|
+
留一段低压力的过渡——处理后果、确认损失、让关系落定——反而让下一个循环起得更高。
|
|
187
|
+
这段过渡不是空转,它交付的正是刚结束那次运行的余波。
|
|
188
|
+
|
|
189
|
+
**`craft_default · STY-21`**:结束一个循环时先处置它(收束、改造或移交),再开下一个;
|
|
190
|
+
新循环要接管旧循环的赌注与时限,而不是从零重建紧迫性。
|
|
191
|
+
|
|
192
|
+
## 7. 一种常见变体:落差型循环
|
|
193
|
+
|
|
194
|
+
有一类循环的回报不是"权力被夺回",而是"紧张被解除":人物反复进入危险处境,又反复
|
|
195
|
+
脱身,观众买的是那一下松口气。
|
|
196
|
+
|
|
197
|
+
它有两个特点:
|
|
198
|
+
|
|
199
|
+
- **耗尽更快**。解除一旦可被预期,紧张就不再产生。夺回型循环靠"这次能拿回什么"维持,
|
|
200
|
+
落差型循环靠"这次会不会真的出事"维持,而后者只要连续几次都没出事,就不再有人担心。
|
|
201
|
+
- **常见修补是让虚惊留下真实损失**。每次脱身都带走一点确定的东西——一条退路、一个
|
|
202
|
+
知情者、一次可用的机会、身体上的一处代价。损失可以很小,但必须是确定发生的。全是
|
|
203
|
+
虚晃的落差型循环,通常在观众能数出第三次时就失效了。
|
|
204
|
+
|
|
205
|
+
不要把这条当成"必须每次受伤"。它只说明:落差型循环的可持续性由**真实损失的积累**
|
|
206
|
+
提供,而不是由危险的规模提供。
|
|
207
|
+
|
|
208
|
+
## 8. 循环与单集契约的关系
|
|
209
|
+
|
|
210
|
+
- 一次运行可以跨几集,也可以一集完成;**不要求每集一次运行**。
|
|
211
|
+
- 一集里可以推进循环的一部分(布置、试探、遭遇反制),只要这一集自己仍有局部结果——
|
|
212
|
+
这条由 `STY-13` 管,本文件不重复。
|
|
213
|
+
- 集尾钩子从本次运行的当前状态往下长,而不是从循环的最终目标往下长。写法见
|
|
214
|
+
[episode-design.md](episode-design.md) 的"钩子要接着本集结果往下走"。
|
|
215
|
+
- 循环换代的位置不必对齐整数集,也不必对齐单元边界;对齐与否是节奏选择。
|
|
216
|
+
|
|
217
|
+
## 9. 合成示例
|
|
218
|
+
|
|
219
|
+
以下人物、机构与情节均为新写虚构,不指向任何实际作品。
|
|
220
|
+
|
|
221
|
+
**单元设定**:社区医院的排班表被护士长改过,把夜班压在一个没有靠山的年轻护士身上。
|
|
222
|
+
主角查到改动,但拿不出能立刻推翻结果的证据。
|
|
223
|
+
|
|
224
|
+
**机制**:主角每次都让对方**在有第三方记录的场合重新说一遍自己的说法**——交接本、
|
|
225
|
+
科室会议、家属沟通单。说法一旦和可核对的记录对不上,对方必须当场改口;而每次改口,
|
|
226
|
+
都会缩小他下一次能用的解释空间。
|
|
227
|
+
|
|
228
|
+
观众第一次看完就掌握了机制:不是抓把柄,是让他自己把路一条条说死。
|
|
229
|
+
|
|
230
|
+
**运行一(完整演示,不赶)**:主角当着交接班的人问一句排班依据。护士长说"按上月轮次"。
|
|
231
|
+
主角把交接本翻到上月那页放在台面上,不说话。护士长改口成"临时调整"。
|
|
232
|
+
状态变化:他从"有规则依据"退到"临时决定";知情者从零变成一桌人。
|
|
233
|
+
成本:主角暴露了自己在查这件事。
|
|
234
|
+
|
|
235
|
+
**运行二**:家属投诉夜班无人应答。护士长解释"人手不够"。主角把上周的在岗签到摊开。
|
|
236
|
+
护士长改口成"我安排失误"。
|
|
237
|
+
状态变化:解释空间从"客观条件"退到"个人失误";主角的执行难度上升——对方开始
|
|
238
|
+
避免在有记录的场合说话。
|
|
239
|
+
成本:主角被调离了能接触交接本的岗位。
|
|
240
|
+
|
|
241
|
+
**运行三**:科室会议上,护士长干脆不解释了,改为反问主角为什么总盯着排班。
|
|
242
|
+
状态变化:对手学会了机制,开始拒绝进入触发条件。
|
|
243
|
+
——这里就是耗尽点:**机制要继续生效,必须让对手继续开口,而他已经知道不该开口**。
|
|
244
|
+
|
|
245
|
+
**三种处置各自会走向哪里**:
|
|
246
|
+
|
|
247
|
+
- *收束*:主角把仅剩的一次机会用在一个对方无法沉默的场合(比如必须签字的责任书),
|
|
248
|
+
换来结果,同时暴露自己而失去这条路径。循环结清,单元结束。
|
|
249
|
+
- *改造*:机制保留,换掉前提——不再由主角发问,而是由那位年轻护士自己在有记录的场合
|
|
250
|
+
提问。适用范围变了,代价结构也变了(风险转到她身上),观众不必重新学机制,但要
|
|
251
|
+
重新为她担心。
|
|
252
|
+
- *移交*:护士长学会了同一套办法,反过来在有记录的场合逼主角表态。观众第一次从
|
|
253
|
+
承受者的位置看这套机制,情绪完全不同。
|
|
254
|
+
|
|
255
|
+
*并接会怎样*:不处置以上任何一种,直接开一条"主角发现药品短缺"的新线。旧账没还,
|
|
256
|
+
新线又要从头建立时限与退出成本,两边都变弱。
|
|
257
|
+
|
|
258
|
+
## 10. 失败征兆与审查问题
|
|
259
|
+
|
|
260
|
+
### 失败征兆
|
|
261
|
+
|
|
262
|
+
- 单元里找不到被反复运行的东西,只有一串不同的事件;
|
|
263
|
+
- 第一次运行和后面一样快,观众没有机会看懂机制;
|
|
264
|
+
- 几次运行可以任意交换顺序而无损失;
|
|
265
|
+
- 兑现规模变大而状态变化变小;
|
|
266
|
+
- 对手为了让机制继续奏效而作出不合理选择;
|
|
267
|
+
- 旧循环没有结清就开了新循环,新循环的紧迫性只剩形容词;
|
|
268
|
+
- 落差型循环连续多次没有留下任何确定损失;
|
|
269
|
+
- 把"每集一次运行"当成硬性配方,或用运行次数证明质量。
|
|
270
|
+
|
|
271
|
+
### 审查问题
|
|
272
|
+
|
|
273
|
+
审查者引用分集地图或剧本证据回答:
|
|
274
|
+
|
|
275
|
+
1. 这个单元反复运行的是什么?观众每次期待的具体回报是什么?
|
|
276
|
+
2. 第一次运行是否把机制演示清楚?观众凭什么在第二次就有期待?
|
|
277
|
+
3. 每次运行改变了认知、难度、适用范围、知情者或退路中的哪一项?
|
|
278
|
+
4. 主角每次运行付出了什么?这个循环是不是免费的?
|
|
279
|
+
5. 有没有出现耗尽症状?其中是否包含"对手必须变笨"?
|
|
280
|
+
6. 循环换代时用的是收束、改造、移交,还是并接?
|
|
281
|
+
7. 新循环的时限、退出成本和观众赌注从哪里来?"什么都不做会怎样"的答案变具体了吗?
|
|
282
|
+
8. 是否把循环长度、运行次数或换代位置当成了质量门槛?
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
# 多集整稿接入与断点续跑
|
|
2
|
+
|
|
3
|
+
当创作者给的是一份已经写好的多集剧本、散稿或合订稿,并希望生成或补齐
|
|
4
|
+
`项目开发/episode-map.jsonl` 时使用本流程。它不是小说改编分析,也不是把整份文件塞进一次
|
|
5
|
+
提示词:**Agent 判断这份文件实际怎样分集、每集讲了什么;脚本只保存精确定位并防止重复劳动**。
|
|
6
|
+
|
|
7
|
+
## 不变边界
|
|
8
|
+
|
|
9
|
+
- 原文件原样保存在 `输入/`;byte span 按原始字节计算,CRLF 不做归一化。
|
|
10
|
+
- 自动标题识别只生成候选索引,不是对文件语义的裁决。不要为了迎合脚本而改写创作者原文。
|
|
11
|
+
- 不把整稿、全部分集正文或整季 map 塞进 heredoc、内联 Python、命令参数或单次模型上下文。
|
|
12
|
+
- `episode_intake.py` 不生成转折、回报、钩子等创作字段。它只做索引、校验、单集切片、
|
|
13
|
+
完成集推导和 Agent 所写记录的原子合并。
|
|
14
|
+
- 批次没有通用固定值。Agent 先看索引里的各集 `byte_length`、实际复杂度和当前可用上下文,
|
|
15
|
+
再为**本轮**明确选择 `--batch-size`;首轮宜保守,读过真实切片后可以调整。
|
|
16
|
+
|
|
17
|
+
## 1. 在工作区只建一次候选索引
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
python3 <本技能目录>/scripts/episode_intake.py index \
|
|
21
|
+
输入/<完整剧本> \
|
|
22
|
+
--source-ref 输入/<完整剧本> \
|
|
23
|
+
--out 项目开发/_work/episode-intake-index.next.json
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
脚本识别短独立行形式的 `第N集`、`第N集 标题` 与 Markdown `# EP N`,统一写成规范
|
|
27
|
+
`EP001` ID。索引只含行/字节跨度、长度与结构问题,不含正文。
|
|
28
|
+
|
|
29
|
+
退出码 `0` 表示机械结构自洽;退出码 `2` 表示候选已落盘但有缺号、重号、空集或未识别等
|
|
30
|
+
问题。
|
|
31
|
+
|
|
32
|
+
`unmapped_spans` 用 locator 标出**落在任何一集跨度之外**的材料——实际上就是第一个集标题
|
|
33
|
+
之前的前言与目录。它标不出集间说明与尾注:分集跨度从一个集标题一直延伸到下一个集标题
|
|
34
|
+
(最后一集延伸到文件末尾),两集之间不存在空隙,所以一段插在中间的制作方说明会被并进
|
|
35
|
+
前一集,尾注会被并进最后一集,`problems` 仍是空的。**这不是可以靠正则补上的**:
|
|
36
|
+
「这一段属于上一集还是不属于任何一集」是语义判断,扩大正则去猜作品语义正是下一段
|
|
37
|
+
禁止的做法。
|
|
38
|
+
|
|
39
|
+
所以「材料不会静默丢失」这条要靠下面的边界检查来保证,而不是靠 `unmapped_spans` 报全:
|
|
40
|
+
Agent 必须对每个 `unmapped_spans` 做小范围检查,**并且**按下一段的做法读每一集的首尾几行,
|
|
41
|
+
确认边界落在正确的位置。
|
|
42
|
+
此时根据候选中的 line span,只读取疑似边界附近的小段,判断**这份文件**使用的是
|
|
43
|
+
幕标题、分隔线、混合标题、目录加正文还是别的规律。不要扩大自动正则去猜作品语义。
|
|
44
|
+
|
|
45
|
+
非标准结构由 Agent 写一个很短的 JSONL 边界文件,每行只给规范 `episode_id` 与 1-based
|
|
46
|
+
`line_start`,必要时给 `line_end`;然后让工具推导精确 byte span:
|
|
47
|
+
|
|
48
|
+
```jsonl
|
|
49
|
+
{"episode_id":"EP001","line_start":12}
|
|
50
|
+
{"episode_id":"EP002","line_start":58}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
```text
|
|
54
|
+
python3 <本技能目录>/scripts/episode_intake.py manual-index \
|
|
55
|
+
输入/<完整剧本> <临时边界.jsonl> \
|
|
56
|
+
--source-ref 输入/<完整剧本> \
|
|
57
|
+
--out 项目开发/_work/episode-intake-index.next.json
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
`manual-index` 仍会机械阻断重号、跳号、倒序、空跨度和非规范 ID,但不会判断一幕是否应该
|
|
61
|
+
属于上一集还是下一集;这个选择仍由 Agent 结合文件内容完成。
|
|
62
|
+
|
|
63
|
+
自动或手工候选通过检查后,把它发布到正式 owner 路径;不要让 intake 工具直接覆盖规范索引:
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
python3 <本技能目录>/scripts/episode_intake.py verify \
|
|
67
|
+
项目开发/_work/episode-intake-index.next.json 输入/<完整剧本>
|
|
68
|
+
|
|
69
|
+
python3 <core 技能目录>/scripts/project_tool.py publish <项目根> \
|
|
70
|
+
--owner short-drama-develop --artifact-id series:episode-intake-index \
|
|
71
|
+
--output 项目开发/episode-intake-index.json=项目开发/_work/episode-intake-index.next.json \
|
|
72
|
+
--input 输入/<完整剧本>
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
发布成功且下游命令已改读正式索引后再删除工作区候选。可重建索引仍通过 owner 的 `publish` 发布,以保持路径所有权和原子替换。
|
|
76
|
+
|
|
77
|
+
## 2. 每次只读当前集
|
|
78
|
+
|
|
79
|
+
任何切片前都验证索引;原文件变化一个字节就重建,不沿用旧 locator:
|
|
80
|
+
|
|
81
|
+
```text
|
|
82
|
+
python3 <本技能目录>/scripts/episode_intake.py verify \
|
|
83
|
+
项目开发/episode-intake-index.json 输入/<完整剧本>
|
|
84
|
+
|
|
85
|
+
python3 <本技能目录>/scripts/episode_intake.py progress \
|
|
86
|
+
项目开发/episode-intake-index.json 输入/<完整剧本> \
|
|
87
|
+
项目开发/episode-map.jsonl --batch-size <本轮由 Agent 决定>
|
|
88
|
+
|
|
89
|
+
python3 <本技能目录>/scripts/episode_intake.py slice \
|
|
90
|
+
项目开发/episode-intake-index.json 输入/<完整剧本> EP001 \
|
|
91
|
+
--out <临时单集文件>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
只读取 `next_batch` 指向的单集切片。Agent 根据每集自己的进入状态、追求、阻力、因果升级、
|
|
95
|
+
局部结果和出去压力写 map 记录;需要连续性时只携带已接受的紧凑前情、上一集交接和已有 map
|
|
96
|
+
相关记录,不回读整稿。每完成一集先落到短 batch JSONL,随后再处理下一集。
|
|
97
|
+
|
|
98
|
+
## 3. 合并与发布
|
|
99
|
+
|
|
100
|
+
`merge` 读取当前 map,但必须把结果写到另一个候选文件,绝不直接覆盖当前项目事实:
|
|
101
|
+
|
|
102
|
+
```text
|
|
103
|
+
python3 <本技能目录>/scripts/episode_intake.py merge \
|
|
104
|
+
项目开发/episode-intake-index.json 输入/<完整剧本> \
|
|
105
|
+
<本轮 batch.jsonl> 项目开发/episode-map.jsonl \
|
|
106
|
+
--out 项目开发/episode-map.next.jsonl \
|
|
107
|
+
--batch-size <本轮由 Agent 决定>
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
它拒绝未知 ID、批内重号、超过本轮显式上限的记录和对已完成集的冲突重写;相同记录重放是
|
|
111
|
+
no-op。合并成功后,通过 core 的公开生命周期把 `episode-map.next.jsonl` 作为同一 artifact
|
|
112
|
+
的新候选发布,并声明它实际读取的完整剧本与索引:
|
|
113
|
+
|
|
114
|
+
```text
|
|
115
|
+
python3 <core 技能目录>/scripts/project_tool.py publish <项目根> \
|
|
116
|
+
--owner short-drama-develop --artifact-id series:episode-map \
|
|
117
|
+
--output 项目开发/episode-map.jsonl=项目开发/episode-map.next.jsonl \
|
|
118
|
+
--input 输入/<完整剧本> \
|
|
119
|
+
--input 项目开发/episode-intake-index.json
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
发布完成后再删除临时候选和单集切片。不要让 `merge` 直接覆盖
|
|
123
|
+
`项目开发/episode-map.jsonl`,也不要绕过 `project_tool.py` 手工替换它。
|
|
124
|
+
|
|
125
|
+
中断后先重新运行 `progress`;项目工具可用时也读取 `status`。磁盘上的当前
|
|
126
|
+
`episode-map.jsonl` 是唯一完成真相;checkpoint 若需要只是由它重建的缓存,不能用
|
|
127
|
+
`last_completed` 猜连续进度。已有 `EP001`、`EP003` 时,`EP002` 仍会出现在 pending,已完成
|
|
128
|
+
记录不会重跑。全部 `pending` 清空后,再做所有者检查、创作者接受与审查。
|
|
@@ -0,0 +1,211 @@
|
|
|
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
|
+
题材卡——先按 [genre-cards.md](genre-cards.md) 取主题材那一张,再用本文校准装置那一层。
|
|
26
|
+
|
|
27
|
+
若创作者的设定里没有这类外来优势,本文整篇不适用,不要为了"更有卖点"而加装置。
|
|
28
|
+
|
|
29
|
+
**`craft_default`**:装置只调整信息与能力的分配,不改写题材的压力来源、观众回报与
|
|
30
|
+
结局承诺。
|
|
31
|
+
|
|
32
|
+
## 共同的失效机制
|
|
33
|
+
|
|
34
|
+
两类装置坏掉的方式是同一个形状,先认这个形状,再看各自的处理:
|
|
35
|
+
|
|
36
|
+
1. **阻力被抽空**:主角每次都提前知道或直接获得答案,段落退化成"执行已知正确操作"的
|
|
37
|
+
流程演示。观众能看出结果不再由选择决定。
|
|
38
|
+
2. **对手不学习**:装置让主角持续正确,对手却仍用同一套手段,于是中段开始,场上没有
|
|
39
|
+
任何人能改变结果。
|
|
40
|
+
3. **装置替戏说话**:本该由行动、证据和对峙承担的信息,改由记忆闪回或规则宣告直接讲出来。
|
|
41
|
+
省了戏,也省掉了观众的参与。
|
|
42
|
+
4. **规则通胀**:写不下去时给装置加新能力或新条款救场。每加一次,先前所有段落的紧张
|
|
43
|
+
感都被追溯性地削弱。
|
|
44
|
+
|
|
45
|
+
对应的共同解法只有一条:**给装置装上边界,并让边界本身产生成本**。装置能做什么要写
|
|
46
|
+
清楚,不能做什么要同样清楚,且使用它必须付出可见代价。
|
|
47
|
+
|
|
48
|
+
### 两层必须分开:创作者契约与剧中披露
|
|
49
|
+
|
|
50
|
+
这是本文最容易写坏的地方。装置有两个不同的东西,混成一层会同时误伤两种正当设计:
|
|
51
|
+
|
|
52
|
+
- **装置契约(创作者层)**:能力范围、失效条件、代价、以及规则是否可靠。它属于创作者
|
|
53
|
+
已接受的事实,**从一开始就可以是完整的**,写在故事引擎里供后续对账。它不需要、通常也
|
|
54
|
+
不应该在装置首次生效时就全部告诉观众。
|
|
55
|
+
- **披露状态(剧中层)**:此刻人物以为装置是什么、观众被允许知道多少。它可以是残缺的、
|
|
56
|
+
可以是错的,也可以是装置本身在说谎。
|
|
57
|
+
|
|
58
|
+
分开之后,两种设计都不再被误判:**边界后来才被发现**是正当的(甚至是主要的悬念来源);
|
|
59
|
+
**装置的宣告不可靠**也是正当的(欺骗性系统、记错的前世、别有用心的告知者)。被禁止的
|
|
60
|
+
只有一件事:**没有上游依据的事后扩权或免除代价**——即契约里从来没有过这条能力,写到
|
|
61
|
+
困境时凭空给出来。
|
|
62
|
+
|
|
63
|
+
**`reviewed_invariant`**:装置契约的**每一条条款**都必须在该条款首次生效前被创作者接受,
|
|
64
|
+
并记录能力范围、失效条件、代价与规则可靠性;剧中披露可以晚于契约、可以不完整、也可以被
|
|
65
|
+
人物或装置本身误述。后续段落里出现的每一项装置能力或豁免,都要能追溯到某一条已接受条款;
|
|
66
|
+
追溯不到即为事后扩权,按缺陷处理。观众在某一刻不知道全部边界,本身从不构成缺陷。
|
|
67
|
+
|
|
68
|
+
闸门是**条款级**而不是装置级:装置在第一集生效之后,仍然可以新增条款,只要走
|
|
69
|
+
「先改契约表并让创作者接受 → 再在剧中披露」这个顺序。但要防住一种形式合规的滥用——
|
|
70
|
+
写不下去时补一条新条款、让它被接受、再写出来。程序上无懈可击,实质上就是上面第 4 条
|
|
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
|
+
|
|
102
|
+
观众知道多少前世,与主角知道多少是两个旋钮:
|
|
103
|
+
|
|
104
|
+
- **观众与主角同步**:悬念强,观众和主角一起赌。
|
|
105
|
+
- **观众知道得更多**(例如先看到前世结局):主角每一步"聪明"都自带紧张感,因为观众
|
|
106
|
+
知道哪里会出错。
|
|
107
|
+
- **观众知道得更少**:主角行为反常,观众带着疑问追看,代价是前期共情较慢。
|
|
108
|
+
|
|
109
|
+
三种都成立,但必须选定并保持;中途切换会让观众不知道该替谁着急。这一项服从信息释放
|
|
110
|
+
校准规则(`STY-15`),并写进单集契约的信息权限栏。
|
|
111
|
+
|
|
112
|
+
### 合成例:边界如何创造压力
|
|
113
|
+
|
|
114
|
+
角色甲记得三个月后仓库会失火,不记得起火点,也不记得当天自己为什么不在场。她提前
|
|
115
|
+
换掉线路,火仍然发生了——只是提早了两周,而且这一次她在场。装置给了她一次干预机会,
|
|
116
|
+
干预本身改变了她后续所有记忆的可靠性,也让她第一次意识到:她记得的那个版本里,
|
|
117
|
+
可能有人是故意的。
|
|
118
|
+
|
|
119
|
+
这段成立是因为三件事同时发生:信息被用掉了、结果偏离了记忆、并且偏离本身成了新的
|
|
120
|
+
悬念。只写"她提前换了线路所以避免了火灾"就同时丢掉了这三样。
|
|
121
|
+
|
|
122
|
+
## 授权型装置(外部规则给出能力)
|
|
123
|
+
|
|
124
|
+
主角获得一套由外部宣告的规则:能力、任务、数值、奖惩。
|
|
125
|
+
|
|
126
|
+
### 宣告是一次披露,不是新增契约
|
|
127
|
+
|
|
128
|
+
这里要用上前面那两层。装置在剧里宣告一条规则时,发生的是**披露**:契约里已有的一条
|
|
129
|
+
被说给人物和观众听。宣告不创造契约条款——**先有契约,才能宣告**。所以宣告前要回答的
|
|
130
|
+
不是"这条规则听起来好不好",而是"契约里有没有这条,它在后面每一次相关处境是否都成立"。
|
|
131
|
+
|
|
132
|
+
观众会记住被说出口的条款并逐集对账,所以披露过的内容有它自己的重量:
|
|
133
|
+
|
|
134
|
+
- **契约里没有的,不要宣告**。写到困境时临时宣告一条新能力,就是事后扩权,只是换了个
|
|
135
|
+
好听的形式。
|
|
136
|
+
- **数值、时限、冷却、次数一经披露就被记住**。不确定能否守住,就在契约里写成定性条件,
|
|
137
|
+
披露时也只披露定性部分——不要先给一个精确数字再回头改。
|
|
138
|
+
- **宁可少披露**。契约可以完整而暂不披露;已披露又被违反的收不回来。这两句不矛盾:
|
|
139
|
+
前者说的是披露节奏,后者说的是披露之后的约束。
|
|
140
|
+
- **可以设计不可靠的宣告**,但不可靠本身要写进契约(它是"装置会误述",而不是"作者改了
|
|
141
|
+
主意")。后续揭穿时,观众能回看出线索,才算兑现而不是失约。
|
|
142
|
+
|
|
143
|
+
**`reviewed_invariant`**:每一条已披露的装置规则都能追溯到已接受的装置契约;违反已披露
|
|
144
|
+
规则时,要么它在契约里本就标为不可靠并已埋线索,要么按冲突处理。装置规则的对账走铺垫
|
|
145
|
+
债务台账,与其他已接受事实一起被引用。
|
|
146
|
+
|
|
147
|
+
### 代价是唯一的张力来源
|
|
148
|
+
|
|
149
|
+
无代价的能力等于没有装置。代价要落在**观众看得见、且主角在意的东西**上:时间、身体
|
|
150
|
+
状态、关系、名声、只能用一次的机会、下一次使用的可用性。写成"消耗精神力"这类不可
|
|
151
|
+
见量,等于没有代价——除消耗之外还要有可见后果。
|
|
152
|
+
|
|
153
|
+
### 装置不替主角做决定
|
|
154
|
+
|
|
155
|
+
它可以给能力、给信息、给限期任务,但**不能替他选**。让装置提出选项、由主角付代价
|
|
156
|
+
选择,段落才有主体。若每次装置宣告后主角只是照做,主角就退化成执行者,观众没有可
|
|
157
|
+
认同的对象。
|
|
158
|
+
|
|
159
|
+
### 载体与可读文字义务
|
|
160
|
+
|
|
161
|
+
这类装置常常同时用两个载体:一层声音(画外的宣告)和一层画面上的可读文字(面板、
|
|
162
|
+
提示、数值)。这会产生真实的下游后果:
|
|
163
|
+
|
|
164
|
+
- 画面上必须能读的文字属于 `exact-readable`,与全局"画面不出现任何文字"的策略**直接
|
|
165
|
+
冲突**。选择了屏显载体,就要在资产与提示词环节指定唯一允许的文字内容与受控显示位置,
|
|
166
|
+
剧本环节要把这类必须可读的文字与普通叙述区分标注(`SCR-07`),图片提示词环节再据此定文字策略。
|
|
167
|
+
- 若项目决定不做屏显,装置信息就只能靠声音与人物反应承载;此时更要写清主角听到之后
|
|
168
|
+
的可见处理,否则观众只听到条款、看不到影响。
|
|
169
|
+
- 两个载体同时用时,不要让它们逐字重复:声音给条款,画面给当前数值与变化,或者反过来。
|
|
170
|
+
两边说同一句话会占掉两份注意力却只给一份信息。
|
|
171
|
+
|
|
172
|
+
### 合成例:条款如何变成戏
|
|
173
|
+
|
|
174
|
+
装置宣告:角色乙在同一处所内可以让一个人忘记刚发生的三十秒,每日一次,使用后他自己
|
|
175
|
+
会短暂失去平衡感。这条规则在后面每一集都可被对账:他不能远程用、不能对两人用、不能
|
|
176
|
+
连用,而且用完的那几秒他站不稳——这几秒正好够对手察觉异常。能力、边界与代价在同一
|
|
177
|
+
句里给全,之后所有段落都能从中长出选择:救人还是留着这一次、忘掉的三十秒里对方到底
|
|
178
|
+
说了什么、有人开始记录他每次站不稳的时间点。
|
|
179
|
+
|
|
180
|
+
## 与既有机制的接口
|
|
181
|
+
|
|
182
|
+
装置不新建一套体系,它只是几条既有机制的特例:
|
|
183
|
+
|
|
184
|
+
| 装置带来的问题 | 交给既有机制 |
|
|
185
|
+
|---|---|
|
|
186
|
+
| 装置契约(范围、失效、代价、可靠性)存在哪里 | 故事引擎的装置条目,与承诺和引擎一起被创作者接受并引用 |
|
|
187
|
+
| 剧中披露到哪一步、谁知道什么 | 单集契约的信息权限栏,随集推进;世界事实、人物认知与观众知情分层见所有权契约 |
|
|
188
|
+
| 未来信息与前世事实的释放节奏 | 信息释放校准规则 `STY-15`,落在单集契约的信息权限栏 |
|
|
189
|
+
| 前世/现世两条时间线的状态不混 | 跨集记忆见 [serial-character-and-memory.md](serial-character-and-memory.md);跨场状态见资产环节的变化记录 |
|
|
190
|
+
| 已披露规则的对账与追溯 | 铺垫债务与 `setup_ids`/`payoff_ids` 台账 |
|
|
191
|
+
| 装置揭示不能凭空反转 | [reveal-reversal-payoff.md](reveal-reversal-payoff.md) |
|
|
192
|
+
| 屏显条款的可读文字义务 | 剧本生产标签与图片提示词的文字策略 |
|
|
193
|
+
| 闪回属于自己的时间分支 | 资产环节的变化记录不被闪回重写 |
|
|
194
|
+
|
|
195
|
+
## 自检
|
|
196
|
+
|
|
197
|
+
1. 主题材那张卡读了吗?装置有没有被当成题材、顶替了压力来源?
|
|
198
|
+
2. 用到的每一条条款是否都在它首次生效前被接受,且写清了能力范围、失效条件、代价与可靠性?
|
|
199
|
+
3. 剧中披露到哪一步,是否记在信息权限栏里?**不要**把"观众还不知道全部边界"当成缺陷。
|
|
200
|
+
4. 后续出现的每一项装置能力或豁免,能否追溯到某一条已接受条款?追溯不到的在哪一集?
|
|
201
|
+
新增的条款是由设计需要驱动,还是刚好出现在主角脱不了困的那一集、且没带来新代价?
|
|
202
|
+
5. 阻力靠什么补回来?去掉装置以后,这一集还剩下选择吗?
|
|
203
|
+
6. 对手在装置生效后学到了什么、改了什么做法?
|
|
204
|
+
7. 先知型:记忆的切法选了哪一种?它会随剧情衰减,还是需要作者不断找理由削弱主角?
|
|
205
|
+
8. 先知型:起点落在哪个可指认的错误或损失之前?第一笔债务是什么?
|
|
206
|
+
9. 先知型:观众信息权限选了哪一档,全剧是否保持一致?
|
|
207
|
+
10. 授权型:已披露的每条规则,在你还没写的高潮段里是否仍然成立?
|
|
208
|
+
11. 授权型:若设计了不可靠宣告,契约里是否标明,并已埋下可回看的线索?
|
|
209
|
+
12. 授权型:代价是否可见、是否落在主角在意的东西上、是否有除消耗之外的后果?
|
|
210
|
+
13. 授权型:装置是提出选项,还是替主角做了决定?
|
|
211
|
+
14. 授权型:用了屏显载体吗?可读文字义务是否已经交代,且没有与无字策略并存?
|