mcpField
P
paw-cra-video-shortform

paw-cra-video-shortform

github.com/pawbytes创意与媒体115178 次安装4 周前更新
代码仓库

关于 paw-cra-video-shortform

paw-cra-video-shortform 是面向短视频制作的工作流技能，可将简报或脚本制作成适用于 TikTok、Instagram Reels 和 YouTube Shorts 的竖屏成片。它结合 AI 场景生成与 ffmpeg，并输出带字幕的 MP4 和机器可读清单。

主要功能

  1. 01从简报规划 3–8 个场景
  2. 02通过 egaki CLI 与 fal.ai 生成场景
  3. 03可选生成 ElevenLabs 配音
  4. 04ffmpeg 剪辑、转场与字幕烧录
  5. 05验证编码规格并导出清单

适用场景

  1. 01根据品牌简报制作短视频
  2. 02为 TikTok、Reels 或 Shorts 生成竖屏成片
  3. 03以无交互模式运行视频制作流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pawbytes/skill-suites --skill paw-cra-video-shortform

安装后在 Claude Code 中输入/paw-cra-video-shortform确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
headless-mode.md
pre-production.md
production.md
validation-export.md

详细介绍

短视频制作流程

概述

此工作流可制作可直接上传的竖屏短视频（15-90 秒），适用于 TikTok、Instagram Reels 和 YouTube Shorts。它接收创意简报或脚本，并输出带有内嵌字幕的成品 MP4（1080x1920，H.264）以及 video-manifest.json。

**参数：**支持 --headless / -H，用于非交互式执行。至少需要包含主题、时长、平台和品牌的创意简报。

**输出：**MP4 视频文件和 video-manifest.json，保存至 .pawbytes/creative-suites/brands/{brand}/videos/。

作为技术视频制作专家，协调 AI 生成工具和 ffmpeg，构建连贯的短视频制作流程。你既了解创意叙事（吸引点、节奏、视觉节拍），也熟悉视频工程技术（编解码器、分辨率、安全区域、平台限制）。

**设计原因：**此工作流以制作优先——可直接接收创意简报，无需经过 Strategist 强制审核环节。如果用户未提供脚本，可按需使用 Strategist 编写脚本。编解码器验证步骤（步骤 9）作为内置审核关卡，取代旧的独立 cra-video-review-gate。每次运行都会生成实际的视频文件和机器可读清单。

激活时

从 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml（根级和 cra 部分）加载可用配置。如果缺少配置，请告知用户可随时通过 paw-cra-setup 配置模块。解析并应用：

  • {user_name}（null）——称呼用户时使用其姓名
  • {communication_language}（English）——用于所有沟通
  • {document_output_language}（English）——用于生成的文档内容
  • {fal_key}（null）——用于视频生成的 fal.ai API 密钥
  • {elevenlabs_api_key}（null）——用于配音的 ElevenLabs API 密钥（可选）
  • {output_directory}（.pawbytes/creative-suites）——基础输出路径
  • {default_brand}（null）——默认品牌名称

从 {project-root}/.pawbytes/creative-suites/index.md 加载共享机构记忆。如果已设置当前品牌，则加载 {project-root}/.pawbytes/creative-suites/brands/{brand}/guidelines.md。

**工具验证：**检查 fal_key（必需）、ffmpeg 是否可用（必需）、egaki CLI（AI 视频生成必需）、elevenlabs_api_key（可选，用于配音）。报告缺少的工具，并告知用户哪些功能会受到限制。

如果传入 --headless 或 -H，加载 ./references/headless-mode.md 并以非交互方式执行。

否则，向用户问候、报告工具就绪情况，并开始收集创意简报。

流程

此流程分为三个阶段。每个阶段都会按需加载相应参考文档。

阶段 1：前期制作

步骤 1-4——加载品牌背景信息，从创意简报制作分镜脚本。

加载 ./references/pre-production.md 并执行。

包括：收集和解析创意简报、检查脚本（使用用户提供的脚本，或选择调用 Strategist）、规划分镜（3-8 个场景，为每个场景提供视觉指导）以及加载品牌背景信息。

**阶段进展：**分镜脚本已确认（交互模式下由用户批准，无头模式下自动批准）。

阶段 2：制作

步骤 5-8——生成场景和音频、进行组装并添加字幕。

加载 ./references/production.md 并执行。

包括：通过 egaki CLI / fal.ai API（Veo 3.1 或 Kling v3）生成 AI 场景、按需通过 ElevenLabs 生成配音、使用带转场效果（xfade）的 ffmpeg 进行组装并叠加音频，以及生成并内嵌字幕（设置样式并放置在安全区域内）。

**阶段进展：**带字幕的组装视频已作为文件保存到磁盘。

第 3 阶段：验证和导出

步骤 9-11——验证、导出并记录。

加载 ./references/validation-export.md 以执行。

涵盖：编解码器验证（1080x1920、H.264、时长检查、文件大小低于平台限制），导出到 {project-root}/.pawbytes/creative-suites/brands/{brand}/videos/ 并生成 video-manifest.json，以及更新活动状态和每日日志。

**进度：**已写入 video-manifest.json，已更新每日日志。

工具依赖

工具用途必需
egaki CLI多提供商 AI 视频生成（Veo、Kling）是
fal.ai APIVeo 3.1、Kling v3（文本转视频、图像转视频）是
ffmpeg场景拼接、xfade 转场、音频叠加、字幕烧录、编码是
ElevenLabs APIAI 配音生成可选
paw-cra-agent-strategist脚本撰写（未提供脚本时按需调用）可选

平台规格

平台最长时长分辨率纵横比最大文件大小
TikTok60s1080x19209:16287 MB
Instagram Reels90s1080x19209:16250 MB
YouTube Shorts60s1080x19209:16256 MB

记忆

读取：

  • {project-root}/.pawbytes/creative-suites/index.md —— 活跃品牌、活动
  • {project-root}/.pawbytes/creative-suites/brands/{brand}/guidelines.md —— 品牌标识
  • {project-root}/.pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/brief.md —— 活动简报
  • {project-root}/.pawbytes/creative-suites/brands/{brand}/campaigns/{campaign}/scripts/ —— 已批准的脚本

写入：

  • {project-root}/.pawbytes/creative-suites/brands/{brand}/videos/ —— 视频素材
  • {project-root}/.pawbytes/creative-suites/brands/{brand}/videos/video-manifest.json —— 清单
  • {project-root}/.pawbytes/creative-suites/daily/{YYYY-MM-DD}.md —— 活动日志

评论

支持 Markdown