这是什么
《东方仙侠运镜导演》（xianxia-cinematic-video-director）是一个面向 Codex / Agent Skills 体系的东方仙侠电影视频导演 Skill。它由开发者 liyue-aigc 发布，仓库位于 GitHub，当前已获得 239 颗星、34 次 fork，公开 issue 为 0。该 Skill 的核心任务，是把场景构想、图片提示词、关键帧或参考视频，扩展为具有故事推进、空间连续性、明确运镜和稳定首尾状态的多镜头视频方案。
与常见的“生成一组漂亮仙侠画面”不同，这个 Skill 关注的是时间、镜头功能、运动路径与跨镜头一致性。它不会输出彼此无关的唯美镜头，而是让每个镜头都承担叙事任务，并保证镜头之间的空间关系、人物服装、光线方向等要素不漂移。
适合谁
适合以下创作者：
- 想用 AI 制作东方仙侠风格短视频、但不懂运镜语言的内容创作者；
- 已有仙侠场景概念或参考视频，希望得到专业分镜和逐镜头提示词的视频创作者；
- 使用 Codex 或兼容 Agent Skills 的工具，希望把自然语言描述转化为可执行视频方案的创作者；
- 需要诊断参考视频中运镜混乱、连续性漂移等问题的进阶用户。
能做什么
该 Skill 提供以下核心能力：
- 生成一句话故事脊柱、连续性锁定卡、分镜总表与逐镜头视频提示词；
- 为每个镜头指定初始画面、人物动作、有目的的主运镜或分阶段运镜、速度曲线、环境运动与稳定结束状态；
- 根据总时长自动规划镜头数量和节奏，并确保各镜头时长之和准确；
- 设计推近、拉远揭示、横向视差、升降、前领/后跟/侧跟、航拍俯冲、克制环绕、受控震动、Dolly Zoom 与固定机位等运镜；
- 根据剧情在静止、缓慢、匀速、加速、快速、急停和先快后稳之间自适应变化，避免全程慢推；
- 锁定人物、服装、建筑轮廓、地理关系、光线方向、风向、天气和色彩，减少跨镜头漂移；
- 诊断参考视频中的剪辑过快、镜头重复、运动混乱、建筑变形、人物复制、颜色漂移和空间断裂；
- 支持首帧/尾帧规划、图生视频提示词，以及在明确授权后的直接视频生成工作流；
- 支持 16:9、21:9、4:3、3:2、4:5、9:16 等画幅比例。
导演原则
该 Skill 内置了一套导演原则，帮助生成真正有叙事逻辑的运镜方案：
- 每个视频先明确一条故事脊柱，例如“等待 -> 察觉 -> 相遇 -> 同行 -> 仰望 -> 抵达”；
- 一个镜头只承担一个主要功能：揭示世界、建立人物尺度、说明行进路径、升级建筑或自然尺度、完成情绪节点或展示最终目的地；
- 一个镜头使用一个主运动或有序阶段，避免同时堆叠快速平移、推拉、环绕、升降、旋转和变焦；
- 建筑保持稳定，运动主要来自摄像机、人物、衣料、云、水、树叶、鸟群与光线；
- 每条逐镜头提示词都定义稳定的初始构图、清晰人物动作链、有方向速度和幅度的主运镜、一至两层克制环境运动，以及稳定的结束画面及新增信息。
使用前准备
使用前需要准备：
- 一台可以运行 Codex 的电脑（Windows / macOS / Linux）；
- 本机已安装 Codex 或兼容 Agent Skills 的编程环境；
- 基本的命令行操作能力（执行 git clone、复制目录等）；
- 无需额外 API Key，但使用 Codex 本身所需的登录或鉴权环境需要提前配置好。
安装方法
根据 README 的说明，安装方式如下。
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/
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 列表后即可调用。
使用示例
安装完成后，在 Codex 中直接以自然语言描述场景即可。README 提供了一个最小调用示例：
使用 $xianxia-cinematic-video-director。
场景：雨夜竹林石阶，尽头连接悬空峡谷。
主体：一名虚构成年剑修，月白长衣，右手持剑。
变化：潜行时察觉追兵，沿石阶加速逃亡，跃出崖口后御剑脱身。
感觉：先压抑，随后高速紧张，结尾短暂释放。
时长与画幅：15秒，16:9。
输出：标准完整格式；不要全程慢推，不要随机旋转。
首次调用时，Skill 会先展示一份简短使用说明和参考示例，再直接继续生成这次请求的运镜方案。
你也可以使用更完整的调用，指定总时长、画幅比例、镜头数量、节奏、核心故事、起点路径终点、人物、空间尺度、光线和镜头偏好等参数。
风险与注意事项
- 本仓库暂未附带开源许可证。仓库公开可见不等于授予复制、修改或再分发许可，使用前请自行评估。
- 该 Skill 不绑定特定视频模型；只有用户明确指定平台时，才应读取该平台的当前能力与参数限制。
- 分镜或参数请求不等于授权直接生成可能产生费用的视频。只有用户明确要求生成/直接输出时，才应调用生成能力。
- 为保证稳定性，优先使用少而清晰的动作和运镜，不让建筑变形来制造运动。
- 参考图片应明确标记为人物身份锚点、服装锚点、地标锚点、风格参考、严格首帧、严格尾帧或运动参考。
- 首次安装或当前会话第一次调用时，Skill 会强制展示使用方法、最小输入模板和参考示例，这是设计行为，不是故障。