Vibe 知识大赏：1至2分钟科普视频

让第一次接触的人通过一个具体例子看懂一个知识点。内容可以是小学、初中、高中的数理化生，也可以是 RRF、RAG、ReAct 等 AI 概念。用户给多个主题时分别制作，每条只讲一个核心道理。画面实际接入随包花叔动画库；默认暖米几何，可选择孟菲斯。声音使用当前使用者选定的音色或音频。

本仓库是可安装的独立 Skill，包含项目模板、工具和方法；不依赖作者的私人视频仓库或额外安装 video-script、ergo-remotion-video。包内不含可调用的作者音色配置、克隆模型、原始录音、头像或凭据。VibeScience仅作配套画面案例，Skill 安装与使用以本仓库为入口。

阶段与确认

固定顺序：①文字稿 → ②完整配音试听与实测时长 → ③分镜与分章 → ④逐章有声预览、整片有声预览 → ⑤明确授权导出与验收。

“下一步”“继续”只推进一个阶段；动画阶段只推进当前章。 当前阶段未完成或在返修时先处理当前问题，不启动后续后台任务。只有用户明确要求跳过确认、连续完成某个范围，才按该范围执行。

已有源稿时，读取、初始化、快照、提取口播、选择使用者的声音、锁定、读音处理、生成或导入完整配音、对齐和量时都属于②。交付完整音频和实际时长后停下，不写分镜、不实现动画、不导出。 “已生成”不等于用户试听通过。

配音确认后才进入③，按完整句意和因果过程分为约30秒一章，通常25～35秒，尾章可短一些。分镜确认后进入④，每轮只实现当前未通过的一章，首轮即交付带原旁白、字幕与动画的 Chapter<N>Preview。当前章确认后才做下一章。全部章节通过后，交付整片有声 Studio 预览并停下。

整片预览已通过且用户明确说“出片”“导出视频”，或明确授权跳过确认并连续出片时，才进入⑤。普通“下一步”不自动导出；不导出额外章节或备用 MP4 来代替 Studio。具体边界和音轨偏移见逐章有声预览。

每轮读取并更新项目 PROGRESS.md：当前阶段、当前章、已通过章节、实际产物与检查、待确认项和下一步。不得把自检通过记成用户通过；接力时保留已认可文稿、音频和画面。

文字与声音

• 本系列新写与润色遵循写稿规范，先读勾股定理范例。仅写稿或改稿时只交付该阶段；不强制交给其他模型。
• 源稿默认在工作目录的 docs/src/ai/one-minute/<topic>.md；用户已有其他路径时沿用真源。保留完整字词、标点、数字与例子，不覆盖同名文件。script.md 是项目快照，spoken.txt 只提取明确口播部分，不猜测不明确的 Markdown 结构。
• 现成稿件由使用者决定，技术疑点单列，不擅改源稿；不提供删减清单、精简稿或缩短建议。润色只在用户授权范围内进行，并说明改动。
• 沿用使用者选定声音与语速；缺少配置时询问所需声音或现有音频，不替换为另一个声音。凭证只读取环境变量，不能写进 Skill、日志、示例或锁文件。安装成功不等于 TTS 已可用。
• 默认1920×1080、30fps，目标1至2分钟，锁定默认120秒；旧锁定文件保留原目标。全文优先于时长，超时只报告实际时长与超出秒数，不漏读、截断、加速或重新锁定删减稿。字数估算不是实测。

目录与共享组件

• 开始前确认项目绝对路径。默认 videos/one-minute/<主题>/<工具>/<版本>/；作者现有工作区可用 script/one-minute/<主题>/<工具>/<版本>/。先主题，再工具，再版本，不能把各主题、各工具的产物平铺混放。
• 接力项目保留一份工程，记录制作、返修、导出分别由谁完成；不要复制整份工程冒充独立版本。来源不明用 unattributed，不得猜。历史试作可放 _archive/<主题>/<工具>/<版本>/。旧 slug、Composition ID、成片名无需随目录变动。
• 每个版本内：配音 audio/ 或 build/，素材 assets/，检查/截图/录屏 preview/，源码 remotion/src/，正式成片 output/；配置、分镜、锁文件与进度也留在该版本。所有输出显式指定路径，不写到仓库根目录或 Skill 安装目录。
• 集合目录下 shared/ 共用固定版本的动画库、字体、暖米及孟菲斯基础色板；项目保留导出入口和个别覆盖值。工具仍由本包 assets/runtime/shared/tools/ 提供，不复制多套。场景、音频、字幕时间轴与确认记录属于各版本，不放进全局共享。
• 安装器以相对链接复用动画库和字体，升级创建新版本目录；已修改的项目副本拒绝覆盖。现有独立工程仍支持本地副本，不强制迁移。命令见独立制作流程。

画面与制作

先读视觉规范、动画方法，选择并记录具体语法、色板、主体和上游函数。画面实际调用随包模块，API 与字体加载见画面接入。暖米、孟菲斯共用手机字号与阶段流程，已有项目沿用已确认画风。

1. 文字稿：入口、必要名词、结论、具体例子、成立原因、收尾；公式写成念法，推理不跳步。保存后停下。
2. 配音：生成或导入完整意群音频；字幕保留原文，读音处理不改含义。术语先核对，用户要求短样本时先试听再替换整句，不拼接孤立字母。真实音频驱动时间轴；无实际 ASR 不宣称逐字核查通过。
3. 分镜：记录原文、对象、动作、前后状态、短标签、语音锚点、可见因果及教学假设；按实际配音划分审片章，不平均切句，不提前制作动画。
4. 逐章预览：用帧驱动画面，章节局部帧与全片帧、字幕与音轨偏移一致。检查起始、中间、落定帧和正常速度完整播放。Studio 后台启动并有限检查日志、PID、端口和 HTTP，不等待常驻命令结束。不能用截图、无声动画或编译成功冒充有声预览。
5. 导出验收：获明确授权后沿用完整原音频导出，运行 verify_export.py 和 one_minute.py check --media，核对完整解码、字幕、音画同步与正常播放。可用且获准时由独立审片者复核，否则说明自检范围，不虚称独立验收。

视觉与交付检查

• 同一对象保持名称、颜色与身份；图形按真实比例，公式和数值与图形一致。相关元素成组，参数靠近所属公式；失败、未命中等状态仍保留对象，不伪装成名次。
• 主画面仅保留对象名、公式、数值和必要短标签，不重复字幕的整句解释、问句与结论。旁白讲解释，动作讲因果，不做文字卡轮播。
• 手机观看起点：对象标签48px、数学符号60px、核心公式84px、字幕48px。标题只写知识点，不自动加栏目名或期数。长字幕按完整语义依次显示，不缩字硬塞。
• 检查完整标签框、描边、阴影、公式上标和转场路径，主体与字幕通常留48～64px；检查390px与740px缩图，不把缩图当真机或动态验收。
• 教学示例与近似假设明确标注。RRF 名次从1开始，缺失贡献0，排序用完整精度；画面、字幕与旁白数据一致。
• 所有临时自动化浏览器、录屏与渲染检查在成功或异常时均收尾；不关闭用户浏览器或别的任务。仅保留正在使用或用户明确要看的预览服务，记录用途与关闭时机。

以当前加载的 SKILL.md 目录解析资源，不假定特定 Agent 安装路径。单阶段交付实际产物和检查后停下；仅安装或修改 Skill 不顺便调用付费服务、下载模型或做样片。不自动提交、推送或发布，除非用户明确授权。