video-content-engine

视频内容引擎

从一个有依据的源内容中，打造最有说服力的内容组合。不要硬凑固定数量的衍生内容。找出不同的承诺，选择能够兑现这些承诺的形式，并为每项资产明确其在组合中的作用。

前言

在可用时，运行仓库的隐私保护版本检查和遥测初始化程序：

python3 telemetry/version_check.py 2>/dev/null || true
python3 telemetry/telemetry_init.py 2>/dev/null || true

远程遥测采用自愿启用。切勿记录内容、URL、路径、凭据、姓名或业务数据。

明确执行约定

开始工作前，说明确切的源内容、所有者、频道、目标位置、所需模块、交付格式、本轮产物、停止条件和已知阻碍类别。

将源内容保持为只读。没有最新证据时，绝不声称已完成渲染、上传、预览、发布或 QC。将性能目标视为实验，而非预测。

接受任何有依据的源内容

接受公开或获授权的 URL、上传文件、本地文件、文字稿、音频录音或源文件夹。对于 run this skill on this video 这类笼统请求，默认执行诊断并提出建议，而非自动制作。

对于链接：

1. 确认确切的页面、所有者、频道、标题、时长，以及可访问的媒体或文字稿。
2. 优先使用原始文件，其次是获授权的可下载母版，最后才是已发布的流媒体。
3. 绝不替换为镜像、其他上传版本、账号、剧集或文字稿。
4. 如果身份验证、权限、DRM、媒体缺失或文字稿不可用导致无法进行有依据的分析，请索取可访问的源内容。不要仅凭元数据提出编辑建议。

除非用户要求制作，否则应返回一份简报，包含源内容评分、建议的编辑与运营模式、机会数量、首发波次、修复项与依赖项、制作复杂度、内容组合中的各项作用，以及开始制作所需的审批。

清点源内容

1. 记录路径或 URL、大小、时长、流信息，以及可用时的 SHA-256。
2. 生成带说话人标注和时间戳的文字稿。根据源内容核对并修正姓名、产品名和数字。
3. 建立：
   • 主张台账，区分结果、估算、轶事、预测和目标；
   • 权利台账，记录第三方媒体、徽标、同意、禁运期和赞助商；
   • 内容原子清单，记录时间戳、观看者、承诺、证据、张力、框架、兑现点、视觉内容、注意事项和依赖项。
4. 阅读 references/opportunity-routing.md，为可行的内容原子评分，并记录选中和排除的机会。

机会清单是事实依据。应建议源内容能够支持的资产数量；不要默认采用固定配额。

编辑前，阅读 references/editorial-review.md，了解如何覆盖所有轨道、以证据引导开场，以及审查完整内容。分别清点摄像机、屏幕共享、演示文稿和播放音频轨道；摄像机合成画面可能未包含说话者提及的证据。

选择改编方式

阅读 references/quality-gates.md。分别为钩子、清晰度、证据、节奏和兑现效果评分，每项 0–20 分。

选择破坏性最小的编辑模式：

1. 润色 — 删除错误、冷场和技术干扰。
2. 精简 — 删除重复内容和离题内容，同时保留结构。
3. 重构 — 重做冷开场、调整证据位置、重排章节，并补足衔接。
4. 重制 — 添加补录内容、旁白、演示或图形，打造实质上全新的成品。

对于精简、重构或重制，应在最终剪辑前，创建基于精确源内容、精确到词句级别且带时间戳的文字稿。备忘录中的时间戳仅用于章节参考，绝不是实际剪辑点。

阅读 references/format-modes.md。选择一种主要模式和有充分依据的辅助模块。未指定模式时，默认采用内容组合审计，并建议规模最小且有用的发布波次。

锁定作品集主线

写出：

[Viewer] should believe [verdict] because [proof], then use [framework] to reach [outcome].

为每个入选素材明确一个承诺、受众、平台、作用、收获、上级素材、目标位置和包装意图。拒绝重复承诺、不完整片段、缺乏依据的主张，以及无法独立成立的素材。

制作入选模块

长篇内容

渲染前创建剪辑／重排图和 EDL。根据精确的转录稿核对片段，并确保从完整的观点开始和结束。运行：

python3 scripts/audit_edit_boundaries.py \
  --transcript <exact-source-transcript.json> \
  --clips <retained-clips.json> \
  --output <boundary-audit.json>

渲染后转录成片并检查每个衔接处。记录左侧尾部、右侧开头、转场、结论和修复方案。技术解码不能替代语义审查。将之前的渲染版本保留为带版本号的文件。

中篇内容

围绕一个框架、案例研究、问题、论点或演示，制作自成一体的 3–12 分钟视频。每个视频都要有独立的吸引点、背景、证据、收获、包装和目标位置。

短篇内容和微内容

仅从完整的信息单元中制作 15–90 秒的竖屏素材。从吸引点开始，保留主张的背景信息，以 1080×1920 渲染，并提供嵌入式字幕和 SRT 文件，最后以收获或有用的问题收尾。

只有在能如实引导受众时，才制作 6–20 秒的预告片、吸引点测试、故事单元、付费推广精简版或动态引言。将宣传片段单独标注。

字幕和开场处理

默认成片使用清晰易读的嵌入式字幕，并配有匹配的 SRT 文件，除非用户选择不使用。验证字幕时间码单调递增且互不重叠、每条最多两行、边距适合移动端阅读，并确保字幕结束时间不晚于成片结束时间。

开场叠加层的时长以获批的品牌简报为准；如无简报，可先设为 4 秒，若素材适合，则采用干净的开场。叠加层无法弥补口播吸引点的不足。在不强化主张的前提下，呼应口播中的承诺。检查叠加层是否与字幕、下三分之一字幕条、章节卡片和限定语冲突。主张限定语优先。

轮播图和文字衍生内容

当某种格式有助于提升理解或传播效果时，可制作滑动叙事、新闻简报、文章、帖子、帖子串、节目说明、清单或摘要。要求提供品牌素材，否则使用中性方案；绝不凭记忆重构人物、吉祥物、徽标或身份标识。

为每项素材做好包装

• **长篇内容：**标题、缩略图简报、冷开场、前 30 秒的承诺、说明、章节、置顶评论和结束画面。
• **中篇内容：**浏览／搜索标题、封面、开场白、系列标签、说明和上级素材路径。
• **短篇内容／微内容：**首帧画面、口播吸引点、标题、封面、帖子文案、评论提示和 CTA。
• **轮播图：**封面承诺、滑动内容推进、说明文字、CTA、最后一页、来源和替代文本。

创建承诺假设，而非仅在外观上做变体。若包装中的承诺没有兑现，就应弃用。

规划分发并控制副作用

盘点有充分理由使用的 B-roll、屏幕截图、引用来源、示意图、下三分之一字幕条、限定语、章节卡片、叠加层、字幕、推进镜头、音乐、音效设计、补录片段、旁白、赞助商植入和结束画面衔接。定义各元素发生冲突时应由哪个视觉层让位。

按需制作发布路线图，列出发布顺序、间隔、平台、引流路径、时效性与常青内容状态、流量蚕食警告和重新剪辑窗口。

未经明确批准并通过权威渠道确认结果，绝不发布、安排发布时间、上传、更改分享设置、消耗配额或启动营销活动。

审阅并移交可编辑项目

在规划预览、修订或团队移交之前，请阅读 references/editing-workflow.md。确保所有选定素材都可在完整时长内访问，提供不可变版本、带时间戳的反馈和可编辑源映射。钩子测试和精简预览可作为完整审阅的补充。尊重用户对存储和前台播放的偏好。

此软件包包含一项操作技能和两个验证器，不包含托管式编辑器、媒体存储、渲染服务或多人协作应用。请使用现有且获授权的编辑器或渲染器；如缺少基础设施，请如实说明。参考资料中的共享工作区设计是一份实施契约，并非已部署的功能。

收敛、交付与总结经验

请遵循 references/quality-gates.md。确认源文件完整性、作品集匹配度、媒体解码和时序、剪辑边界、渲染后的衔接、字幕、叠加内容、声明、权利、打包和交付文件。

technical integrity does not equal a coherent edit

请阅读 references/delivery-contract.md，生成其模块化文件夹和清单，然后运行：

python3 scripts/validate_delivery.py --root <delivery-folder>

交付验证器会检查引用路径、哈希值和所选清单字段。通过验证并不代表媒体可播放、字幕质量合格、编辑审核通过或已准备好发布。请清晰标示待处理和未通过的人工／Agent 审核关卡。

返回评分、模式、机会数量、作品集映射、时长、软件包、来源、输出、质量控制、已验证的目标位置、发布状态，以及 24 小时、72 小时和七天的衡量计划。只有在多次可比结果中反复验证后，才推广一条经验。

维护引擎

根据请求运行；此技能不会安装后台作业。跟踪每项素材的状态：已准备、待审候选、要求修改、已批准、正在渲染和已交付；另行跟踪发布状态及目标位置证据。将修正记录为可复用的编辑规则，但不要包含私有项目信息。将性能观察与品牌偏好分开。只有在实际产出通过适用关卡后，才推广某个工作流；若有记录在案的替代方案取而代之，则废弃旧规则。