ShortVideoDirector
一个以 Claude Code 为主体的插件，通过 5 个 AI 子代理协作，将故事创意转化为 AI 视频分镜提示词、资产参考图片和视频片段。Codex 与 OpenCode 支持以兼容层形式提供。
本仓库只维护一套事实上的 skill 内容层：skills/。Claude Code 直接加载这套源 skills；Codex 通过 .codex/ 下生成的轻量适配层执行同一套 skill 内容；OpenCode 通过 .opencode/ 下的运行时插件加载（启动时把 skills 转换缓存到 ~/.cache/short-video-director/<hash>/，不污染源仓库）。
功能
- 将故事点子/原文/概述转化为短视频分镜提示词（1-2 分钟/集）
- 自动生成人物、物品、场景、建筑的图像提示词
- 支持持续创作，保持人物、资产和声音在整个故事中的一致性
- 支持即梦CLI（Dreamina）自动生成资产参考图片，与分镜流程并行执行
- 支持即梦CLI（Dreamina）异步生成视频片段，分镜自动转化为 multimodal2video prompt，资产图片作为全能参考
- 视频生成定时任务（
/auto-video），自动查询状态、下载完成视频、重试因并行限制失败的任务
- 视频生成失败智能判断：LLM 分析 fail_reason，可重试的自动重试，需人工介入的交互修复
- 可配置图像模型（none / dreamina）和视频模型（none / dreamina），选择 dreamina 后可配置模型版本、比例、分辨率
- 可配置视频风格（2D动漫/3D动漫/3D写实/2D手绘/自定义）
- 首次运行交互式引导配置，支持自定义模型和风格输入
- 支持 Director 自动生成剧情选项供选择，不满意可重新生成或提供偏好
- 用户自行输入时 Director 生成结构化确认说明（default mode 下等待用户确认；full-auto mode 下自动确认）
- 支持角色换装（独立造型变体文件，需对剧情有实质影响的视觉区分）
- 人物基础资产基于角色气质和世界观设定，剥离职业/场景特定装束
- 分镜采用时间线连贯叙事格式，画面动作、对白、音效自然融合
- 每集开场强力钩子 + 结尾悬念钩子，最大化观众留存
- 高角色台词密度（对白、自白、旁白、角色声音反应），丰富短视频内容表现力
- 支持角色旁白快速补充背景知识（人物介绍、世界观等），加速观众理解
- 丰富的环境音效设计，2 秒内必须有声音（台词或音效）
- 角色声音特征一致性保障
- 版权规避：不使用现实中的明星/公众人物名字、真实地名、商标名
- 资产创建完成后再生成分镜，确保分镜师可引用完整资产信息
- 剧情弧线（arc）支持每集剧情规划，outline 严格遵循 arc 分集规划
- 支持 full-auto 批量生成脚本（
scripts/run-batch.ps1）
五个子代理
| 子代理 | 角色 | 职责 |
|---|
| Director | 总导演 | 全局统筹、生成剧情大纲、审核 Writer/Scriptwriter 和 Storyboarder 输出 |
| Writer | 网络小说作家 | 根据剧情大纲生成小说原文，擅长悬念设置和人物描写 |
| Scriptwriter | 短视频编剧 | 将大纲转化为剧本，擅长在极短篇幅内构建完整故事 |
| Storyboarder | 分镜师 | 负责资产清单和分镜提示词生成 |
| Creator | 创意总监 | 识别并视觉化人物和资产，生成图像提示词和声音特征描述 |
安装
# 通过 --plugin-dir 加载（每次启动时指定）
claude --plugin-dir /path/to/ShortVideoDirector
For OpenCode users
本仓库同时支持 OpenCode（.opencode/ 兼容层）。在 ~/.config/opencode/opencode.json 添加：
{
"$schema": "https://opencode.ai/config.json",
"plugin": [
"short-video-director@git+https://github.com/wddxh/ShortVideoDirector.git"
]
}
启动 OC 即自动注册 5 个子代理与 44 个 skills。完整安装/升级/troubleshooting 说明见 .opencode/README.md。
Codex
Codex 支持是对 Claude Code plugin 的兼容层，由 .codex-plugin/plugin.json 提供。
Claude Code 是主要运行目标，直接从 skills/ 加载源 skills。Codex 从 .codex/skills/ 加载生成的轻量适配层；每个适配层会应用 .codex/tool-mapping.md，并执行原始源 skill。
只维护 skills/ 这一套事实上的 skill 内容层。修改 skill 行为时只改 skills/；修改源 skill 头部元数据或 Codex 映射后，重新生成 Codex 适配层：
python3 .codex/build-codex-skills.py
模型要求
本插件按任务复杂度分配模型：
- Opus（编排、Director 审核）：15 个 skill
- Sonnet（内容生成、机械执行）：24 个 skill
前置条件：账号需同时有 Opus 和 Sonnet 访问权限。
只有 Sonnet 配额时，可全局降级：
CLAUDE_CODE_SUBAGENT_MODEL=sonnet claude ...
env var 优先级最高，会覆盖所有 frontmatter 的 model，整个 session 全跑 Sonnet（编排稳定性可能受影响）。
使用
# 开始新故事（提供输入）
/series-video 一个穿越到异世界的少年，发现自己拥有操控时间的能力...
# 开始新故事（从文件读取）
/series-video story-idea.txt
# 开始新故事（指定总集数 + 故事材料，自动生成剧情弧线）
/series-video 30 一个穿越到异世界的少年...
/series-video 30 story-idea.txt
# 开始新故事（仅指定总集数，交互式选择剧情方向）
/series-video 30
# 开始新故事（交互式，可让 Director 生成主题选项）
/series-video
# 续写故事（自动检测已有 story/ 目录）
/series-video 主角发现了隐藏在古城下的秘密通道...
# 编辑配置
/series-video config
# 单集短视频（独立完整故事）
/short-video 一个外卖小哥送错餐发现客户是自己的前女友
/short-video story-idea.txt
/short-video
/short-video config
# 编辑系列视频已有内容
/series-edit-story ep01大纲的集尾钩子改成更有悬念的
/series-edit-story ep02分镜镜头3的台词太少，增加内心独白
/series-edit-story ep03主角的外貌描述改成短发
/series-edit-story 在ep01的资产清单中增加一个新角色"老王"
/series-edit-story 重新生成张三的参考图片
/series-edit-story 张三的头发改成红色，重新生成图片
# 编辑单集短视频已有内容
/short-edit-story 大纲的结局改成开放式结局
/short-edit-story 剧本场景2的台词太少，增加内心独白
/short-edit-story 主角的外貌描述改成短发
/short-edit-story 重新生成张三和李四的参考图片
# 修复系列视频中断的生成
/series-repair-story ep03
/series-repair-story # 自动检测最新一集
# 修复单集短视频中断的生成
/short-repair-story
# 提交视频生成任务（异步，提交后自动启动定时监控）
/generate-video ep01 # 整集所有镜头
/generate-video ep01 镜头3 镜头5 # 指定镜头
# 查询视频生成结果（交互模式，可处理失败任务）
/check-video ep01
/check-video ep01 --auto # 自动模式，只重试可重试的失败
/check-video all --auto # 检查所有集
# 启动/管理视频生成定时监控
/auto-video ep01 # 监控 ep01，默认每 20 分钟检查
/auto-video ep01 300 # 自定义间隔（秒）
/auto-video all # 监控所有集
生成的目录结构
