把内容视频工作流拆成可验证的 Codex Skills

01 · Thesis

这不是一个单体 Skill，而是一组“窄职责 + 文件交接”的生产系统

这个仓库不试图让一个提示词包办选题、研究、写稿、配音、字幕和渲染。它把每一步限制在一个明确边界内，并把跨步骤的信息写进任务目录。下一步读取的是工件，不是上一轮聊天记忆。

02 · End-to-end pipeline

九个模块，围绕一个任务目录依次运行

完整视频请求由 content-video-workflow 编排，但它只拥有编排权，不吞并领域实现。它决定何时调用其他 Skill、何时验证工件、何时进入指定渲染器。

03 · Topic routing

先决定“要不要找热点”，再决定“讲什么”

选题模块先把自然语言请求压缩为 topic_request：领域、受众、平台、时效性和来源偏好。随后以固定优先级得出 source_mode，并把理由写回工件。这让同一输入的来源选择可以被复查。

04 · Artifact contracts

文件是模块间 API：每一次交接都可存档、验证、重放

工件按任务目录保存。这样可以替换某个实现，例如更换 TTS 服务或渲染器，而不必重新发明选题和研究；也可以从任一中间产物重启。

渲染清单的最小骨架

{
  "schema_version": 2,
  "renderer": "remotion",
  "project_dir": "remotion-project",
  "source": {"topic_brief": "topic-brief.json", "script_package": "script-package.json", "script": "script.md"},
  "media": {"audio_path": "tts/tts_x.wav", "subtitle_srt_path": "subtitle/subtitle.srt", "subtitle_segments_path": "subtitle/subtitle_segments.json"},
  "format": {"width": 1920, "height": 1080, "fps": 30, "aspect_ratio": "16:9", "language": "zh-CN"},
  "caption_policy": {"enabled": true, "max_lines": 2, "delivery_surface": "clean-player", "platform_ui_bottom_ratio": 0.04, "caption_bottom_ratio": 0.10, "caption_max_height_ratio": 0.12, "visual_clearance_ratio": 0.02},
  "visual_beats": [/* 从 script-package 继承的可执行视觉说明 */],
  "output": {"video_path": "renders/final.mp4", "qc_report_path": "renders/qc-report.json"}
}

05 · Evidence & editorial boundaries

把“注意力证据”和“事实证据”分成两条轨道

这是整套设计最重要的内容安全机制。公开热榜和 AI 日报都是发现入口，不能成为视频中实质性论断的唯一根据。脚本模块负责把它们转化为待查问题，再用权威资料决定能否说出口。

06 · Timing & layout authority

音频决定时间，清单决定安全区

单一布局权威：caption-layout.json

resolve_caption_layout.py 将清单中按画面高度表达的比率，转换为确定的像素边界。任何渲染器都不能硬编码字幕偏移：字幕必须在 caption_box 内，其他视觉元素必须止于 visual_content.bottom_y 之上。

07 · Renderer contract

渲染器是明确的交付承诺，而不是失败后的静默替身

两条渲染实现共享 manifest、音频、SRT、视觉节拍和布局边界，但工程形态不同。用户指定 remotion 或 hyperframes 后，工作流可以诊断和修复该渲染器，却不能悄悄改用另一个。

08 · Validation & recovery

质量控制不是“报错后等用户”，而是一条自动修复环

本仓库把可预见的错误前移为脚本检查。正常的文字、布局、音频或渲染缺陷应自动修复并重渲染；只有不可恢复的环境或源媒体问题，才需要报告给用户并请求改变条件。

任一正常检查失败 → 修复对应源工件 / 布局 / 场景 → 从相关检查重新开始，而非索要预览批准。

09 · Build your own

复刻同类 Skill 包的实施蓝图

要复刻的不是这九个名字，而是“将不确定性留在上游、将确定性交给合同和验证器”的工作方式。下面的顺序适用于任何多阶段内容、报告、课程或媒体生成系统。

最小编排器伪代码

function makeVideo(request) {
  task = createTaskDirectory(request)                 // request.json
  brief = request.needsTopic ? selectTopic(task) : briefFromExactTopic(task)
  package = researchAndWrite(brief)                   // claims + visual_beats
  assert(validateScriptPackage(package))
  assert(auditNarration(package, {strict: true}))

  audio = synthesizeTTS(package.script, {rate: 1.0})  // normalized delivery audio
  subtitles = transcribe(audio, {referenceText: package.script})
  manifest = makeRendererNeutralManifest(package, audio, subtitles, request)
  assert(validateManifest(manifest, {checkPaths: true}))
  layout = resolveCaptionLayout(manifest)

  renderer = request.renderer ?? "hyperframes"
  project = renderer === "remotion"
    ? buildRemotion(manifest, layout)
    : buildHyperFrames(manifest, layout)
  assert(noDeliveryGuides(project.deliverySource, layout))

  video = render(project)
  qc = inspectVideo(video, subtitles, layout)
  while (!qc.passed && qc.isRepairable) { repair(project, qc); video = render(project); qc = inspectVideo(video, subtitles, layout) }
  return {project, video, qc}
}

实现与测试清单

10 · Usage & source map

如何把它安装为项目内 Skill，并从请求启动

npx skills add Scitiger-AI/codex-content-video-skills

结合今天公开热榜，做一个 90 秒中文科技知识视频，
横屏 16:9，使用 Remotion。

审阅时应优先阅读的源文件

• README.md：安装、运行环境与包级边界。
• content-video-workflow/SKILL.md：全链路编排与交付合同。
• content-topic-selection/SKILL.md：来源路由及选择权。
• content-topic-selection/references/topic-brief.md：选题工件。
• self-media-script/SKILL.md：事实、叙事、视觉节拍与编辑复核。
• self-media-script/references/script-package.md：文稿交接契约。
• public-hot-signals/scripts/collect_public_hot_signals.mjs：来源独立失败与信号标准化。
• ai-trend-report/scripts/fetch_report.py：日报根 schema 校验与敏感 URL 清除。
• tts-generate-audio/SKILL.md、audio-generate-subtitle/SKILL.md：两段异步媒体服务。
• content-video-workflow/references/video-manifest.md：渲染器中立清单。
• resolve_caption_layout.py、validate_video_manifest.py：确定性几何与入口验证。
• hyperframes-content-video/、remotion-content-video/：两条渲染合同与 QC 实现。