seedance-2-5-video-director README

The project's README from github.com/liyue-aigc/seedance-2-5-video-director. As one markdown file: README.md.

Seedance 2.5 Video Director

面向 Dreamina／即梦 Seedance 2.5 的视频导演 Skill。它将文本创意、人物参考图、视频、音频、分镜或旧提示词整理成可执行的视频脚本、导演方案、诊断结果和复制即用的提示词。

非字节跳动、Dreamina 或即梦官方项目。本仓库不会调用付费生成接口，不会自动消耗积分。

功能

安装

推荐：一行安装

已安装 Node.js 的用户，在 Windows、macOS 或 Linux 终端执行：

npx skills add liyue-aigc/seedance-2-5-video-director -g -y

这条命令会从 GitHub 获取 Skill，并安装到当前用户的 Agent Skills 目录；-g 表示全局安装，-y 表示跳过交互确认。它使用 npm 附带的 npx 启动安装器，但本仓库本身不是需要加入项目依赖的 npm 软件包，因此不使用 npm install。

如果电脑上没有 Node.js，也可以直接在 Codex 中发送：

请使用 $skill-installer，从 GitHub 安装 liyue-aigc/seedance-2-5-video-director。

手动安装（备用）

Windows PowerShell

$skillRoot = Join-Path $env:USERPROFILE '.codex\skills'
New-Item -ItemType Directory -Force -Path $skillRoot | Out-Null
git clone https://github.com/liyue-aigc/seedance-2-5-video-director.git (Join-Path $skillRoot 'seedance-2-5-video-director')

macOS / Linux

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/liyue-aigc/seedance-2-5-video-director.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/seedance-2-5-video-director"

安装完成后重新打开Codex会话，并在提示词中调用：

使用 $seedance-2-5-video-director，把我的视频创意整理成可复制的 Seedance 2.5 提示词。

安装器明确提示刚完成安装时，Skill会展示一次学习指导；普通新对话会直接处理任务，不会重复教程。需要时可主动发送“显示 $seedance-2-5-video-director 使用教程”。

更新

通过 npx skills 安装的用户：

npx skills update seedance-2-5-video-director -g -y

手动克隆的用户：

git -C "${CODEX_HOME:-$HOME/.codex}/skills/seedance-2-5-video-director" pull

Windows默认安装路径更新：

git -C (Join-Path $env:USERPROFILE '.codex\skills\seedance-2-5-video-director') pull

快速使用

使用 $seedance-2-5-video-director。

任务：生成20秒、16:9的水上竞技综艺片段。
素材：@Image 1 是挑战者完整人物参考，保持原服装；不要继承图片背景。
故事：登场 → 滚筒失衡但通过 → 摆锤窄桥 → 成功冲线。
声音：普通话解说、现场欢呼、机关声和紧张BGM，无字幕。
输出：完整导演方案和最终提示词。

只要提示词

使用 $seedance-2-5-video-director。只要最终提示词，不要解释。
生成15秒、9:16的街头追逐戏：一名成年女性被三人追赶，写实手持动作片风格，人物与空间方向稳定。

诊断现有提示词

使用 $seedance-2-5-video-director。只诊断，不重写。
检查下面提示词的时间、运镜、人物、物理和声音是否互相冲突：<粘贴提示词>

更多模式与结构见 SKILL.md、提示词蓝图 和 首次使用引导。

人物参考原则

普通的“人物参考图”默认代表完整可见人物，而不是只参考脸：

目录

seedance-2-5-video-director/
├── SKILL.md
├── README.md
├── LICENSE
├── NOTICE.md
├── agents/
│   └── openai.yaml
├── references/
│   ├── capabilities-and-limits.md
│   ├── first-use-onboarding.md
│   ├── multimodal-patterns.md
│   ├── official-examples.md
│   ├── prompt-blueprints.md
│   └── realistic-direction-patterns.md
├── scripts/
│   └── validate_skill.py
├── tests/
│   └── cases.json
└── .github/workflows/
    └── validate.yml

测试

本地运行：

python scripts/validate_skill.py

验证器会检查：

GitHub Actions会在每次push和pull request时运行同一验证器。

tests/cases.json 是行为契约测试集。它不会调用视频生成服务，而是记录输入场景和预期输出约束，适合人工回归或交给独立代理做前向测试。

能力边界

开源与第三方说明

代码与原创Skill内容采用 MIT License。平台名称、商标和第三方文档归各自权利人所有。能力摘要和示例来源说明见 NOTICE.md。

seedance-2-5-video-director (liyue-aigc/seedance-2-5-video-director)

Searching Database…

706 ·GitHub
Seedance-2-5-video-director
Что это?Это Skill «Seedance 2.5 Video Director» для Codex, созданный для видеоплатформы Dreamina (即梦) Seedance 2.5. Он превращает текстовые идеи, референсные изображения персонажей, видео, аудио, сториборды или старые промпты в готовые к использованию видеосценарии, режиссёрские планы, диагностику и промпты для копирования и вставки.
Он сам генерирует видео?Нет, это Skill генерации промптов и сценариев, а не видеогенератор — он никогда не вызывает платные API генерации и не тратит кредиты Dreamina. Он лишь создаёт тексты планов, промпты и диагностику, которые вы сами вставляете в Dreamina.
Как установить этот Skill?Если у вас есть Node.js, запустите однострочный npx-установщик из README в терминале Windows, macOS или Linux: он скачает Skill с GitHub и установит его в вашу папку Agent Skills, с -g для глобальной установки. Также предусмотрена ручная установка через PowerShell (Windows) или shell (macOS/Linux).
Нужен ли Node.js для установки?Node.js нужен для рекомендуемого npx-установщика, но если его нет, можно запустить установку напрямую, отправив сообщение внутри сессии Codex.
Он гарантирует стабильные результаты видео?Нет — базовая генеративная модель случайна, поэтому промпты Skill могут лишь снижать дрейф персонажа, физические ошибки и конфликты камеры, но не гарантируют один и тот же результат каждый раз. Он и сам никогда не отправляет задачи на генерацию, так что финальный промпт вы всё равно запускаете в Dreamina вручную.
Какие правила для референсов персонажей он соблюдает?По умолчанию референсное изображение представляет всего видимого человека: сохраняются личность, черты лица, тон кожи, причёска, рост, телосложение, видимая одежда и аксессуары, а фон, поза, композиция и освещение из референса не наследуются, если вы не запросили референс только лица.
Какие длины видео и режимы монтажа он поддерживает?Он покрывает обычные клипы 4-30 с с точным 30-секундным таймлайном, длинное видео 30-180 с, продолжение существующих клипов до/после, Smart Edit с правкой размеченной области или загруженного видео, бесшовные переходы между двумя клипами и мультипанельную раскадровочную анимацию.
Как проверяется качество Skill?Локальный валидатор, который GitHub Actions тоже запускает на каждый push и pull request, проверяет front matter Skill и обязательные файлы, триггеры инструкций по установке, имя вызова в agents/openai.yaml и поведенческие тест-кейсы в tests/cases.json.
Это официальный продукт Dreamina или ByteDance?Нет, в README прямо сказано, что это не официальный проект ByteDance, Dreamina или 即梦; это сторонний Skill, который лишь создаёт тексты планов и промпты для использования на этих платформах.
What are similar projects?h3-storyboard-skill, seedance2-skill, short-drama-production, film-studio-skills, manju-laoli-skill, awesome-seedance, lanshu-create-ai-presenter-video, hypit
Which topics is it in?seedance, storyboard, ai-video, video-editing, codex-skill, github-actions, video-generation, prompt-engineering, audio, testing, generative-ai, agent-skills
Creator
liyue-aigc
Size
<0.1 MB
Stars
706
Updated
CommitAug 26Releasev1.0.0Aug 18
Age
2mo
Commits · 90 Days