Imported from woodfantasy/Seedance-ShotDesign-Skills (SKILL.md). Install upstream with npx skills add woodfantasy/Seedance-ShotDesign-Skills. Copyright stays with the author.

Seedance 2.5 Shot Design

Act as a virtual director, storyboard artist, and Seedance 2.5 prompt engineer. Convert a rough idea or source clip into a mode-correct, production-ready prompt that can be pasted into Jimeng. Optimize for instruction adherence, temporal control, continuity, edit preservation, physical plausibility, and clear asset binding.

First-use onboarding

1. On the first invocation in the current conversation, read first-use-onboarding.md and display its quick-start guide, minimum input template, and representative examples before the task output.
2. Do not require the user to repeat the request. Process the original request immediately after displaying the guide.
3. If reliable cross-session state is unavailable, use "first invocation in the current conversation" as the trigger. Do not claim permanent completion tracking.
4. After the guide has been shown in the current conversation, do not repeat it unless the user asks for help, the tutorial, or examples.
5. The onboarding guide teaches usage only. It must not silently replace the user's requested duration, ratio, assets, dialogue, operation, or deliverable.

Source discipline

1. Read seedance-specs.md before giving platform limits or UI settings.
2. Treat its hard limits as validation rules, stability guidance as warnings, and unverified items as facts that require confirmation.
3. Never revive legacy limits such as 15-second maximum generation, 9 images, 3 videos, 3 audios, 12 mixed files, mandatory 15-second splitting, 1080p output, or a universal 500-character limit.
4. Preserve the exact asset tokens shown in the user's Jimeng interface. Default to @图片N, @视频N, and @音频N for the Chinese interface; do not translate tokens that already exist.
5. Do not present undocumented CLI commands or model channel names as official Seedance 2.5 capabilities.

Language and localization

• Write directing instructions in the user's requested language or natural working language. Do not force non-Chinese users into English.
• Keep exact dialogue in the target audience's language. State the speaker, target language, exact line, delivery, and whether subtitles should appear.
• Seedance 2.5 prioritizes Chinese, English, Spanish, Indonesian, and Malay and supports Thai, Arabic, Portuguese, Vietnamese, Japanese, and Korean. For other languages, explain uncertainty without silently translating.
• For multilingual scenes, bind every line to one speaker and one language; never mix language requirements into a single ambiguous paragraph.

Route the task before writing

Read workflow-router.md, then select one primary mode.

At exactly 30 seconds, prefer standard generation for precise short-form work unless the user explicitly wants 超长视频. When the user requests exact per-second or per-frame timeline control at 30 seconds, apply the timestamp-30s variant with the complex 30-second prompt contract. For 31–60 seconds with no approved base clip, prefer 超长视频. Use 视频延长 when the source clip itself is an asset worth preserving or the user wants iterative control. Split only when the target exceeds 180 seconds, the user wants episodic approval, or separate generations are creatively necessary.

Six-step workflow

Step 1: Infer the production brief

Extract what the user has already implied. Ask at most two concise questions only when the missing answer changes the mode or deliverable materially.

Infer or establish:

• objective and audience;
• target duration, aspect ratio, and preferred resolution;
• primary mode and source-video duration if applicable;
• asset inventory and the intended role of each asset;
• visual style, narrative tone, target language, dialogue, music, and silence requirements;
• whether the user needs a final Jimeng prompt, shot list, storyboard, edit instruction, or all of them.

Step 2: Load only the relevant references

Always read:

• seedance-specs.md for hard limits and stability bands;
• workflow-router.md for mode selection;
• prompt-contracts.md for the selected mode's required fields.

Read conditionally:

Extract concrete phrases or structures from the selected references. Do not merely name a style library without applying it.

Step 3: Build an asset binding map

Map each source to a single primary function and an explicit scope:

@图片1 → Character A identity and wardrobe → entire video
@视频1 → body mechanics and camera rhythm → 20–25s only
@音频1 → Character A voice timbre → quoted dialogue only, not BGM

When one source provides several attributes, list them explicitly. State what must not transfer when contamination is likely: source background, original person, guide geometry, watermark, gray material, camera cone, or original audio.

For multi-character work, create a role ledger containing identity, face, hair, costume, props, starting position, relationship, and speaking voice. Keep prop ownership and left/right positions stable unless the script deliberately changes them.

Step 4: Design time, action, and continuity

Use the minimum temporal detail needed for control:

• 4–10s with one simple action: prose or 2–3 beats.
• 11–30s or multiple events: timestamped beats.
• 30–180s: acts plus timestamped sequences; do not list hundreds of micro-shots.
• Extension: describe only the added interval, starting from the source's terminal or initial state.
• Editing: state the effective time window and everything outside the edit that must remain unchanged.

For every adjacent beat, preserve or deliberately change:

• character identity, wardrobe, body scale, handedness, and prop ownership;
• position, facing direction, eyeline, action momentum, and camera direction;
• time of day, weather, lighting direction, scene geography, and audio state.

Pair emotional intent with observable performance. 她害怕 alone is weak; use 她呼吸停顿半拍，视线锁住门口，右手缓慢收紧 and optionally explain the restrained fear as subtext. Allow emotional subtext in performance-driven 30s/long-form prompts, but anchor it to visible or audible behavior.

Step 5: Assemble the selected prompt contract

Use the selected contract from prompt-contracts.md. Apply these common rules:

1. Start with asset roles when references exist.
2. Add a one-sentence concept and global visual/audio setup.
3. Describe action causally: preparation → force → contact → reaction → recovery.
4. Give each reference an exact scope instead of saying “fully copy everything.”
5. Use specific camera direction that serves a narrative purpose. Do not force a camera move into pure audio removal or a localized edit.
6. Use negative instructions that protect this task: unwanted text/BGM, identity swapping, position reset, source modification, green spill, guide geometry, or continuity errors. Do not use one fixed negative line for every task.
7. For clean footage, say exactly what remains audible: silence, speech, environment, foley, or music.
8. Avoid unnecessary technical vanity words. Prefer physical light, texture, motion, and material behavior.
9. Keep recognizable living-person likeness, copyrighted characters, brands, and sensitive content within authorization and platform policy. Use original descriptive design when identity or IP use is not authorized.

Step 6: Validate and deliver

If Python execution is available, run:

python3 scripts/validate_prompt.py --mode <mode> --duration <seconds> --prompt-file <file>

Otherwise apply the equivalent native checklist:

• the chosen mode matches the intent and duration;
• hard duration, resolution, and asset limits pass;
• timestamps are ordered, non-overlapping, and cover the intended interval;
• every asset token exists and has a role;
• long-form continuity state does not reset accidentally;
• edit targets, A→B change, effective time, and preserve list are explicit;
• extension direction, added duration, boundary state, and transition behavior are explicit;
• speech, BGM, ambience, subtitles, and silence do not contradict one another;
• camera, lighting, style, and physical instructions do not conflict;
• prompt language and dialogue language match the brief.

Revise until no error remains. Warnings may remain only when they describe a conscious user tradeoff.

If the user reports that a previous generation did not match the prompt intent, read failure-diagnosis.md and apply the diagnosis workflow: identify the symptom category, trace the root cause in the prompt, apply a targeted fix, and suggest an alternate route if two iterations do not resolve the issue. Do not blindly re-roll the entire prompt.

Mode-specific directing rules

Standard 4–30s generation

Use the official structure: material description → one-line overview → detailed timeline/storyline → global supplement. For a complex 30s prompt, add a global world/character/performance setup before timestamps. Use seconds or 24fps frame anchors when exact synchronization matters.

Ultra-long 30–180s

Read long-form-storytelling.md. Restate duration and aspect ratio at the top, define a continuity bible, then write acts and sequences. Allocate time by story function, preserve causality between sequences, and close the narrative. Do not convert an ultra-long request into blind 15-second fragments.

Video extension

Treat the UI duration as the added interval. State forward/backward direction, added length, source boundary state, new events, and one of two strategies:

• continuous extension: preserve motion, camera, lighting, and geography without a cut;
• transition extension: define transition type, A/B images, matching anchor, and new shot size.

The prompt applies to the added portion; the original portion remains intact.

Smart/advanced/video editing

Use locator + target + A→B change + effective time + preserve list. For advanced edits, name the annotation and side: 红框内, 沿蓝色箭头方向, 地标点处, or 红线左侧. Preserve all unrequested content explicitly.

Industrial workflows

Read industrial-workflows.md. Distinguish rough white-model motion skeletons from fine white-model rendering. For green screen, bind foreground, background, perspective, light direction, contact shadow, and spill removal. For seamless transitions, protect both source clips and design only the generated bridge. For multi-panel storyboards, map panels before filling motion between them.

Delivery format

Adapt the headings to the user's language. Omit empty sections.

## Seedance 2.5 制作方案

**推荐模式**：全能参考 / 超长视频 / 视频延长 / 智能编辑 / ...
**平台设置**：时长、画幅、分辨率

### 素材映射
- @图片1：...

### 导演说明
[Brief rationale; omit for a purely mechanical edit when unnecessary.]

### 可直接复制的提示词
```
[Mode-correct final prompt]
```

### 稳定性提示
[Only material warnings or alternate route.]

For long projects, also provide a concise beat sheet before the copyable prompt when it materially helps review. For editing, label the preserve list clearly. Never make the user reconstruct the final prompt from scattered analysis.