muapi-cinema-director

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

🎬 AI Cinema Director Skill

🎬 AI电影导演Skill

A specialized skill for AI Agents to direct high-fidelity cinematic video. The Cinema Director skill translates high-level creative intent into technical cinematographic directives for state-of-the-art video models (Veo3, Kling, Luma).

一款专为AI Agents打造的高保真电影级视频执导Skill。 该电影导演Skill可将高层级的创意意图转化为适用于前沿视频模型（Veo3、Kling、Luma）的专业电影技术指令。

Core Competencies

核心能力

Shot Composition Analysis: Mapping emotional beats to appropriate framing (e.g., Extreme Close-Up for intimacy, Wide Shot for isolation).
Camera Movement Orchestration: Directing complex physical movements (Dolly, Truck, Crane) and lens-based effects (Rack Focus, Dolly Zoom).
Lighting & Atmosphere Design: Specifying temporal and stylistic lighting (Golden Hour, Chiaroscuro, Volumetric God Rays).
Technical Parameter Optimization: Automatically selecting optimal frame rates, aspect ratios, and model-specific biases.

镜头构图分析：将情感节奏映射至合适的取景方式（例如，特写镜头用于表现亲密感，广角镜头用于表现孤独感）。
镜头运动编排：指导复杂的物理运动（推拉、横移、升降）及镜头特效（跟焦、推拉变焦）。
灯光与氛围设计：指定时间性与风格化的灯光（黄金时刻、明暗对比、体积光神射线）。
技术参数优化：自动选择最优帧率、宽高比及模型特定偏好设置。

🏗️ Technical Specification

🏗️ 技术规格

1. Intent Mapping Table

1. 意图映射表

Creative Intent	Framing	Movement	Lighting
Heroic Reveal	Low Angle / Wide	Crane Up / Orbit	Rim Lighting / High Contrast
Tense/Uneasy	Dutch Angle	Handheld Shake	Low Key / Harsh Shadows
Introspective	Close-Up	Slow Push In	Soft Rembrandt / Window Light
Majestic/Epic	Extreme Wide	Drone Flyover	Golden Hour / Volumetric
Melancholic	Profile / Medium	Slow Pull Out	Blue Hour / Desaturated

创意意图	取景方式	镜头运动	灯光
英雄式登场	低角度/广角	升降镜头上移/环绕	轮廓光/高对比度
紧张/不安	倾斜镜头	手持抖动	低键照明/硬阴影
内省	特写	缓慢推进	柔和伦勃朗光/窗户光
宏伟/史诗感	超广角	无人机飞越	黄金时刻/体积光
忧郁	侧面/中景	缓慢拉远	蓝色时刻/低饱和度

2. Physical Camera Movements

2. 物理镜头运动

```
Dolly In/Out
```
: Physical camera movement on a track toward/away from the subject.
```
Truck Left/Right
```
: Lateral physical movement.
```
Crane/Jib
```
: Sweeping vertical movement from a height.
```
Orbit
```
: Circular movement around a center point.
```
Pedestal
```
: Vertical elevation change (without tilting).

```
Dolly In/Out
```
：镜头在轨道上朝向/远离主体的物理移动。
```
Truck Left/Right
```
：横向物理移动。
```
Crane/Jib
```
：从高处进行的大幅垂直移动。
```
Orbit
```
：围绕中心点的环形移动。
```
Pedestal
```
：垂直升降（不伴随倾斜）。

3. Lens & Optical Controls

3. 镜头与光学控制

```
Shallow DOF
```
: Background blur (Bokeh).
```
Anamorphic
```
: Horizontal flares and wide-screen cinematic feel.
```
Rack Focus
```
: Shifting focus between planes within the shot.

```
Shallow DOF
```
：背景虚化（散景）。
```
Anamorphic
```
：横向镜头眩光及宽屏电影质感。
```
Rack Focus
```
：在镜头内不同平面间切换焦点。

🧠 Prompt Optimization Protocol (Agent Instruction)

🧠 提示词优化协议（Agent指令）

Before calling the script, the Agent MUST expand the user's raw prompt using these Director's Rules:

TECHNICAL INFUSION: Transform "cool action" into a technical shot.

Formula:

[Shot Type] + [Subject/Action] + [Environment] + [Lighting] + [Camera Movement] + [Lens Effect]

MOTION DYNAMICS: Use cinematic verbs: Dolly In (intimacy), Crane Up (majestic), Orbit (heroic), Truck (parallel motion).
LIGHTING RECIPES: Apply specific illumination: Volumetric God Rays, Teal-and-Orange Grade, Cyberpunk Rim Lighting, Rembrandt Portrait Lighting.
PHYSICS LOGIC: Describe light relationships (e.g., "Neon reflections shimmering on rain-slicked asphalt") to trigger model reasoning.

在调用脚本前，Agent必须使用以下导演规则扩展用户的原始提示词：

技术注入：将“酷炫动作”转化为专业镜头语言。

公式：

[镜头类型] + [主体/动作] + [环境] + [灯光] + [镜头运动] + [镜头特效]

运动动态：使用电影化动词：Dolly In（亲密感）、Crane Up（宏伟感）、Orbit（英雄感）、Truck（平行运动）。
灯光方案：应用特定照明效果：Volumetric God Rays、青橙色调分级、赛博朋克轮廓光、伦勃朗肖像光。
物理逻辑：描述光线关系（例如，“霓虹反光在雨后光滑的柏油路面上闪烁”）以触发模型推理。

🚀 Protocol: Using the Cinema Director

🚀 使用电影导演Skill的流程

Step 1: Define the Creative Brief

步骤1：定义创意简报

Provide the agent with a subject and a "Director's Intent."

向Agent提供主体及“导演意图”。

Step 2: Invoke the Script

步骤2：调用脚本

The

generate-film.sh

script accepts a

--brief

which it expands using its internal knowledge of cinematography.

bash

undefined

generate-film.sh

脚本接受

--brief

参数，会利用其内置的电影知识扩展该参数内容。

bash

undefined

Directing a scene

执导一个场景

bash scripts/generate-film.sh --subject "A lone samurai in a blizzard" --intent "epic reveal" --model "kling-master"

undefined

bash scripts/generate-film.sh --subject "A lone samurai in a blizzard" --intent "epic reveal" --model "kling-master"

undefined

Step 3: Handle the Async Response

步骤3：处理异步响应

Video generation is asynchronous. Use the returned

request_id

to poll for completion via

core/platform/check-result.sh

视频生成为异步操作。使用返回的

request_id

通过

core/platform/check-result.sh

轮询生成完成状态。

⚠️ Constraints & Guardrails

⚠️ 约束与防护措施

Temporal Consistency: Avoid complex subject transformations in a single shot (e.g., "man turns into a bird").
Movement Collisions: Do not combine contradictory movements (e.g., "Dolly In" and "Dolly Out" simultaneously).
Physical Realism: Prefer movements possible with real-world equipment for a more professional "film" look.
Model Bias:
- ```
Veo3
```
  : Best for slow, high-quality aesthetic shots.
- ```
Kling
```
  : Best for complex character motion and physics.
- ```
Luma
```
  : Best for fast-paced, high-action cinematic sequences.

时间一致性：避免在单个镜头中进行复杂的主体变换（例如，“人变成鸟”）。
运动冲突：不要组合矛盾的运动方式（例如，同时“推镜头”和“拉镜头”）。
物理真实性：优先选择现实拍摄设备可实现的运动方式，以获得更专业的“电影感”画面。
模型偏好：
- ```
Veo3
```
  ：最适合慢节奏、高品质的美学镜头。
- ```
Kling
```
  ：最适合复杂的角色运动及物理效果。
- ```
Luma
```
  ：最适合快节奏、高动作的电影级序列。

⚙️ Implementation Details

⚙️ 实现细节

This skill acts as an "Expert Translator" for the

core/media/generate-video.sh

primitive. It maintains a dictionary of cinematic styles and injects technical directives into the prompt before execution.

该Skill作为

core/media/generate-video.sh

基础功能的“专业翻译器”。它维护着一个电影风格字典，并在执行前将技术指令注入提示词中。