# One Minute Remotion

> “Vibe 知识大赏”1至2分钟中文科普视频 Skill，覆盖数理化生与 AI 概念的写稿、自选声音、分镜、Remotion 动画、字幕与 MP4。用于一分钟/两分钟科普、课堂概念短片、系列文稿或明确调用本 Skill。“下一步”只推进一个阶段；动画约30秒一章，确认后再做下一章；明确要求导出才出片。全文与原语速优先。

- Skill: `itwanger/one-minute-remotion` (Agent Skill, multi-file: 64 files)
- Install (CLI): `npx get-skill add itwanger/one-minute-remotion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/itwanger/one-minute-remotion/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: itwanger (https://skillmd.com/u/itwanger)
- Updated: 2026-11-14
- Page: https://skillmd.com/skills/itwanger/one-minute-remotion

---


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

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

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

## 阶段与确认

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

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

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

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

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

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

## 文字与声音

- 本系列新写与润色遵循[写稿规范](references/narration.md)，先读[勾股定理范例](examples/pythagorean-theorem.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/` 提供，不复制多套。场景、音频、字幕时间轴与确认记录属于各版本，不放进全局共享。
- 安装器以相对链接复用动画库和字体，升级创建新版本目录；已修改的项目副本拒绝覆盖。现有独立工程仍支持本地副本，不强制迁移。命令见[独立制作流程](references/runtime.md)。

## 画面与制作

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

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 不顺便调用付费服务、下载模型或做样片。不自动提交、推送或发布，除非用户明确授权。

