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
这是什么？这是一个面向 Codex 的“Seedance 2.5 Video Director”Skill，为 Dreamina（即梦）Seedance 2.5 视频平台打造。它把文字创意、角色参考图、视频、音频、分镜或旧提示词转化成可直接使用的视频脚本、导演方案、诊断分析和可复制粘贴的提示词。
它本身是视频生成器吗？不是，它是一个提示词和脚本生成 Skill，不是视频生成器——它从不调用付费生成 API，也不消耗 Dreamina 积分。它只生成规划文本、提示词和诊断分析，由你自己粘贴进 Dreamina。
这个 Skill 怎么安装？如果你有 Node.js，在 Windows、macOS 或 Linux 终端中运行 README 展示的单行 npx 安装命令：它会从 GitHub 拉取该 Skill 并安装到你的 Agent Skills 目录，加 -g 表示全局安装。另外也提供手动安装方式，分别是 PowerShell（Windows）和 shell（macOS/Linux）。
安装它需要 Node.js 吗？推荐的 npx 安装方式需要 Node.js，但如果你没有，也可以直接在 Codex 会话里发送一条消息来触发安装。
它能保证视频结果稳定一致吗？不能——底层生成模型具有随机性，该 Skill 的提示词只能减少角色漂移、物理错误和镜头冲突，无法保证每次结果完全相同。它也从不自己提交生成任务，最终提示词仍要你在 Dreamina 中手动运行。
它遵循什么角色参考规则？默认情况下，参考图代表整个人物可见形象：身份、五官、肤色、发型、身高、体型、可见的服装和配饰都会保留，而参考图中的背景、姿势、构图和光照不会被继承，除非你要求仅作面部参考。
它支持哪些视频时长和编辑模式？它覆盖 4-30 秒的普通片段（精确的 30 秒时间线）、30-180 秒的长视频、现有片段的前/后续接、支持标记区域或上传视频编辑的 Smart Edit、两个片段之间的无缝转场，以及多格分镜动画。
这个 Skill 的质量如何检查？一个本地校验器会检查 Skill 的 front matter 和必需文件、安装引导触发条件、agents/openai.yaml 中的调用名称，以及 tests/cases.json 里的行为测试用例；GitHub Actions 也在每次推送和拉取请求时运行它。
这是 Dreamina 或字节跳动的官方产品吗？不是，README 明确声明它不是字节跳动、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