用途
knowledge-video 用于把一个主题做成知识科普视频，目标是让视频容易看懂、画面好看、让人愿意看到最后（画面文字配音乐）。它给出的是一条可行路径，而不是固定流程：可以合并、跳过或重排步骤，并针对具体主题自行设计文案、视觉和动效。与用户交流时使用用户的语言，文中文件名均为默认名。
主要能力与工作路径
大致路径如下：
- 研究 → article.md：查找来源并写出有出处的文章。先判断主题的形态（时间线、因果链、概念、对比、误区、单一故事），再决定覆盖哪些要点。要点数量由用户决定：按音乐长度提供两到三个方案并推荐一个。
- 文案 → script.md：把文章改写成让人愿意停留的视频文案。
- 图片 → images.md 或 image-prompts.md：使用真实图片，或为 AI 插画编写提示词（默认假设无法调用图像 API，由用户自行运行工具）。
- 视觉与分镜 → looks/、storyboard.md：先给用户看几个方向，再按音乐做分镜。
- 渲染 → 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>（研究和渲染通常不需要）。用户未说明的内容根据主题推断，不确定的在报告中询问。填写好的提示词与步骤产出一起展示；如果用户修改了提示词，则从修改后的版本重做该步骤。
执行者分工：需要与用户来回确认的步骤（几个要点、哪种视觉）由自己完成。大型独立步骤（研究、找图或写图片提示词、写合成与渲染）交给子代理：只给它简报、本步骤提示词和文件路径，使其上下文干净、只包含本步骤所需内容。子代理不知道使用者与用户讨论过什么，因此两者都必须完整。子代理完成后，先阅读其输出并运行自检，再展示给用户。没有子代理时，自行按提示词执行。
必须满足的要求
- 事实有来源：每个年份、人名、数字和引语都可追溯到可靠来源（论文、机构、档案、本人原话），并在 article.md 中链接；无法溯源的删除，估计值需标注，二手说法需说明是谁的说法。屏幕上每一行文字，包括开场问题和结尾，都与 article.md 一致。
- 素材可用：图片、音乐、音效和字体均已获得本用途授权（查看文件页面）；署名写入 credits.md。
- 不得用 AI 绘制真实人物的面孔；如果视频使用 AI 插画，需打开平台的“AI 生成内容”标签。
- 画面只依赖时间：为随机性设种子，使同一帧每次渲染结果一致（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：信息论的夜空粒子视觉，修改三次（动效太平 → 文案难跟上）
- references/prompt-examples.md：来自一个已测试视频的两份填写好的提示词，可看到详细程度
- references/notes.md：关于文案与节奏的观察，包括如何让推理链站得住
- references/images.md：检查授权、编写提示词、分层生成
- references/visuals.md：密集拼贴、夜空粒子、时间线时刻、照片卡片、把 UI 适配到生成画面、用代码绘制什么
- references/sound.md：音乐剪辑、音效、响度
- references/pitfalls.md：渲染失败或画面异常时先查这里
适用场景与限制
适用于把单一主题制作成知识科普视频，尤其是需要事实溯源、视觉方向选择和按音乐节奏分镜的场景。限制包括：事实必须有可靠来源，无法溯源的需删除或标注；素材必须获得授权；不得用 AI 绘制真实人物面孔；画面必须可复现（设随机种子）；交付前必须完整观看检查。关于收费、价格、平台支持等具体信息，资料中暂未提供。