film-scene-asset

name: film-scene-asset description: Use when turning script locations into a final empty-environment master-shot scene asset for the current Banana/Veo short-drama pipeline. This stage must inherit the selected type-analysis style and lighting, lock one reusable camera truth, and exhaustively enumerate everything visible in that master shot for downstream prompt assembly.

Scene Asset

Overview

This skill must not write a vague location essay.

Its job is to output one reusable empty-plate master shot scene packet.

That packet is the final scene truth used by downstream prompt translation.

Think of it as:

not a loose room description
not a mood board
not a generic architecture summary
but a production-facing scene control contract

It must output a dual-layer structure:

control_table
production_bible

Rules:

downstream automation reads only control_table
production_bible is only for lightweight human review and reuse
if the two layers conflict, control_table wins
the scene must be analyzed as the final reusable empty-environment master shot view of the location

Authority

This skill should follow the active project spec first.

Current mainline reference:

${OPENCLAW_HOME:-~/.openclaw}/agents/flashxiaolagu制作/production-optimization-spec.md

Read master-shot-checklist.md when:

writing master_shot_environment_manifest
translating StyleDesign into room-specific light behavior
deciding zone naming
checking whether the master shot is truly reusable

If the user is explicitly running another preserved baseline with its own local spec, that local spec can override this reference.

Core Principles

the core deliverable is one stable empty-environment master-shot view that already contains the decisive spatial truth of the room
the scene must inherit the selected RatioDesign and StyleDesign from film-type-analysis
StyleDesign already absorbs lighting, so this skill must translate that selected style into concrete room light behavior
write only what is visible or spatially implied by that master shot, not a generic room summary
the master shot must preserve the decisive axis side and the key confrontation or action corridor the scene needs
the output must be detailed enough that downstream prompt assembly can reconstruct the scene without re-reading the whole script
zone names must stay practical and reusable across downstream stages such as film-engineering-book and film-shot-design
control_table keeps only structural, visual, reusable, generation-facing data
production_bible stays lightweight and must not add new hard layout facts

When to Use

at project start, after film-type-analysis
when turning script locations into reusable scene control data
when downstream prompts need one final empty-plate master-shot environment truth

Input

full script text
analysis/film-type-analysis.json

Optional context when available:

project naming or scene numbering
prior locked continuity notes

This skill must read the selected option from film-type-analysis and explicitly inherit:

selected_option.ratio_design
selected_option.style_design

style_design is mandatory because it carries the final light / color / contrast design. ratio_design is mandatory because the room master shot must lock the same framing logic as the selected project branch.

If selected_option is missing, or if either inherited field is missing, stop and request a corrected film-type-analysis.json instead of guessing.

Output

analysis/scene-analysis.md
analysis/scene-analysis.json

Working Method

Build the scene asset in this order:

read the scene from a production angle and identify what dramatic use the room must support
inherit the selected ratio_design and style_design
choose one final reusable empty-plate master shot that best preserves the scene's decisive confrontation or action geography
define practical reusable zone names for the visible play areas
convert the selected style_design into concrete room light behavior for this exact view
enumerate the environment from foreground to background and from floor to ceiling, as it appears in this master shot
lock axis continuity and extraction targets
keep production_bible short and secondary

The result should feel like a ready-to-use scene master packet, not like a prose summary.

Required Structure

Each scene must contain:

scene_id
name
control_table
production_bible

`control_table` keep only

scene_narrative_identity
style_inheritance
human_presence_policy
master_shot_camera_design
master_shot_subject_blocking
scene_zone_map
master_shot_lighting_design
master_shot_environment_manifest
axis_continuity_locks
background_extract_targets

`production_bible` keep only

narrative_support_note
continuity_watchlist
off_frame_inference_note

What To Remove

Do not keep these as default persisted output:

generic atmosphere prose without visible support
vague statements like "warm and lived-in" without concrete objects or material evidence
long shooting-theory explanations
duplicated story-support paragraphs
a second competing room description outside the master-shot truth
generic lighting phrases that ignore the selected StyleDesign

Required JSON Shape

{
  "scenes": [
    {
      "scene_id": "scene_001",
      "name": "小泽的公寓卧室",
      "control_table": {
        "scene_narrative_identity": "这是一个单身理工男在自己狭窄卧室里，被突然闯入的母女堵到床边、发生强对峙的晨间公寓空间；用于生成可复用的空场景 master plate。",
        "style_inheritance": {
          "ratio_design": "9:16",
          "style_design": "[窗光] + [青橙色调] + [高反差] + [电影数字质感]",
          "inheritance_note": "场景图必须完整继承已选风格，不得改写成无关布光或另一套色调。"
        },
        "human_presence_policy": {
          "mode": "no_people",
          "reason": "这是可复用空场景底板，人物必须在角色层和分镜层单独进入。"
        },
        "master_shot_camera_design": {
          "shot_size": "带完整环境关系的叙事全景 master shot",
          "camera_height": "平视略高机位，约1.45米",
          "camera_side_of_axis": "站在主对峙轴线的窗侧这一面，斜向门口",
          "composition_logic": "门、床、窗、走道四个核心锚点同时成立",
          "frame_must_include": [
            "左后房门与完整门框",
            "右前床边与可落道具的床面",
            "右后窗与书桌",
            "门到床之间的完整留白走道"
          ],
          "stable_reference_reason": "这个视角一次性保住闯入、受击、推进、落道具四类动作所需空间真相。"
        },
        "master_shot_subject_blocking": {
          "xiaoze_position": "画面右前床沿",
          "woman_position": "画面左后门口内侧半步",
          "girl_position": "女人右前方半步，位于走道上",
          "visible_corridor": "门口到床边之间必须留出完整可见走道",
          "facing_relation": "门口人物看向右前床边，床边人物回看左后门口"
        },
        "scene_zone_map": {
          "door_zone": "左后房门和门边墙面",
          "bed_zone": "右前双人床、床沿、床头柜",
          "report_drop_zone": "床面中央到床沿区域",
          "walkway_zone": "门到床之间的留白地面",
          "desk_window_zone": "右后窗、窗帘、书桌和椅子"
        },
        "master_shot_lighting_design": {
          "source_style_design": "[窗光] + [青橙色调] + [高反差] + [电影数字质感]",
          "key_light_source": "右后窗晨间自然光",
          "fill_behavior": "室内环境反弹光较弱，床边暗部允许压低但保留细节",
          "practical_light_policy": "台灯可见但默认不作为主光",
          "color_temperature_balance": "窗光偏冷，室内木色和床品带轻微暖色回弹",
          "contrast_goal": "中高反差，不能拍成均匀平光",
          "exposure_rule": "窗外不过曝炸白，室内暗部不死黑"
        },
        "master_shot_environment_manifest": {
          "foreground": "右前床沿、床面、床头柜、台灯、少量生活杂物",
          "midground": "门到床的对峙走道和床区主体",
          "background": "左后房门、右后窗、书桌、衣柜或收纳区",
          "visible_environment_details": {
            "bed_zone": "1.5米双人床、灰系床品、略皱的睡醒痕迹",
            "door_zone": "深木色房门、银色门把手、简洁门框",
            "window_desk_zone": "窄窗、纱帘和遮光帘、浅木书桌、黑色办公椅、电脑和书本",
            "storage_zone": "简易衣柜、开放收纳格、少量挂放衣物",
            "floor_ceiling_zone": "木地板、拖鞋、少量随手物、白色平顶和普通吸顶灯"
          }
        },
        "axis_continuity_locks": [
          "门必须始终在左后侧",
          "床必须始终在右前侧",
          "窗和书桌必须始终在右后侧",
          "门到床之间的走道必须可见"
        ],
        "background_extract_targets": [
          {
            "target_id": "door_only_bg",
            "description": "房门、门框、门边墙面和少量地板"
          },
          {
            "target_id": "bed_only_bg",
            "description": "床、床头柜、台灯和床头墙面"
          }
        ]
      },
      "production_bible": {
        "narrative_support_note": "这是一个自带冲突路径的终极对峙视角。",
        "continuity_watchlist": [
          "不要把空间做成酒店房间或豪宅卧室"
        ],
        "off_frame_inference_note": "画外可能存在其他生活空间，但不参与本场 master-shot 真相。"
      }
    }
  ]
}

Writing Rules

0. `scene_narrative_identity` comes first

Write one decisive sentence that tells the model what kind of space this is in story terms.

It should state:

whose space it is
what dramatic function it serves in this scene
what the core confrontation, intrusion, waiting, or action use of the room is
that this is the reusable empty-plate master shot when relevant

This sentence should become the highest-weight summary inherited by downstream prompt translation.

0.3. `style_inheritance` is mandatory

This field must explicitly restate the selected upstream style contract.

It must mirror the selected option exactly, not approximately.

It should keep:

ratio_design
style_design
a short inheritance_note

Do not reinterpret style_design into a different genre, a different light source, or a different contrast system. Do not replace the selected ratio_design with a more convenient local crop guess.

0.5. `human_presence_policy` is mandatory

Default rule:

reusable scene asset = empty environment plate
no visible people
no visible human figure
no visible character silhouette

Only allow people when unfeatured crowd mass is genuinely part of the scene itself.

Recommended machine-friendly values:

no_people
background_crowd_only

If background_crowd_only is used, the crowd must be:

non-hero
not individually identifiable
part of the environmental scale, not the dramatic subject layer

1. `master_shot_camera_design` must be explicit

It must specify:

shot size of the master shot
camera height
camera side of the axis
composition logic
what decisive areas this shot must cover
why this is the stable downstream reference view

The goal is not just "show the room".

The goal is to lock the one reusable camera truth the whole location should inherit.

2. `master_shot_subject_blocking` must be spatial, not emotional

It should state:

where the bed-side subject would sit or stand
where the doorway subject would stand
where the child / support subject would stand if present
which side each subject faces
what empty path, confrontation corridor, or action lane must remain visible

Even though the final scene asset is an empty plate, the blocking truth must still be written so downstream knows why the room is composed this way.

3. `scene_zone_map` is mandatory

Name the practical reusable play areas of the visible master shot.

Use stable downstream-friendly zone names, such as:

door_zone
bed_zone
walkway_zone
desk_window_zone
wardrobe_storage_zone
report_drop_zone

These names should later be reusable by scene prompts, engineering book units, and shot design.

4. `master_shot_lighting_design` must inherit the selected style exactly

This field is mandatory.

It must translate the selected style_design into room-specific lighting behavior.

It should specify:

source_style_design
key_light_source
fill_behavior
practical_light_policy
color_temperature_balance
contrast_goal
exposure_rule

Do not replace the selected scene lighting with generic studio light.

Do not write meaningless phrases like:

cinematic lighting
nice warm mood
soft movie light

without explaining how that appears in this exact room and from which direction.

5. `master_shot_environment_manifest` must be exhaustive and visible-view-specific

Describe the visible environment as if handing it directly to a detail-hungry image model.

The description must stay tied to this exact master shot.

Prefer layered organization:

foreground
midground
background
visible environment details by zone

Use master-shot-checklist.md to ensure coverage.

Include concrete details for all major visible elements when they exist:

bed type, size, frame, bedding, pillows, blanket state
wall behind the bed, photos, art, switches, marks, shelves
bedside table, lamp, books, phone, clutter
door leaf, door color, handle, frame, nearby wall condition
window shape, curtain type, curtain color, blinds if any
desk, chair, monitor, laptop, keyboard, stationery, stacked books
wardrobe, shelf, drying rack, coat stand, storage cabinet
floor material, floor color, floor condition, objects on the floor
ceiling, ceiling light, light fixture shape

6. `axis_continuity_locks` must protect the room's dramatic logic

State only hard continuity facts, such as:

door stays on the left rear of the master shot
bed stays on the right front side
window / desk stay on the right rear
the confrontation axis runs from doorway to bedside
the action corridor must remain visible

7. `background_extract_targets` must be directly reusable

Name only practical extraction plates.

Good examples:

door_only_bg
bed_only_bg
report_drop_zone_bg
desk_window_bg
walkway_bg

Each target should include:

target_id
description

The description should explain exactly what visible area must remain in that extracted plate.

8. `production_bible` stays short

Use short notes only.

It may explain:

why this view is narratively important
what continuity mistakes to avoid
what can stay off-frame

It must not introduce a second competing layout.

Output Format

The output should be compact but concrete.

A scene JSON should feel like a ready-to-use master-shot empty-plate packet.

Constraints

Downstream automation reads only control_table.
The scene must be anchored to one final reusable empty-environment master-shot view.
style_inheritance is mandatory.
master_shot_lighting_design is mandatory.
human_presence_policy is mandatory.
scene_zone_map is mandatory.
production_bible must stay lightweight.
If the two layers conflict, control_table wins.
Output both markdown and json.
style_inheritance.ratio_design and style_inheritance.style_design must exactly inherit the selected type-analysis option.

Scene Asset

Overview

Authority

Core Principles

When to Use

Input

Output

Working Method

Required Structure

control_table keep only

production_bible keep only

What To Remove

Required JSON Shape

Writing Rules

0. scene_narrative_identity comes first

0.3. style_inheritance is mandatory

0.5. human_presence_policy is mandatory

1. master_shot_camera_design must be explicit

2. master_shot_subject_blocking must be spatial, not emotional

3. scene_zone_map is mandatory

4. master_shot_lighting_design must inherit the selected style exactly

5. master_shot_environment_manifest must be exhaustive and visible-view-specific

6. axis_continuity_locks must protect the room's dramatic logic

7. background_extract_targets must be directly reusable

8. production_bible stays short