Material Report

核心用法

Material Report 是一款面向效果广告投放场景的 AI 分析工具，核心链路为「视频解析→框架拆解→创意再生」。用户上传素材视频后，系统会自动提取帧图像（复用已有缓存，避免重复处理），随后按「开场钩子-冲突/问题-转折点-解决方案-结尾转化」五段式结构逆向解析原始素材的叙事逻辑。

工具同步输出三类关键信息：素材特征标签（剪辑节奏、字幕密度、meme 元素、UI 样式等）、可直接用于投放系统的 Acquisition Keywords（获取关键词），以及基于原品类/平台和当前市场趋势的全新创意框架。最终交付物为一份可直接交付剪辑执行的 Markdown 报告，内含带时间轴的详细故事板表格。

显著优点

1. 全链路自动化：从视频读取、帧提取到报告生成无需人工逐帧标注，显著压缩创意复盘周期。
2. 框架即插即用：拆解后的叙事结构可直接复用于新素材，降低创意团队的沟通成本。
3. 关键词资产化：提取的 Acquisition Keywords 可直接写入投放后台，打通「创意-投放」数据闭环。
4. 缓存机制：重复分析同一视频时自动复用帧文件，节省算力与时间。

潜在缺点与局限性

• 依赖 FFmpeg：若用户本地未安装或路径配置异常，流程会中断；暂不提供安装指引，对非技术用户存在门槛。
• 钩子识别主观性：当开场 0-5 秒存在多个强刺激点时，系统仅给出「最强候选+理由」，仍可能错过复合钩子的组合效果。
• 品类锁定：新框架强制约束在原视频的 category/vertical 内，跨品类创新（如把电商素材改成游戏素材）需人工二次调整。
• 无实时数据接入：判断「最佳方向」依赖模型知识截止点，无法联动真实投放数据（如当天平台热榜）。

适合人群

• 效果广告优化师（投手）：快速复盘跑量素材、输出迭代 brief。
• 短视频创意策划：获取结构化故事板，减少与剪辑的反复对齐。
• 品牌市场团队：统一素材分析语言，建立可复用的创意资产库。

常规风险

• 版权与隐私：帧提取后本地留存的图片文件需用户自行管理，涉及肖像或版权素材时存在泄露风险。
• 过度依赖模板：长期套用框架可能导致素材同质化，需定期人工介入创新。
• 路径权限：若工作目录无写入权限，流程中止，需用户手动授权而非自动降级处理。

核心用法

material-report 是一款专注于广告视频素材分析的智能 Agent Skill。用户只需提供本地视频文件路径、素材品类及目标投放平台，Agent 便会执行完整的工作流：验证视频元数据、提取关键帧、解析视频叙事结构（开场钩子-痛点-转折-解决方案-行动号召）、归纳视觉特征与关键词，最终输出一份包含原创分析与创新提案的专业 Markdown 报告。

工作流设计上，该 Skill 采用「分析-复用-生成」三段式架构。首先通过 ffmpeg 提取视频帧图像并缓存复用；随后按既定框架拆解原片，识别开场钩子（优先 0-5 秒及强视觉元素）、标注转折点与 CTA；最后基于分析结果生成至少一套全新创意框架，并附带详细的分镜时间表（含时间范围、画面动作、文案及视觉特效）。整个流程严格遵循用户原始语言风格，若未指定品类则会先询问再基于最佳推测标注假设。

显著优点

专业化输出：报告模板采用结构化 Markdown，包含素材框架拆解、特征标签、Acquisition Keywords 及新素材故事板，可直接用于内部评审或外包brief。

效率导向设计：缓存机制避免重复提取帧图；钩子识别提供多候选+强逻辑说明，降低人工复核成本；新框架生成明确「同品类+同平台」约束，确保创意方向可落地。

零代码依赖：纯 Markdown 提示词驱动（T-MD 类型），无可执行脚本，部署门槛低，仅需本地 ffmpeg 环境即可运行。

隐私合规前置：Skill 声明明确提示本地视频处理风险，用户需主动授权路径，符合数据最小化原则。

潜在缺点与局限性

外部依赖刚性：核心功能依赖用户本地 ffmpeg 安装，若环境缺失或版本不兼容将导致流程中断，且 Skill 不提供安装指引。

创意深度边界：新框架生成基于「判断最优方向」而非数据驱动（如无接入投放效果数据），依赖 Agent 的通用创意经验，可能缺乏垂直行业深度洞察。

路径与权限敏感：强制要求视频文件与帧图输出目录同名且位于当前工作目录，权限不足时需用户手动介入，灵活性受限。

无实时预览能力：纯文本报告输出，无法直接渲染视频或交互式预览分镜，需用户二次导入剪辑软件。

适合的目标群体

• 效果广告投放团队：急需快速拆解竞品/历史爆款素材结构，生成可执行的迭代 brief。
• 短视频创意编导：需要标准化的素材分析框架辅助创意脑暴，降低从「看完片」到「出方案」的脑力损耗。
• 广告代理商策划：向客户交付带方法论背书的素材诊断报告，提升提案专业度。
• 中小广告主 DIY 场景：无专职视频团队，希望通过结构化指导外包或自产素材。

使用风险提醒

供应链风险：来源为 ClawHub 平台个人开发者（T3 可信度），虽本次静态分析无安全问题，但建议关注后续版本变更，若引入可执行脚本需重新审计。

命令注入低危点：ffmpeg 调用采用文件路径参数传递（非 shell 文本插值），但仍建议确保视频文件名不含恶意特殊字符，仅处理可信来源文件。

许可缺失：当前版本未声明开源许可证，商用场景建议联系维护者 fevolq 确认使用条款。