东方仙侠运镜导演

xianxia-cinematic-video-director 是一个面向 Codex / Agent Skills 体系的东方仙侠电影视频导演 Skill。它将场景构想、图片提示词、关键帧或参考视频，扩展为具有故事推进、空间连续性、明确运镜和稳定首尾状态的多镜头视频方案。

它关注的是时间、镜头功能、运动路径与跨镜头一致性，不会输出一组彼此无关的“漂亮仙侠画面”。首次安装或当前会话第一次调用时，会先强制展示使用方法、最小输入模板和参考示例，然后继续处理用户原请求。

Cinematic Eastern xianxia video direction for story spines, shot lists, camera choreography, continuity locks, keyframes and per-shot generation prompts.

核心能力

• 生成一句话故事脊柱、连续性锁定卡、分镜总表与逐镜头视频提示词。
• 为每个镜头指定初始画面、人物动作、有目的的主运镜或分阶段运镜、速度曲线、环境运动与稳定结束状态。
• 根据总时长自动规划镜头数量和节奏，并确保各镜头时长之和准确。
• 设计推近、拉远揭示、横向视差、升降、前领/后跟/侧跟、航拍俯冲、克制环绕、受控震动、Dolly Zoom 与固定机位等运镜。
• 根据剧情在静止、缓慢、匀速、加速、快速、急停和先快后稳之间自适应变化，避免全程慢推。
• 首次安装或当前会话首次调用时，强制输出使用方法、最小输入模板和参考示例。
• 对缺少运镜、运动冲突、物理上不可实现或无关输入给出明确反馈和修正版。
• 锁定人物、服装、建筑轮廓、地理关系、光线方向、风向、天气和色彩，减少跨镜头漂移。
• 诊断参考视频中的剪辑过快、镜头重复、运动混乱、建筑变形、人物复制、颜色漂移和空间断裂。
• 支持首帧/尾帧规划、图生视频提示词，以及在明确授权后的直接视频生成工作流。
• 支持 16:9、21:9、4:3、3:2、4:5、9:16。

默认参数

未明确指定时使用：

• 画幅比例：16:9
• 总时长：30秒
• 镜头数量：6
• 节奏：叙事自适应
• 空间尺度强度：史诗级
• 饱和策略：选择性高饱和

默认30秒结构会用较少但可读的镜头逐步完成世界揭示、人物定位、空间行进、尺度升级、情绪停顿和最终抵达，而不是快速蒙太奇。

导演原则

一条故事脊柱

每个视频先明确从开始到结束发生了什么，例如：

等待 -> 察觉 -> 相遇 -> 同行 -> 仰望 -> 抵达

一个镜头只承担一个主要功能

• 揭示世界
• 建立人物尺度
• 说明行进路径
• 升级建筑或自然尺度
• 完成情绪节点
• 展示最终目的地

一个镜头使用一个主运动或有序阶段

简单镜头默认一个主运动；需要复合运镜时，写成“进入 → 主运动 → 落稳”的时间顺序。避免同时堆叠快速平移、推拉、环绕、升降、旋转和变焦。建筑保持稳定，运动主要来自摄像机、人物、衣料、云、水、树叶、鸟群与光线。

首尾都必须稳定

每条逐镜头提示词都定义：

1. 稳定的初始构图
2. 一个清晰人物动作链
3. 一个有方向、速度和幅度的主运镜
4. 一至两层克制环境运动
5. 稳定的结束画面及新增信息

安装

Windows PowerShell

git clone https://github.com/liyue-aigc/xianxia-cinematic-video-director.git
Copy-Item -Recurse -Force `
  .\xianxia-cinematic-video-director\xianxia-cinematic-video-director `
  "$env:USERPROFILE\.codex\skills\xianxia-cinematic-video-director"

如果目标目录已经存在，请先自行备份。重新启动 Codex 或刷新 Skill 列表后即可调用。

macOS / Linux

git clone https://github.com/liyue-aigc/xianxia-cinematic-video-director.git
mkdir -p ~/.codex/skills
cp -R ./xianxia-cinematic-video-director/xianxia-cinematic-video-director ~/.codex/skills/

最小调用示例

使用 $xianxia-cinematic-video-director。

场景：雨夜竹林石阶，尽头连接悬空峡谷。
主体：一名虚构成年剑修，月白长衣，右手持剑。
变化：潜行时察觉追兵，沿石阶加速逃亡，跃出崖口后御剑脱身。
感觉：先压抑，随后高速紧张，结尾短暂释放。
时长与画幅：15秒，16:9。
输出：标准完整格式；不要全程慢推，不要随机旋转。

首次调用时，Skill 会先展示一份简短使用说明和参考示例，再直接继续生成这次请求的运镜方案。

完整调用示例

使用 $xianxia-cinematic-video-director。

总时长：30秒
画幅比例：21:9
镜头数量：6
节奏：叙事自适应
核心故事：等待 -> 发现 -> 同行 -> 抵达
起点：崖畔古松下的开放石台
路径：横跨云海的悬空长桥
终点：压出画面顶部的巨型天门
人物：两名虚构成年旅人，月白与孔雀青结构化仙衣，背影为主
空间尺度强度：超宏大
饱和策略：选择性高饱和
光线：清晨右侧低角度侧逆光
镜头偏好：遮挡横移揭示、稳定跟随、低机位仰拍、最终远景减速停留

输出参数锁定、故事脊柱、连续性锁定卡、分镜总表、逐镜头提示词、全局负面约束和生成顺序。

标准输出

1. 首次使用说明（仅首次安装或当前会话首次调用）
2. 输入理解与反馈（需要时）
3. 参数锁定
4. 一句话故事脊柱与动作能量曲线
5. 连续性锁定卡
6. 分镜总表
7. 逐镜头提示词
8. 全局负面约束
9. 自检结果与推荐生成顺序

分镜总表会记录镜头编号、时间范围、时长、功能、景别/焦段、主运镜和结束状态。逐镜头提示词会重复必要的连续性约束，避免只依赖一段容易被模型忽略的全局说明。

连续性锁定内容

• 人物数量、成年身份、身形、发型轮廓、服装颜色和随身物品
• 主建筑轮廓、屋檐层数、门洞形状、桥梁方向与可裁切部分
• 起点、路径、终点、地平线和人物行进方向
• 太阳或月亮方向、阴影方向、风向、云层移动和天气变化
• 主色、近中性色、最高纯度强调色和材质体系
• 湿润、破损、开门、持物和人物位置等跨镜头状态

目录结构

xianxia-cinematic-video-director/
├── README.md
└── xianxia-cinematic-video-director/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    └── references/
        ├── camera-help-and-examples.md
        ├── continuity-and-motion.md
        ├── first-use-onboarding.md
        ├── input-routing-and-feedback.md
        ├── prompt-patterns.md
        ├── shot-grammar.md
        └── visual-baseline.md

与视觉导演配合

视频的单张视觉设定、建筑关键帧或严格首帧可以配合 xianxia-visual-director 生成。本 Skill 仍可独立工作，不强制依赖图片 Skill。

两套 Skill 同时使用时，建议按以下顺序：

1. 使用视觉导演锁定世界、建筑、人物、服装、画幅、色彩与光线。
2. 选择一至数张图片作为人物、地标、首帧或风格锚点，并明确每张图的角色。
3. 使用运镜导演建立故事脊柱、空间地图和连续性锁定卡。
4. 生成分镜与逐镜头视频提示词。
5. 先验证关键镜头，再按故事顺序生成其余镜头。

注意事项

• Skill 不绑定特定视频模型；只有用户明确指定平台时，才应读取该平台的当前能力与参数限制。
• 分镜或参数请求不等于授权直接生成可能产生费用的视频。
• 为保证稳定性，优先使用少而清晰的动作和运镜，不让建筑变形来制造运动。
• 参考图片应明确标记为人物身份锚点、服装锚点、地标锚点、风格参考、严格首帧、严格尾帧或运动参考。

License

本仓库暂未附带开源许可证。仓库公开可见不等于授予复制、修改或再分发许可。