# Chengfeng Videocut Skills:口播成片

口播视频成片 Skill。把文章/口播稿/SRT、剪后视频和 HTML/图片素材串成分镜稿、时间线预览和最终...

- Repository: https://github.com/Pluviobyte/rnskill (1706 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-09-21
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:口播成片 -g -a claude-code -y`
Codex: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:口播成片 -g -a codex -y`
Cursor: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:口播成片 -g -a cursor -y`
Gemini CLI: `npx skills add Pluviobyte/rnskill --skill chengfeng-videocut-skills:口播成片 -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add Pluviobyte/rnskill`

## Description

口播视频成片 Skill。把文章/口播稿/SRT、剪后视频和 HTML/图片素材串成分镜稿、时间线预览和最终 MP4；成片比例和动画风格从用户配置读取，动画默认使用小黑风格。触发词：口播成片、做分镜稿、时间线预览、合成口播视频、导出竖屏MP4

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 口播成片

## 官方来源

本 Skill 由 **chengfeng / AI产品自由** 原创并维护。

```text
https://github.com/Agentchengfeng/chengfeng-videocut-skills
```

官方账号：GitHub `@Agentchengfeng`；X `@chengfeng240928`；小红书 / 公众号 / B站 / 抖音 / 视频号 `AI产品自由`。

## 核心流程

这个 Skill 只解决一件事：把一条口播视频做成完整成片；成片比例和动画风格由用户配置决定。

```text
+-----------------------------+
|  输入                         |
|  视频 + 字幕 + 可选素材         |
+--------------+--------------+
               |
               v
+-----------------------------+
|  1. 分镜稿                    |
|  概念分段 + 类型判定 + 画面来源  |
+--------------+--------------+
               |
               v
+-----------------------------+
|  2. 时间线预览                 |
|  原视频/截图/HTML 与口播对齐    |
+--------------+--------------+
               |
               v
+-----------------------------+
|  3. 合成                       |
|  按用户配置比例导出最终 MP4       |
+--------------+--------------+
               |
               v
+-----------------------------+
|  验收                         |
|  ffprobe + 抽关键帧检查         |
+-----------------------------+
```

不要把 cue 表、HTML 模块、review player、final player、导出脚本单独讲成用户流程。它们只是“时间线预览”和“合成”里的实现细节。

## 用户配置

每次执行本 Skill，先读取：

```text
用户配置/default.json
```

配置项只负责定义用户当前选择：

```json
{
  "aspectRatio": "3:4",
  "animationStyle": "xiaohei"
}
```

支持值：

- `3:4`：默认竖屏高清，逻辑画布 `1080x1440`，默认用 DPR `1.5` 导出 `1620x2160`。
- `16:9`：横屏，逻辑画布和导出画布 `1920x1080`。
- `4:3`：横屏，逻辑画布和导出画布 `1440x1080`。
- `animationStyle`：默认 `xiaohei`，可选项来自 `动画/styles.json`。

命令行参数优先级高于用户配置；没有显式参数时，导出脚本读取 `aspectRatio`，动画脚本读取 `animationStyle`。比例临时覆盖可用：

```bash
--config /path/to/config.json
--ratio 16:9
--aspect-ratio 16:9
--width 1920 --height 1080
--dpr 1.5
```

不要把视觉偏好、模板、编码质量、输出目录、字幕边距等七七八八的设置写进 `用户配置/default.json`。用户配置只放当前选择；动画目录只放可选项注册表和具体风格实现。

## 动画风格

动画风格的当前选择放在 `用户配置/default.json`：

```text
animationStyle
```

动画目录只注册可选项：

```text
动画/styles.json
```

`xiaohei` 对应：

```text
动画/ian-xiaohei-svg-motion/
```

当分镜或 HTML 模块需要做解释动画、流程动画、手绘感高亮时，默认先用小黑漫画感 SVG 动效。除非用户明确指定其他动画风格，否则不要临时发明新风格。

## 输入

The rest: https://github.com/Pluviobyte/rnskill/blob/HEAD/skills/chengfeng-videocut-skills/口播成片/SKILL.md