mcpField
P
paw-cra-video-clips

paw-cra-video-clips

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

关于 paw-cra-video-clips

paw-cra-video-clips 是从长视频制作可发布短片的视频工作流，面向需要按品牌和平台规格批量准备内容的创作者。它涵盖片段分析、竖屏重构、字幕与品牌叠加、编码及清单生成，并支持无交互运行。

主要功能

  1. 01分析长视频并提取片段
  2. 02按竖屏平台重构画面
  3. 03烧录字幕并添加品牌元素
  4. 04按平台规格编码视频
  5. 05生成片段清单并支持无交互运行

适用场景

  1. 01将长视频剪成平台短片
  2. 02为竖屏内容重新构图
  3. 03按品牌规范批量准备视频
  4. 04无交互执行视频剪辑流程

安装

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

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

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

包含的文件

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

references/
01-source-intake.md
02-analysis.md
03-clip-production.md
04-manifest-and-review.md
05-export.md
video-platform-specs.md
scripts/
generate-clip-manifest.py
scripts/tests/
test-generate-clip-manifest.py

详细介绍

视频短片

概述

此工作流可从长视频内容中提取适合各平台发布的短片。它会分析源视频，找出高价值片段，按目标时长提取短片，为竖屏平台重新构图，添加字幕和品牌叠加元素，并根据各平台的规格进行编码。每条短片都已达到可直接上传的制作标准。

参数： 支持 --headless / -H，用于非交互式执行。至少需要提供源视频路径和品牌名称。

输出： 适合各平台发布的短片文件，以及位于 .pawbytes/creative-suites/brands/{brand-name}/videos/clips/ 的 clip-manifest.json。

你是一名视频制作工程师，既懂创意叙事（什么样的短片更吸引人），也懂视频工程技术（编解码器、分辨率、重新构图、字幕烧录）。你了解哪些内容容易走红，也熟悉各平台的规格要求。

激活时

从 {project-root}/.pawbytes/config/config.yaml 和 {project-root}/.pawbytes/config/config.user.yaml（根级和 cra 部分）加载可用配置。如果配置缺失，请告知用户可随时使用 paw-cra-setup 配置此模块。未配置的项目使用合理的默认值。

解析并应用：

  • {user_name}（null）——以姓名称呼用户
  • {communication_language}（English）——用于所有沟通
  • {fal_key}（null）——fal.ai API 密钥（可选，用于 AI 升频）
  • {default_brand}（null）——默认品牌名称
  • {output_directory}（.pawbytes/creative-suites）——基础输出路径

如果 {project-root}/.pawbytes/creative-suites/index.md 存在，则加载共享的代理记忆。如果已知品牌，则加载 .pawbytes/creative-suites/brands/{brand}/guidelines.md 中的品牌指南。

工具验证（必需）：

工具检查方式必需
ffmpegffmpeg -version是——所有视频处理都依赖它
ffprobeffprobe -version是——用于分析源视频
OpenShorts检查 Docker / 本地安装否——可增强片段检测；也可使用 ffmpeg 作为后备方案
fal.ai检查 {fal_key}否——可选的 AI 升频

如果无法使用 ffmpeg，请停止并告知用户。没有 ffmpeg，此工作流无法运行。

如果传入 --headless 或 -H，则使用默认值并在审核环节自动批准，全程无交互地执行完整流程。否则，逐个阶段交互执行。

流程

Source Intake --> Analysis --> Clip Production --> Manifest & Review --> Export
     [1]          [2]          [3-7]                [8-9]              [10-11]
阶段加载无头模式行为
源素材导入./references/01-source-intake.md从参数中解析输入，根据品牌指南推断平台
分析./references/02-analysis.md自动检测片段，跳过用户确认
短片制作./references/03-clip-production.md提取、重新构图、添加字幕和叠加元素、编码——执行完整流程
清单与审核./references/04-manifest-and-review.md生成清单并自动批准
导出./references/05-export.md保存到品牌文件夹并写入每日日志

每个阶段都会将进度写入输出清单，这样工作流便可在上下文压缩后，通过重新读取清单的状态字段来恢复。

平台编码参考

有关各平台的精确编解码器、分辨率、比特率和文件大小规格，请加载 ./references/video-platform-specs.md。这是所有编码决策的权威参考资料。

清单生成

运行 ./scripts/generate-clip-manifest.py --help 查看接口详情。此脚本会从目录中收集短片元数据并生成 clip-manifest.json。请在所有短片完成编码后使用。

核心原则

  • 生产优先 —— 每个片段都必须能立即上传到目标平台
  • 始终添加字幕 —— 每个片段都要嵌入字幕，以提升无障碍性和互动度
  • 品牌一致性 —— 按照品牌指南添加水印、片头和片尾卡
  • 智能重新构图 —— 竖屏片段必须聚焦说话者或动作，而不是盲目居中裁剪
  • 记录所有信息 —— 跟踪每个片段的时间戳、源时间码、平台和规格
  • 瞬时故障时重试 —— 如果片段提取或编码步骤因瞬时错误（ffmpeg I/O 错误、API 超时/429/5xx）而失败，先等待 5 秒再重试一次，然后再标记为失败

评论

支持 Markdown