원클릭으로 Manus에서 모든 스킬 실행

시작하기

compose-video

스타8

포크1

업데이트2026년 5월 19일 08:22

把已生成的视频片段按剧本顺序拼接为单集成片，可选混入 BGM 与场景间转场。当用户说"拼成片"、"合成本集视频"或"加背景音乐"时使用。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

javpower

javpower/-ArcReel

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

合成视频

把单集已生成的视频片段（videos/*.mp4）按剧本顺序串接为一段成片，写入 output/。可选混入 BGM、按 transition_to_next 添加场景间转场。

适用范围（重要）

仅 drama 模式 — 脚本读取剧本顶层 scenes[]；narration（segments[]）和 reference_video（video_units[]）会被脚本拒绝。这两种模式的成片导出请走 Web 端剪映草稿导出
单集拼接 — 一次只处理一份剧本文件，不支持多集合并
不实现片头片尾 / BGM 音量调节 — 这些需求请走 Web 端剪映草稿导出

CLI 用法

脚本必须在含 project.json 的项目 cwd 内运行，并使用相对项目根 cwd 的剧本文件名：

# 最简形式：按剧本顺序拼接 + 自动转场（按 transition_to_next）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json

# 混入 BGM（音乐文件相对项目根 cwd 或绝对路径）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --music background_music.mp3

# 关闭转场（一律 cut 拼接，可用于规避 xfade 编码不一致问题）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --no-transitions

# 自定义输出文件名（输出固定落在 output/ 下）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --output episode_1_final.mp4

完整参数：

参数	类型	说明
`script`	位置参数（必填）	剧本文件名（相对项目 cwd）
`--output OUTPUT`	可选	输出文件名；缺省按剧本 `novel.chapter` 字段生成。无论何种取值，最终都落在 `output/` 子目录内
`--music MUSIC`	可选	BGM 文件路径（相对项目 cwd 或绝对路径），但必须解析后位于项目目录内
`--no-transitions`	flag	全部用 cut 直接拼接，忽略剧本里的 `transition_to_next`

工作流程

读剧本 — 通过 ProjectManager.load_script() 从 scripts/ 加载（路径过滤复用 lib 内 _safe_subpath）
收集片段 — 按 scenes[i].generated_assets.video_clip 逐个解析视频文件并校验存在
拼接 — 默认走 normalize → concat（先把每段规范化为统一 H.264/AAC，再用 concat filter 编码），有 xfade 转场需求时按 transition_to_next 加滤镜
混音 — 若指定 --music，再做一遍 audio mix；输出文件名追加 _with_music

支持的转场类型

按剧本字段 scenes[i].transition_to_next 映射：

字段值	ffmpeg 行为
`cut`（默认）	直接拼接，无淡入淡出
`fade`	`xfade=transition=fade:duration=0.5`
`dissolve`	`xfade=transition=dissolve:duration=0.5`
`wipe`	`xfade=transition=wipeleft:duration=0.5`

前置检查

当前 cwd 是项目根（含 project.json）
剧本 content_mode 为 drama（顶层有 scenes[]）
每个场景的 generated_assets.video_clip 都已生成
ffmpeg / ffprobe 都在 PATH（脚本会预检）
BGM 文件存在（如指定 --music）

限制 / 缺失能力

下列能力未实现，请使用 Web 端剪映草稿导出：

narration / reference_video 模式（脚本只识别 scenes[]）
多集合并 / 单集分片裁剪
BGM 音量调节、独立 BGM 时间轴
片头片尾 intro/outro
字幕渲染

이 저장소의 다른 Skills

같은 저장소

generate-script

javpower/-ArcReel

调用项目配置的文本模型生成 JSON 剧本（同时产出每个分镜的 image_prompt 与 video_prompt）。由 create-episode-script subagent 调用。读取 step1 中间文件和 project.json，输出符合 Pydantic schema 的剧本。

2026-05-258

pr-ai-review-loop

javpower/-ArcReel

无人值守驱动 CodeRabbit、Gemini Code Assist、OpenAI Codex 的 review → 修复 → push → 再 review 循环,直到全部通过或触发收敛退出。主动调用:用户刚 push PR 或跑完 /commit-push-pr;提到 review / coderabbit / gemini / codex / 审查 / AI review / 等 bot 回复;CodeRabbit paused 需 resume;reviewer 有 actionable comments。即使用户只说"PR 怎么样了""review 回了吗"也应触发。

2026-05-258

manage-project

javpower/-ArcReel

项目管理工具集。使用场景：(1) 分集切分——探测切分点并执行切分，(2) 批量添加角色/场景/道具到 project.json。提供 peek（预览）+ split（执行）的渐进式切分工作流，以及角色/场景/道具批量写入。

2026-05-178

generate-video

javpower/-ArcReel

为剧本场景生成视频片段。当用户说"生成视频"、"把分镜图变成视频"、想重新生成某个场景的视频、或视频生成中断需要续传时使用。支持整集批量、单场景、断点续传等模式。

2026-05-168

generate-storyboard

javpower/-ArcReel

为剧本场景生成分镜图。当用户说"生成分镜"、"预览场景画面"、想重新生成某些分镜图、或剧本中有场景缺少分镜图时使用。自动保持角色和画面连续性。

2026-05-168

generate-assets

javpower/-ArcReel

"统一资产生成 skill：接受 `--type=character|scene|prop`，或不传自动扫所有 pending（缺 sheet）资源并按类型分发。当用户说"生成角色图"/"生成场景图"/"生成道具图"、想为新资产创建参考图、或有资产缺少 *_sheet 时使用。"

2026-05-148

name	compose-video
description	把已生成的视频片段按剧本顺序拼接为单集成片，可选混入 BGM 与场景间转场。当用户说"拼成片"、"合成本集视频"或"加背景音乐"时使用。

合成视频

把单集已生成的视频片段（videos/*.mp4）按剧本顺序串接为一段成片，写入 output/。可选混入 BGM、按 transition_to_next 添加场景间转场。

适用范围（重要）

仅 drama 模式 — 脚本读取剧本顶层 scenes[]；narration（segments[]）和 reference_video（video_units[]）会被脚本拒绝。这两种模式的成片导出请走 Web 端剪映草稿导出
单集拼接 — 一次只处理一份剧本文件，不支持多集合并
不实现片头片尾 / BGM 音量调节 — 这些需求请走 Web 端剪映草稿导出

CLI 用法

脚本必须在含 project.json 的项目 cwd 内运行，并使用相对项目根 cwd 的剧本文件名：

# 最简形式：按剧本顺序拼接 + 自动转场（按 transition_to_next）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json

# 混入 BGM（音乐文件相对项目根 cwd 或绝对路径）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --music background_music.mp3

# 关闭转场（一律 cut 拼接，可用于规避 xfade 编码不一致问题）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --no-transitions

# 自定义输出文件名（输出固定落在 output/ 下）
python .claude/skills/compose-video/scripts/compose_video.py scripts/episode_1.json --output episode_1_final.mp4

完整参数：

参数	类型	说明
`script`	位置参数（必填）	剧本文件名（相对项目 cwd）
`--output OUTPUT`	可选	输出文件名；缺省按剧本 `novel.chapter` 字段生成。无论何种取值，最终都落在 `output/` 子目录内
`--music MUSIC`	可选	BGM 文件路径（相对项目 cwd 或绝对路径），但必须解析后位于项目目录内
`--no-transitions`	flag	全部用 cut 直接拼接，忽略剧本里的 `transition_to_next`

工作流程

读剧本 — 通过 ProjectManager.load_script() 从 scripts/ 加载（路径过滤复用 lib 内 _safe_subpath）
收集片段 — 按 scenes[i].generated_assets.video_clip 逐个解析视频文件并校验存在
拼接 — 默认走 normalize → concat（先把每段规范化为统一 H.264/AAC，再用 concat filter 编码），有 xfade 转场需求时按 transition_to_next 加滤镜
混音 — 若指定 --music，再做一遍 audio mix；输出文件名追加 _with_music

支持的转场类型

按剧本字段 scenes[i].transition_to_next 映射：

字段值	ffmpeg 行为
`cut`（默认）	直接拼接，无淡入淡出
`fade`	`xfade=transition=fade:duration=0.5`
`dissolve`	`xfade=transition=dissolve:duration=0.5`
`wipe`	`xfade=transition=wipeleft:duration=0.5`

前置检查

当前 cwd 是项目根（含 project.json）
剧本 content_mode 为 drama（顶层有 scenes[]）
每个场景的 generated_assets.video_clip 都已生成
ffmpeg / ffprobe 都在 PATH（脚本会预检）
BGM 文件存在（如指定 --music）

限制 / 缺失能力

下列能力未实现，请使用 Web 端剪映草稿导出：

narration / reference_video 模式（脚本只识别 scenes[]）
多集合并 / 单集分片裁剪
BGM 音量调节、独立 BGM 时间轴
片头片尾 intro/outro
字幕渲染