mcpField
B
broll-catalog-builder

broll-catalog-builder

github.com/postplusai创意与媒体27281 次安装1 天前更新
代码仓库

关于 broll-catalog-builder

将 B-roll 文件夹或文件列表整理为可复用素材目录的技能。它记录语义标签、可用片段区间、支持角色和证明力，供后续匹配使用。

主要功能

  1. 01扫描本地媒体文件夹
  2. 02记录标签和支持角色
  3. 03标出可用素材区间
  4. 04标注证明力与视觉风险

适用场景

  1. 01建立可复用的 B-roll 素材库
  2. 02查找支持宣传论点的片段
  3. 03区分证明素材与填充素材

安装

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

$npx skills add https://github.com/postplusai/postplus-skills --skill broll-catalog-builder

安装后在 Claude Code 中输入/broll-catalog-builder确认已加载。

包含的文件

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

_postplus_shared/00-core/shared-runtime/scripts/
download_videos_from_manifest_with_ytdlp.mjs
postplus_workspace.mjs
_postplus_shared/00-core/shared-runtime/scripts/lib/
execution_approval.mjs
hosted_billing_summary.mjs
hosted_execution_protocol.mjs
creative_format.mjs
postplus_cloud_client.mjs
hosted_media_generation_bridge.mjs
network_runtime.mjs
local_skill_cli.mjs
skill_runtime.mjs
postplus_workspace_runtime.mjs
postplus_cli_config.mjs
_postplus_shared/40-creative/b-roll-family/references/
skill-architecture.md
edit-enhancement-contract.md
contracts.md
scripts/
run_build_broll_catalog.mjs

详细介绍

B-roll 素材库构建器

遵循以下共享的公开技能规则：

  • postplus-shared 公开技能规则

当用户拥有 B-roll 素材，并且需要在规划剪辑前建立可复用的素材清单时，使用此技能。

此技能应为工作流中的 B-roll 部分创建素材母文件。

默认输出：

  • broll-catalog.json

可选的配套输出：

  • 联系表
  • 帧清单
  • Markdown 审阅摘要

适用场景

  • 将 B-roll 文件夹整理为可复用的素材库
  • 按语义而非仅按文件名标记 B-roll
  • 找出较长 B-roll 片段中最适合使用的区间
  • 将有力的佐证片段与较弱的填充片段区分开来
  • 为后续将素材与节拍匹配做好准备

触发信号

用户提出以下需求时，使用此技能：

  • 先整理这些 B-roll 素材
  • 给这些素材添加标签
  • 哪些素材适合作为佐证
  • 给我一个可复用的 B-roll 素材表
  • 先建立素材库

如果用户已有完善的素材库，并且需要进行最终的节拍匹配，则不要使用此技能。

请将此需求转交给：

  • skills/40-creative/b-roll-family/broll-match-engine

阅读以下参考资料

  • 技能系列架构：../references/skill-architecture.md
  • 共享约定：../references/contracts.md

有帮助时，使用以下现有的本地技能：

  • skills/40-creative/frame-extraction
  • 专用的视觉分析工作流

核心原则

不要只根据素材中实际可见的内容来编目。

还要记录：

  • 素材能够证明什么
  • 可以发挥什么剪辑作用
  • 在屏幕上停留多久才会失去新鲜感
  • 是否足以作为主要佐证，还是只能用于辅助

同一片段可以是：

  • 有力的佐证
  • 佐证力度较弱但适合作为转场掩护
  • 纯粹用于重置节奏
  • UI 演示

具体取决于它的使用方式。

必需输入

至少提供以下一项：

  • 本地 B-roll 文件夹
  • B-roll 文件清单
  • 本地文件路径列表

可选但很有价值：

  • 活动背景
  • 转录文本或脚本
  • 目标平台
  • 已知的佐证目标

工作流

1. 获取素材集

从以下来源建立工作文件列表：

  • 扫描文件夹
  • 文件清单
  • 明确提供的文件列表

保留本地路径。

2. 检查素材

针对每项素材，记录：

  • 媒体类型
  • 视频时长
  • 字面描述
  • 最适合使用的区间
  • 语义标签
  • 辅助作用
  • 视觉风险

必要时使用轻量级提取或生成联系表。

3. 判断剪辑用途

针对每项素材，判断：

  • 它是主要佐证、辅助佐证，还是填充素材
  • 它可以佐证哪些主张
  • 它适用于 9:16、16:9，还是两者都适用
  • 文字或 UI 是否清晰可读
4. 打包素材库

按照共享约定构建 broll-catalog.json。

此素材库应可在多次剪辑中重复使用。

最简脚本

首个实现脚本：

  • scripts/run_build_broll_catalog.mjs

当前首版功能：

  • 递归扫描本地文件夹
  • 保留视频和图像素材
  • 使用 ffprobe 获取时长和尺寸
  • 读取存在的同名 .md 旁置文件
  • 根据文件名和旁置文件文本推断保守的语义标签和辅助作用
  • 写入 broll-catalog.json

示例：

node ${CLAUDE_SKILL_DIR}/scripts/run_build_broll_catalog.mjs \
  --input-dir /abs/path/to/b-roll-source \
  --output <work-folder>/broll-catalog.json

公开技能执行约定

  • 将文件夹扫描结果、联系表输入、帧清单和中间素材库构建结果保存在 <work-folder>/.postplus/broll-catalog-builder/ 下
  • 仅将面向用户的最终 broll-catalog.json 或审阅导出文件保存在 .postplus/ 之外
  • 从对一个文件夹或候选列表的有限初步扫描开始，然后再扩大编目范围
  • 此技能需要 ffprobe；编目之前，请遵循 postplus-shared 本地依赖引导规则
  • 如果本地依赖引导失败，请立即停止，不要改用临时拼凑的 Shell 命令

输出标准

如果下游匹配器能够回答以下问题，这份目录就算合格：

  • 存在哪些素材
  • 这些素材支持哪些说法
  • 哪些素材确实有说服力
  • 哪些片段区间值得使用

如果输出只有文件列表和模糊的标签，那就不够。

第一版范围

优先采用：

  • 本地文件扫描
  • ffmpeg 元数据
  • 必要时提取帧
  • Markdown 和 JSON 打包

不要求：

  • 复杂的 CV 流程
  • 完美的对象识别
  • 无需审核的全自动片段评分

审核规则

置信度较低时，请如实说明。

不要把薄弱或泛泛的片段说成有力的证明素材。

最好将素材标记为：

  • generic filler

也不要夸大它的用途。

评论

支持 Markdown