| name | short-video |
| description | 将故事创意转化为单集短视频的分镜提示词和资产图像提示词。输入故事点子或概述,输出完整的剧本、分镜和资产提示词。使用 /short-video 启动,/short-video config 编辑配置。 |
| user-invocable | true |
| allowed-tools | Read, Write, Edit, Glob, Bash, Agent, Skill |
| argument-hint | [故事材料|文件路径] |
| model | opus |
失败处理(核心规则)
sub-agent task 失败后,永远不要在主 session 自己接管本应由 sub-agent 做的工作。
正确做法:
- 分析失败原因(task return 值 / 错误信息)
- 如可修复:用修正后的参数重新派发同一 sub-agent
- 如不可修复:将失败原因和已尝试方案返回给用户,停止流程
错误做法:
- ❌ "sub-agent 失败了,我自己来写这个 novel.md"
- ❌ "task 报错了,我在主 session 直接调用 Write"
- ❌ "我 fallback 一下,自己生成 keyframes.json"
原因:主 session 缺少 sub-agent 的隔离上下文(专属 system prompt、skill 加载、permission 配置),自己接管会导致质量下降、跨步骤上下文污染、permission 错配等问题。即使 sub-agent 失败,工作所有权也必须留在 sub-agent 层。
总流程
调用 /short-video 后,按以下顺序执行:
- 配置加载 — 读取或创建 config.md(首次运行进入交互式引导)
- 输入解析 — 解析用户输入,确定故事来源(内联文本/文件/交互式/Director 生成)
- 创建目录 — 创建项目目录结构
- 执行工作流 — 按顺序执行剧本创作流水线
版权规避:所有生成内容(大纲、剧本、分镜、资产提示词等)不得出现现实中的明星或公众人物名字、真实地名、商标名或其他受版权/商标保护的名称,必要时使用虚构替代名称。
硬性约束:每次调用 /short-video 生成一个完整的单集短视频内容。 生成完毕后 skill 结束。
阶段 1: 配置加载
-
使用 Read 工具检查当前工作目录下是否存在 config.md
-
若已存在 → 读取并解析配置值
-
若不存在 → 进入交互式配置引导(仅首次运行),参考 config-template.md 模板进行交互式配置引导,逐个询问每项配置,每次只问一个,提供多选项供用户选择:
第 1 项:图像模型
- A) none(不生成图像)
- B) dreamina(即梦)
若用户选择 dreamina,继续询问以下 3 项配置:
第 1a 项:即梦 — 图像模型版本
- A) 4.0(免费,推荐)
- B) 5.0(每张约 3 积分,画质更高)
- C) 其他版本(3.0/3.1/4.1/4.5/4.6)
第 1b 项:即梦 — 图片比例
- A) 1:1(推荐)
- B) 3:4
- C) 16:9
- D) 其他
第 1c 项:即梦 — 图片分辨率
- A) 2k(推荐)
- B) 4k(仅 4.0+ 支持)
第 1d 项:视频模型
- A) none(不生成视频)
- B) dreamina(即梦)
若用户选择 dreamina,继续询问以下配置:
第 1e 项:即梦 — 视频模型版本
- A) seedance2.0fast(推荐,速度更快)
- B) seedance2.0(标准)
- C) seedance2.0fast_vip(VIP 加速)
- D) seedance2.0_vip(VIP 标准)
第 1f 项:即梦 — 视频比例
- A) 16:9(推荐,横屏)
- B) 9:16(竖屏,短视频常用)
- C) 1:1
- D) 其他
第 1g 项:即梦 — 视频分辨率
第 2 项:视频风格
- A) 2D动漫
- B) 3D动漫
- C) 3D写实
- D) 2D手绘
- E) 自定义输入
第 3 项:语言
- A) auto(跟随输入语言)
- B) zh(中文)
- C) en(英文)
- D) 自定义输入
第 4 项:每集分镜数(建议 10-20)
- A) 10
- B) 15(推荐)
- C) 20
- D) 自定义输入
第 5 项:每集时长目标
- A) 1-2分钟(推荐)
- B) 2-3分钟
- C) 自定义输入
第 6 项:单镜头时长范围
- A) 8-12秒
- B) 10-15秒(推荐)
- C) 12-18秒
- D) 自定义输入
第 7 项:单镜头资产上限
- A) 3
- B) 5(推荐)
- C) 7
- D) 自定义输入
所有配置收集完毕后,根据用户选择生成 config.md 写入项目根目录。告知用户可通过 /short-video config 随时修改。若图像模型为 dreamina,在 config.md 中额外写入 ## 图像生成配置 区域(包含即梦模型版本、图片比例、图片分辨率)。若图像模型为 none,不写此区域。若视频模型为 dreamina,在 config.md 中额外写入 ## 视频生成配置 区域(包含即梦视频模型版本、视频比例、视频分辨率)。若视频模型为 none,不写此区域。
-
解析以下配置值:
- 图像模型:none 或 dreamina
- 图像生成配置(仅图像模型非 none 时):即梦模型版本、图片比例、图片分辨率
- 视频模型:none 或 dreamina
- 视频生成配置(仅视频模型非 none 时):即梦视频模型版本、视频比例、视频分辨率
- 视频风格:视频的视觉风格(2D动漫/3D动漫/3D写实/2D手绘等)
- 语言:提示词输出语言
- 每集分镜数:每集包含的分镜数量
- 每集时长目标:每集目标时长
- 单镜头时长范围:每个分镜镜头的时长约束
- 单镜头资产上限:每个分镜镜头中引用资产的最大数量
阶段 2: 输入解析
解析 $ARGUMENTS,提取故事材料。
特殊命令: 若 $ARGUMENTS 为 config,使用 Read 打开 config.md 展示给用户,询问是否编辑。流程结束,不进入后续阶段。
故事材料识别:
$ARGUMENTS 为空 → 无故事材料
$ARGUMENTS 以 .txt 或 .md 结尾 → 使用 Read 读取该文件内容作为故事材料
- 其他 → 作为内联文本故事材料
阶段 3: 创建目录 + 输入分流
-
使用 Bash 创建目录结构:story/、story/episodes/ep01/、assets/characters/、assets/items/、assets/locations/、assets/buildings/
-
根据故事材料进行输入分流:
- 有故事材料 → 使用 Skill tool 调用
short-input-confirm skill,传递参数:"{story_input}",等待用户确认
- 无故事材料 → 使用 Skill tool 调用
short-plot-options skill,等待用户选择
阶段 4: 执行工作流
按以下顺序执行:
4.1 Director — 生成大纲:
使用 Skill tool 调用 short-outline skill,传递参数:"{用户确认的剧情方向文本}"
4.2 Scriptwriter — 写剧本:
使用 Skill tool 调用 scriptwriter-script skill,传递参数:ep01
4.3 Director — 审核剧本:
- 使用 Skill tool 调用
director-review-script skill,传递参数:ep01
- 若 review return
needs_revision M → 使用 Skill tool 调用 scriptwriter-fix-script skill,传递参数:ep01(最多 2 轮 fix;fix skill 自动读 .review-script.md 最后一轮意见)
4.4 Director — 规划关键帧 + 资产清单:
使用 Skill tool 调用 director-keyframes skill,传递参数:ep01
→ 写入 story/episodes/ep01/keyframes.json 并将本集资产清单追加到 ep01/outline.md
4.5 Director — 审核关键帧叙事:
- 使用 Skill tool 调用
director-review-keyframes-narrative skill,传递参数:ep01
- 若 review return
needs_revision M → 使用 Skill tool 调用 director-keyframes skill,传递参数:ep01 incremental(最多 2 轮 fix;fix skill 自动读 .review-keyframes-narrative.md 最后一轮意见)
4.6 Creator — 创建资产:
使用 Skill tool 调用 creator-create-assets skill,传递参数:ep01
4.7 Creator — 生成关键帧 .md 文件:
使用 Skill tool 调用 creator-keyframe-prompts skill,传递参数:ep01
→ 写入 assets/keyframes/ep01/{KF-id}.md
4.8 Creator — 批量出图(资产 + 关键帧):
若 config 中图像模型非 none:使用 Skill tool 调用 creator-generate-images skill,传递参数:ep01(自动扫描资产 .md 与关键帧 .md,统一出图)。
若 config 中图像模型为 none,跳过此步及 4.9。
4.9 Director — 审核关键帧画面:
- 使用 Skill tool 调用
director-review-keyframes-visual skill,传递参数:ep01
- 若 review return 以
needs_revision 开头 → 使用 Skill tool 调用 creator-fix-keyframe-image skill,传递参数:ep01(最多 2 轮 fix;fix skill 自动读 .review-keyframes-visual.md 最后一轮 dirty list + 意见)
4.10 Storyboarder — 生成分镜:
使用 Skill tool 调用 short-storyboard skill,传递参数:ep01
4.11 Director — 审核分镜:
- 使用 Skill tool 调用
short-review-storyboard skill,传递参数:ep01
- 若 review return
needs_revision M → 使用 Skill tool 调用 short-fix-storyboard skill,传递参数:ep01(最多 2 轮 fix;fix skill 自动读 .review-storyboard.md 最后一轮意见)
4.12 完成:
输出摘要:剧名、镜头数量(分镜数量)、关键帧数量、新建资产列表。