用途：为已理解的口播、访谈、纪录片或讲解视频，在转录文本对应的时间点加入少量有证据支撑的视觉插入镜头（B-roll），素材来自本地媒体或 Pexels。
主要能力：基于规范化的 Project Protocol 序列工作，读取 work/project.json、work/timeline.json、work/understand/transcript.json、work/understand/understanding.json 等既有输入，不重新转录或分析。通过脚本完成素材获取、校验、归一化、回执应用与验证；支持本地视频导入与 Pexels 检索，采用轮询合并查询、按 provider ID 去重，每个镜头最多八个唯一视频。候选分析会下载并完整解码分析变体，按 10/30/50/70/90 百分比采样，生成确定性机器证据、接触表、亮度/裁切/边缘/运动与重复证据。排序按语义优先的字典序规则，最多保留三个候选。
使用方式：需先安装并运行 /video-understand。依赖 Python、ffmpeg、ffprobe、Pillow。Pexels 密钥优先取环境变量 PEXELS_API_KEY，其次读 skills/video-add-b-roll/.env；两者都缺失或为空时停止并请用户通过本地 .env 文件提供，不得通过聊天传递，也不得出现在命令参数、计划、URL、日志、评审产物或响应中。从仓库根目录运行，解析独立项目根目录。手工编写 work/b-roll/broll-plan.json，脚本只负责精度不负责编辑判断。每次实质修改后运行校验命令。
适用场景：口播、访谈、纪录片、讲解类视频的插入镜头规划与评审。
限制：不得伪造人类授权；Agent 评审需明确委派与真实回执。缺失、薄弱或被下载器拒绝的媒体应标记为 skipped，不得使用随机或静帧回退素材。不得引入人脸检测器、分割模型、跨剪辑身份追踪或猜测 ROI。计划与回执须放在 work/cache/ 之外。时间线、转录、依赖版本、调色计划、LUT、评审视频、候选清单或已评审素材变化会使下游工作过期，需刷新计划并重新评审。具体收费、价格、平台与效果资料暂未提供。