knowledge-video

知识视频

把一个主题变成一支让人想看到最后的知识视频。接下来是一条行之有效的路径，而不是固定流程：合并、跳过或调整步骤顺序，并针对这个主题自行设计文案、视觉风格和动态效果。

用用户的语言与他们交流；下方的文件名是默认名称。

大致流程

1. 研究 → article.md：查找资料并撰写有来源依据的文章。先了解主题的形态（时间线、因果链、概念、比较、误区、一个故事），再决定涵盖哪些要点。要点数量由用户决定：根据音乐时长提供两到三个选项，并推荐一个
2. 文案 → script.md：把文章改写成适合人们刷视频时观看的文案
3. 图片 → images.md 或 image-prompts.md：使用真实图片，或编写 AI 插画提示词（假设你无法调用图片 API；用户会运行自己的工具）
4. 视觉风格和分镜 → looks/、storyboard.md：先向用户展示几种方向，然后根据音乐制作分镜
5. 渲染 → opening-preview.mp4 → final.mp4：先制作一段简短的开场预览，确认无误后再制作完整视频

默认情况下，每一步完成后都先向用户展示结果，再继续下一步：方向错了，在渲染后纠正代价最高。如果用户说“全部做完”，就继续完成所有步骤，并在 storyboard.md 中说明你的选择及原因。

每一步：先填写提示词，再按提示执行

根据 Anthropic 的提示词指南，将背景、要求和检查项分别放在不同的 XML 标签中，并为每一行说明原因：分开的部分不容易混在一起，了解原因也能让模型举一反三，处理未明确写出的情况。根据当前主题和用户所说的内容自行填写这些标签。

• 简介 prompts/brief.md：开始时填写一次，每一步完成后更新。只保留一个 <context>：主题、受众、核心收获、时长、画面方向、音乐、用户的喜好与厌恶、前面步骤已确定的内容，以及文件位置

• 本步骤的提示词 prompts/<step>.md，包含四个标签：

  • <role>：说明这一步由什么角色负责，以及该角色最关注什么。不同步骤的角色不同；为当前步骤选择一个角色，例如：研究由知识编辑负责（最关注来源），文案由编剧负责（最关注观众是否会划走），图片由图片编辑或插画师负责，视觉风格由艺术指导负责，分镜由分镜师负责，构图由动态设计师负责（最关注每个动作解释了什么）
  • <task>：说明这一步要产出什么，以及产物的保存位置
  • <style>：列出建议采用的方法，并说明原因；建议，不是规则：从 references/ 的示例中挑选，或针对当前主题设计新方案；用户表达了意愿时就遵循，并在此处注明他们不想要的内容
  • <check>：逐项列出认定这一步完成前需要核实的内容；包含“必须满足”的项目

  每一步都填写 <role>、<task> 和 <check>；不需要 <style> 时就省略（通常是研究和渲染步骤）。根据主题推断用户未说明的内容，并在报告中询问不确定之处。展示填写完的提示词和这一步的输出；如果用户修改提示词，就按修改后的版本重新执行这一步

由谁执行：需要与用户来回沟通的步骤（要点数量、视觉风格）由你亲自完成。大型且相对独立的步骤（研究、寻找图片或撰写图片提示词、编写构图方案和渲染）交给子 Agent：只提供简介、本步骤的提示词和文件路径，确保其上下文精简，只包含当前步骤所需内容。子 Agent 不知道你和用户讨论过什么，因此这两份内容都必须完整。完成后，阅读其输出，并在展示给用户前执行自检。没有子 Agent 时，就自行按提示执行。

必须做到

• 事实有据可查：每个年份、名称、数字和引述都可追溯到可靠来源（论文、机构、档案、当事人的原话），并在 article.md 中附上链接；无法查证的内容应删除，估算值要标注，二手说法要说明是谁的说法。屏幕上的每一行文字，包括开场问题和结尾，都必须与 article.md 一致
• 素材可用：图像、音乐、音效和字体都必须获得用于本项目的许可（检查文件页面）；在 credits.md 中列出鸣谢信息
• 不得使用 AI 绘制真实人物的面孔；如果视频使用 AI 插画，请开启平台的“AI-generated content”标签
• 画面只取决于时间：为所有随机性设置种子，确保每次渲染同一帧的结果都相同（HyperFrames 需要这样做）
• 交付前，亲自完整观看一遍：文字清晰可见、阅读时间充足且易于理解（推理过程没有跳步；悬念后续得到解答），年份和数字与文章一致，声音和画面同步

可用工具

使用 HyperFrames 制作画面（npx hyperframes init / docs / check / snapshot / render）；如果已安装相关技能，请按其要求进行构图。scripts/ 中有一些小工具，可按需使用：

脚本	功能
beats.py	分析音乐的速度、节拍、小节线和每小节的响度变化
music_loops.py、cut_music.py	查找可重复或可无缝剪切的小节，并根据小节列表制作新音乐
timing.py	将每屏文案排到节拍网格上，并将关键画面固定到指定小节
sfx.py	下载 Kenney 的 CC0 拟音音效，并将音效提示混合成一条音轨
qa.py	生成每个画面的联系表，以及关键节拍前后的帧图

以往视频留下的参考

这些是参考，不是规则。应先针对主题进行设计；遇到不确定情况或碰到相同问题时，再查看以下内容：

• references/example-ai-history.md：首次测试运行的每一步输出和时间安排
• references/example-fish-and-bears-paw.md：Information Theory 的夜空粒子效果，经过三次修订（动态过于平淡 → 文案难以跟上）
• references/prompt-examples.md：来自测试视频的两份已填写提示词示例，展示提示词可以写得多详细
• references/notes.md：关于文案和节奏的观察，包括如何让一连串推理顺利落地
• references/images.md：检查许可、编写提示词、分层生成
• references/visuals.md：密集拼贴、夜空粒子、时间线时刻、照片卡片、将 UI 融入生成画面、用代码绘制的内容
• references/sound.md：音乐剪辑、音效、响度
• references/pitfalls.md：渲染失败或画面不对时，先查看此处