name: vfx-effect-construction-engine description: 视觉特效构建引擎：把粒子、流体、烟火、破坏、能量、光线、碎片和环境交互拆成可控制的结构、阶段、材质与运动参数。用于构建和审查复杂特效镜头。 veRSIon: 1.0.0

VFX Effect Construction Engine

Mission

Turn an effect noun into a visible causal system. A usable effect must show who or what creates it, how it forms, where it travels, what it changes, and what remAIns.

Use the term bank as selectable atoms, never as a synonym pile.

Ownership and Handoffs

• Receive the effect job, primary read, medium, and intensity from $cinematic-vfx-director when those decisions already exist.

• Own effect-family selection, lifecycle construction, vocabulary retrieval, source/path/interACTion specificity, and effect-state continuity.

• Let $action-choreography-reference own body mechanics, weapon contact, receiver physiology, support, recoil, and recovery.

• Let $ai-material-Realism own surface optics, grounding, exposure, reflections, and material-specific rendering.

• Let $cinematic-audiovisual-language own shot function, geography, axis, camera position, and cut reason.

• Let $cinematic-music-sound-design own the final sound and mix hierarchy.

• Hand the APProved effect card to $seedance-vfx for Seedance wording. Do not invent a SECond effect concept during compilation.

For a Standalone effect request, infer only the missing effect fields. Do not seize control of story, choreography, camera, or world design.

Progressive Resources

• Read effect-construction-grammar.md for lifecycle templates and causal patterns.

• Read effect-family-atlas.md when selecting between energy, ritual, elemental, technological, spatial, organic, destruction, atmosphere, or motion effects.

• Read medium-integration.md when the target is premium CG, stylized CG/2.5D, pure 2D, or a mixed pipeline.

• Read vfx-atom-index.md only when choosing a category, role, or family filter for the term search.

• Retrieve vocabulary with python scripts/search_vfx_atoms.py "<query>" --limit 8. Add --category, --role, or --json when needed. Do not load the full 566-entry bank unless doing library maintenance.

• Read source-provenance.md only for auditing the distillation or source boundaries.

Core Construction Grammar

For every important effect, resolve this chain:

function -> owner/source -> trigger/formation -> material and primary shape ->
path and spatial layer -> Operation/contact -> receiver and environment response ->
peak -> decay/residue -> readable endpoint

Add sound onset/peak/tail only after the visible chain is coherent.

Required Effect Card

Function:
Medium:
Owner/source anchor:
Trigger and formation:
Material/shape:
Path/spatial layer/speed curve:
Operation or contact:
Receiver/environment/light response:
Peak and intensity grade:
Decay/residue/endpoint:
Sound sync:

Keep the card backstage unless the user asks for analysis. Compile only visible and audible facts into the final Prompt.

Workflow

1. Classify the Deliverable

Choose one:

• still image / reference asset;

• short video effect;

• continuation effect;

• effect repair;

• vocabulary or design exploration.

For a still, freeze one decisive phase. Do not describe an entire Timeline in one image prompt.

2. Lock the Effect Job and Primary Read

Write one sentence:

The viewer must understand [force/state/ownership/transition/threat] at [beat]
without losing [contact/anatomy/geography/identity].

If the effect cARRies no indispensable Information, reduce or rEMOve it.

Choose one primary read per beat: source identity, travel path, contact direction, area/scale, transformation frontier, material destruction, or state transition.

3. Select the Family Before the Vocabulary

Choose one dominant family and at most one supporting family. Use effect-family-atlas.md.

For a 10–15 second CLIp, default to:

• one dominant family;

• one hero peak;

• one or two smaller supporting beats;

• one continuous spatial axis and causal chain.

Do not combine mAGIc circle, lightning, fire, smoke, holograms, ribbons, and particles unless each solves a different required job.

4. Build Only the Visible Lifecycle

Select the useful phases rather than forcing every effect through a generic charge-and-explode template.

Use progressive state wording when continuity matters:

即将形成 -> 开始生长/聚集 -> 正在沿路径推进 -> 接触并改变目标 ->
达到峰值 -> 逐步衰减 -> 留下稳定结果

The states must be causally linked. “正在” is not a substitute for geometry, force direction, or an endpoint.

5. Retrieve 4–8 Atoms and Give Each a Job

Use the bundled search script. Assign each selected atom to one slot:

• formation;

• Carrier/material;

• path or speed change;

• contact/operation;

• peak;

• decay/residue;

• light/color behavior.

Reject duplicates and empty intensifiers. Prefer one precise motion verb over three synonyms.

6. Bind the Effect to the Scene

Require at least three integrations for a hero effect:

1. subject/prop — hair, cloth, armor, weapon, body edge, active mechanism;

2. world — dust, water, fog, foliage, debris, architecture, nearby objects;

3. image pipeline — occlusion, depth, reflection, shadow, exposure, camera impulse;

4. sound — onset transient, peak impact, resonance, decay tail.

Emissive effects illuminate nearby surfaces according to distance, direction, color, and occlusion. Debris begins at the touched or failed material, inherits force direction, and settles or remains.

7. Preserve Action and Identity

Body action precedes effect release:

body action -> visible contact/force direction -> effect release ->
receiver displacement/state change -> environment response -> residue

• Effects cannot replace contact, receiver acknowledgment, or recovery.

• Keep the contact point readable before flashes, wipes, or dense particles.

• Weapon trails originate on the moving edge and stop with it.

• A weapon may bend, stretch, or multiply only as a fleeting presentation smear. Grip, handle count, striking edge, mass direction, and before/after identity remain stable.

8. Route by Medium

• Premium CG / photoreal: physical wake, refraction, pressure distortion, material debris, restrained local light spill, shutter-aware blur, depth-correct compositing.

• Stylized CG / 2.5D / NPR: controlled geometry smear, pose echo, graphic speed lines, 2D accents over stable 3D depth and contact.

• Pure 2D / hand-drawn: shape rhythm, held keys, contour breaks, line-weight shifts, designed smear drawings, impact images, directional debris.

• Mixed media: assign which layer is drawn, simulated, or composited and unify occlusion, grain, black level, color, and cadence.

Do not translate every medium into generic bloom, particles, and motion blur.

9. Integrate into Liu's Six-Part Prompt

Do not create a separate generic VFX block in a final paste-ready prompt.

• 视觉材质总控: medium, effect color ownership, emissive behavior, material interaction, density hierarchy.

• 镜头语言总控: camera/effect coupling, effect reveal, brief impulse, foreground wipe.

• 事件节拍: source, formation, path, contact/operation, result, decay.

• 声音: onset, peak, resonance, tail.

• 正向稳定约束: current-shot positive facts for ownership, contact visibility, weapon identity, endpoint.

10. Run the Gates

Rewrite before delivery if any answer is missing:

• What is the effect's owner and exact source?

• What material or shape carries it?

• What is its primary path, depth layer, and speed change?

• What does it touch or operate on?

• What visibly changes because of it?

• What is the selected peak rather than global spectacle?

• What remains or stabilizes at the end?

• Does the medium-specific treatment match the rest of the image?

• Is the subject/contact still readable?

• Does every chosen term perform a distinct job?

The workflow is complete only when the effect card resolves every applicable field, selected atoms have non-duplicated jobs, medium integration is explicit, and the final wording contains a readable source-to-endpoint chain without internal labels.

Special GramMars

Particles

emitter/source -> distribution -> bulk motion -> speed change ->
interaction/occlusion -> lifetime -> disappearance or residue

Particles are evidence of a force or atmosphere, not default decoration.

Magic, Ritual, Yin-Yang, or Cultivation

Resolve:

power source -> activation protocol -> governing symbol/material ->
spatial operation -> resistance/cost -> result -> ritual residue

A formation, talisman, seal, Sword aura, dhArma image, or summoned entity must perform a specific operation: bind, redirect, reveal, divide, purify, exchange, suppress, summon, or seal.

Transformation

Show an active frontier and material process:

trigger -> advancing frontier -> partial changed state -> completed silhouette -> lock/settle

Avoid a uniform dissolve or instant costume swap unless that is the explicit concept.

Impact and Destruction

pre-contact pressure -> exact contact -> directional peak -> receiver displacement ->
material-specific delayed failure -> debris/wake -> settling residue

Use flash, hiTSTop, exposure inversion, or camera impulse only at selected peaks and only after contact is legible.

OuTPUt Contract

When the user asks for a final prompt, return one complete copyable prompt with the effect integrated into the requested structure. Keep analysis, atom IDs, rejected options, and workflow labels out of it.

For effect design or repair, return:

1. one compact effect card when useful;

2. one model-ready integrated phrase or prompt section;

3. one controlled retry variable if diagnosing a failed generation.

Hard Failures

• effect has no source, path, operation/contact, result, or endpoint;

• terms are stacked without jobs;

• light show appears before or instead of body action;

• particles or trails ignore depth, occlusion, or source motion;

• every beat is graded as a hero peak;

• effect color has no owner or contaminates the full palette;

• emissive energy produces no nearby light response;

• destruction emits the wrong material or starts before impact;

• a smear permanently mutates a character or weapon;

• density never falls after the peak;

• final wording exposes internal IDs, workflow notes, or generic claims such as “高级特效”.