1370998960-del/https-github.com-emily2040-seedance-2.0/seedance-troubleshoot

seedance-troubleshoot

If the take is partially good rather than failed, route to [ref:retake-protocol] triage first - most takes deserve a verdict, not a rewrite. Diagnose failure before rewriting. Do not simply add more adjectives. Identify whether the failure came from mode mismatch, overload, ambiguity, fragile identity, unsafe wording, unsupported platform behavior, or missing preservation constraints.

When the diagnostic tree has no row for the failure, load [ref:model-mechanics] and diagnose by mechanism: attention dilution, prior conflict, summoned negation, broken trajectory, compounding error, conditioning conflict, capacity starvation, or an overloaded audio-video joint constraint. Load [ref:field-observed-tips], [ref:reference-workflow], and [ref:api-workflow] when the failure involves continuation, edit/extend, source clips, audio references, or platform-specific errors. Load [ref:shot-list-continuity] for multi-shot drift and [ref:delivery-qc] for final-client or delivery failures. When sequence state is present, load [ref:failure-atlas], [ref:continuation-handoff], and [ref:continuity-qc]; diagnose against continuity locks, completed beats, exact reference tags, and reserved future beats.

Intent

A failed generation feels personal - the user showed the machine their idea and the machine returned something broken. The soul of this skill is rescue without blame: name the mechanism, never the user; save the idea, not just the prompt. They should leave with a fix and their confidence intact.

Diagnostic Tree

Repair Process

First quote the failing phrase or missing element. Then name the root cause. Next, remove conflicts rather than adding complexity. Recommend one primary repair variable rather than adding more adjectives. Finally, produce one conservative retry prompt and one optional creative variant only if the user wants exploration.

Conservative Retry Pattern

[Reference role if any]. Preserve [identity/product/environment] exactly. One visible action: [specific verb and consequence]. Camera: [single move]. Lighting: [physical source]. Sound: [ambient/SFX/dialogue]. Constraints: [what must not change].

Escalation Rules

If the same error repeats, split the scene into shorter clips, reduce characters, simplify hand or face motion, use stronger reference role mapping, or change the mode. For unstable text/logos, keep them static, centered, and protected; do not ask the model to redraw small text during motion.

For edit/extend failures, preserve the source clip first and change only the failing layer. If a surface supports returned last frames, use that still as the next first-frame anchor before extending.

Output Contract

Return root cause, evidence from the prompt or result, repaired prompt, and one conservative retry variant.