Video Intro Outro Agent Skill

视频片头 / 片尾

> 生成片头/片尾视频卡片（标题 + 副标题 + logo + 关注引导），并把 片头 + 主视频 + 片尾

> 归一化后拼接成一条成片。全部走 skills/shared/scripts/intro_outro.py，**不要手拼

> drawtext / xfade**——脚本已处理字体路径、音画参数一致、转场时间偏移计算。

> 只做"片头/片尾卡片 + 拼接"。静态封面图见 poster-hero；通用剪辑见 video-editing；

> 完整"一句话→成片"流水线见 auto-short-video。

输入

| 字段 | 必填 | 说明 |

|------|------|------|

| 主视频 | 拼接时必填 | 要加片头/片尾的视频（没给就问） |

| 标题/副标题 | 推荐 | 片头主题、片尾致谢等文案 |

| 关注引导 CTA | 片尾常用 | 如"点赞 + 关注 不迷路" |

| logo | 可选 | 品牌 logo 图片，叠在标题上方 |

| 画幅 | 可选 | 默认竖版 1080x1920；拼接时默认对齐主视频 |

| 背景 | 可选 | 纯色 / 双色渐变 / 图片 |

输出（outputs/主题名/）

• 片头 / 片尾卡片片段（intro.mp4 / outro.mp4）
• 拼接后的成片（*-final.mp4）
• 报告：卡片时长、画幅、转场方式

执行步骤

脚本路径（相对项目根）：skills/shared/scripts/intro_outro.py（各子命令支持 -h）。

1. 生成片头卡片

python skills/shared/scripts/intro_outro.py card \
  --title "本期主题" --subtitle "3 分钟讲清楚" \
  --gradient --color 0x1a2a6c --color2 0xb21f1f \
  --size 1080x1920 --duration 2.5 -o outputs/主题名/intro.mp4

2. 生成片尾卡片（带关注引导）

python skills/shared/scripts/intro_outro.py card --preset outro \
  --title "感谢观看" --cta "点赞 + 关注 不迷路" \
  --color black --size 1080x1920 --duration 2.5 \
  -o outputs/主题名/outro.mp4

背景三选一：--color <色>（纯色）/ --gradient（配 --color/--color2 双色渐变）/

--bg-image <图>（图片背景，自动裁切填满）。--logo <图> 叠加品牌 logo。

3. 拼接到主视频

# 硬切（默认，最稳）
python skills/shared/scripts/intro_outro.py attach --main <主视频> \
  --intro outputs/主题名/intro.mp4 \
  --outro outputs/主题名/outro.mp4 \
  -o outputs/主题名/<名>-final.mp4

# 淡入淡出转场
python skills/shared/scripts/intro_outro.py attach --main <主视频> \
  --intro outputs/主题名/intro.mp4 --transition fade --trans-duration 0.5 \
  -o outputs/主题名/<名>-final.mp4

--intro / --outro 至少给一个，可只加其一。--transition 可选

none/fade/fadeblack/fadewhite/wipeleft/slideup/circleopen。画幅默认对齐主视频，

--size 可强制。

Profile 感知

• 有 Profile：标题/CTA 语气贴合 style.md 人设；有品牌 logo/主色时用作 --logo 与

--color；默认画幅按 platforms.md 主平台（抖音/小红书竖版 1080x1920，B站/横版 1920x1080）。

• 无 Profile：用中性文案与默认深色背景，竖版 1080x1920，末尾提示可提供品牌信息定制。

规则

• 卡片时长默认 2.5s，片头别太长（2-3s 为宜），避免劝退。
• 文案精炼——标题一句、副标题一句、CTA 一句，不堆字。
• 拼接前脚本会自动把三段归一化到同画幅/帧率/音轨，不要自己先转格式。
• 转场时长自动限制在相邻片段时长内，过长会被收窄。
• 产物统一进 outputs/主题名/。

参考来源

片头片尾/关注引导卡片是短视频与 B站/YouTube 的标准件；实现参考 ffmpeg drawtext（文字层）

与 xfade/acrossfade（转场音画交叠）的确定性组合，把易错的时间偏移与参数对齐封装进脚本。