itwanger/vibe-science / skills/one-minute-remotion
one-minute-remotion
VerifiedVibeScience:把小学、初中、高中的数理化生知识点或 AI 概念做成1至2分钟中文科普视频,覆盖写稿、自选音色配音、连续动画、手机端字幕和MP4。文字稿保存到one-minute/,超时保留全文。“下一步”只推进一个阶段,配音完成后停下供试听。用于知识点短视频、一分钟或两分钟科普、课堂概念短片、写或润色one-minute目录稿件,或明确调用one-minute-remotion;普通长视频不属于本技能范围。
SKILL.md
View on GitHub---
name: one-minute-remotion
description: VibeScience:把小学、初中、高中的数理化生知识点或 AI 概念做成1至2分钟中文科普视频,覆盖写稿、自选音色配音、连续动画、手机端字幕和MP4。文字稿保存到one-minute/,超时保留全文。“下一步”只推进一个阶段,配音完成后停下供试听。用于知识点短视频、一分钟或两分钟科普、课堂概念短片、写或润色one-minute目录稿件,或明确调用one-minute-remotion;普通长视频不属于本技能范围。
---
# VibeScience:1至2分钟科普视频
从主题或现成文字稿生成完整的1至2分钟科普视频,覆盖文字稿、配音、分镜、动画、字幕和出片。内容是小学、初中、高中的数学、物理、化学、生物知识点,以及 RRF、RAG、ReAct 这类 AI 概念。一条视频让第一次接触的人看懂一个知识点。Skill 名称沿用 `one-minute-remotion`,目录和共享入口不变。文字由用户决定,声音使用用户自己配置的授权音色,画面实际接入花叔动画库,采用适合概念的连续运动。用户一次列出多个知识点(如 RRF、RAG、ReAct,或勾股定理、相似三角形),默认分别制作,每条独立,不把几个知识点塞进同一条。
## 触发与分工
用户提到“Vibe 知识大赏”“知识点短视频”“一分钟或两分钟科普视频”“课堂插播的概念短片”,或明确调用 `one-minute-remotion` 时使用本 Skill,最终目标是完整视频,默认分阶段推进。文字稿是制作过程中的一个环节,支持当前 Agent 起草、润色或接收外部稿件。
本系列稿件(`one-minute/` 下的文件,或要做成本系列视频的稿子)的新写和润色都由本 Skill 负责,按 [写稿风格](references/narration.md) 执行。已明确属于本 Skill 的视频项目,用户要求先做文字稿、分镜或其他阶段时,只完成指定阶段。普通长视频不属于本技能范围。
## 阶段推进规则
**“下一步”只做下一个阶段,交付后立即停下。** “继续”“接着做”未指明范围时也按单阶段处理;不能因最终目标是视频、历史上授权过整片制作或创建了全流程任务清单,就继续执行余下阶段。用户最新的阶段限制优先。
五个阶段依次为:①文字稿保存;②配音生成与实测时长;③分镜设计;④动画、字幕与预览;⑤最终导出与验收。读取源稿、现有产物和进度,完成下一个未完成阶段;当前阶段未完成或正在返修时,先续完当前阶段,不跳过问题或重做已验收内容。任务清单只包含本轮阶段及其必要准备,后续阶段可注明待用户继续,不能自行启动后台任务。
用户说“文字稿已经保存到 one-minute/rrf.md,下一步”时,文字稿阶段视为已完成;读取并检查文件后直接进入②。项目初始化、源稿快照、口播提取、文字锁定、读音处理、完整配音、对齐及量时都属于②的必要准备和执行,不单独耗掉一次“下一步”。**配音完成后交付可试听的完整音频、文件路径、实测时长与待核对项,然后结束本轮,等待用户试听;不写分镜、不制作动画、不预览或导出MP4。** 不把生成成功说成用户已试听通过。
配音交付后用户再说“下一步”,即进入③,只交付 `OUTLINE.md` 分镜;再一次“下一步”才进入④,启动并交付可播放的 Remotion Studio 预览后停下;下一次进入⑤。用户明确指定某阶段时按指定范围执行。只有明确要求“一口气做完”“直接出片”“完成全部剩余阶段”等连续执行时,才在该范围内串联阶段;普通“做个视频”不自动取消阶段停点。
每次结束时在项目现有进度文件中记录本轮阶段、实际产物、未完成检查及下一阶段;没有进度文件时使用 `PROGRESS.md`。保持“配音已生成、待用户试听”和“用户已认可配音”的区别,方便其他 Agent 接力。
## 输入与范围
- 用户要求润色、调整现成文稿时,按 [写稿风格](references/narration.md) 的润色规则修改,交付时逐条列出改动;润色完成即为①的交付,停下等用户确认。
- 用户提供现成文稿要求照稿制作时,无论由用户本人、Gemini、豆包工作、Claude Code、DeepSeek Harness 或其他模型编写,都把它作为只读真源。用户说“按这份做视频”即已认可该稿,不再机械地重复确认。保留原文、标点、数字、大小写与例子;技术疑点及依据、实测时长单列,不擅改源文件。**不提供删减建议、可删内容清单、精简稿或缩短文稿方案**,超时只报告实际时长及超出秒数。
- 只有主题时,由当前 Agent 按 [写稿风格](references/narration.md)直接起草,无需先转交 Gemini。动笔前先读范例 `one-minute/pythagorean-theorem.md`。用户指定其他工具写稿时,提供该文件里的通用提示词,或在具备相应工具与授权时调用;只按实际执行记录说明稿件来源。
- 当前只要求创建 Skill,或在本视频流程中先做文字稿、分镜,就完成这一范围;“下一步”按阶段推进规则执行,不自动扩大到整片制作。明确要求连续出片时才完成剩余阶段,不沿用长片逐章拆分的流程。
- 默认 1920×1080、30fps,时长目标1至2分钟,上限120秒(`one_minute.py lock` 默认 `--target-sec 120`)。新写正文通常300至550字,给动作和阅读留出余量。**文字完整优先于时长目标**:实测超过2分钟仍保留全文、完整配音和原语速,报告总时长及超出秒数;后续获准制作的阶段按实际音频长度安排,不为凑时长精简、漏读、截断或加速。用户另行明确要求某个精确时长时,若与完整稿件冲突,只说明实际时长与要求的冲突,保留原稿等待用户指示,不附删减方案。
## 保留什么,替换什么
- **文稿**:以 [写稿风格](references/narration.md) 为准:入口、名词、结论、例子、为什么成立、收尾六段结构,公式写成念法,推理不跳步。不继承 `video-script` 的950至1800字、三层递进、固定自我介绍、闯关和关注收尾。
- **声音与工程**:使用随仓库提供的项目快照、读音词典、TTS、逐词对齐、字幕及导出验证。公开版不附带二哥私人音色,用户配置自己的合法音色或提供音频;同一项目沿用已选声音。不要为了赶时长提高当前项目语速。
- **画面**:从 `huashu-art-motion` 选择一套具体动画语法,读取对应语法卡。默认暖米几何画风沿用二哥共享色板 `C`;用户选择[孟菲斯画风](references/style-memphis.md)时使用其项目内独立色板,不改共享 `C`。实际调用随包提供的形变、描画、公式和世界相机库,或按对应配方接入上游渲染器。Canvas 画面接到现有 React/Remotion 时间轴,声音、字幕与导出沿用本流程。不能只引用“同例贯穿、连续变化”等原则却仍交付文字卡轮播;不复制作者角色或示范片。
- **本流程的布局优先**:画面只留对象名、公式、数值和必要短标签;字幕已有的整句、问句、结论及其近义改写不再叠到主画面。解释交给旁白与字幕,因果交给动画。不强制长片顶部多章导航、页框、满屏文字卡、进度闯关和推广尾段。保留简短主题标识与字幕安全区;不要为“动态”加无意义的漂浮、抖动、粒子或每镜推近。
- **手机观看优先**:采用[本系列视觉规范](references/visual-style.md),不直接套用长片的较小字号。1920×1080 起点为对象标签48px、数学符号60px、核心公式84px、字幕48px;标题只写当前知识点,不自动加“Vibe知识大赏”、期数或问句。长字幕按完整语义依次显示,不缩小字号硬塞。
- **画风选择**:已有项目沿用已确认画风;新项目默认暖米几何。用户说“孟菲斯”或指定相应参考时,读[孟菲斯风格卡](references/style-memphis.md),在分镜和来源记录中注明选择。两种画风共用手机字号、旁白、字幕和阶段流程;不因增加选项重做已认可视频。 孟菲斯实施前参照[已确认案例](references/approved-memphis.md),把首帧构图、配色层级和整框避让一起检查。
融合依据与上游版本见 [来源与取舍](references/sources.md)。画面实施前读 [视觉规范](references/visual-style.md)与[动画方法](references/motion.md),项目、音频及命令读 [本机制作流程](references/runtime.md)。需要理解已认可的画面取舍时看[勾股定理样例](references/approved-pythagorean.md)。
## 跨 Agent 使用
这是标准 `SKILL.md` 技能包,正文、分镜和脚本不依赖某个 Agent 的专有指令。先以当前实际加载的 `SKILL.md` 所在目录解析 `references/` 与 `scripts/`;`agents/openai.yaml` 只是可选界面元数据。视频流程中的文字稿与分镜阶段可单独交付;配音与出片需要本机视频仓库、依赖及用户配置的音色,不能把“已发现 Skill”说成“已具备全部出片环境”。
公开发行目录是`skills/one-minute-remotion/`,配套工具在同仓库`video/shared/`。先运行`scripts/locate_workspace.py`定位发行仓库,不依赖作者电脑、其他私有仓库或另一个已安装Skill。继续前读取项目源稿、`spoken.txt`、锁文件、分镜和进度,避免重复生成音频。
## 制作流程
固定顺序:**保存文字稿 → 生成配音并实测时长 → 按实际音频设计分镜 → 制作 Remotion 动画与字幕 → 预览并导出 MP4**。
1. **保存并固定文字**。文字稿统一保存到 `one-minute/<topic>.md`,例如 `one-minute/rrf.md`;新建稿件与外部导入稿件都使用这一入口。按 [写稿风格](references/narration.md) 写或润色,明确本条唯一知识点、观众已知什么、贯穿的一个例子与需要说清的边界。项目中保留源稿快照、纯口播 `spoken.txt` 和 `narration-lock.json`,锁文件的源路径指向统一目录中的文字稿。Markdown 只做明确的口播提取;不猜测代码块、表格或图片中的文字要不要念,不擅自删字。同名文件先读现状,保留用户已有改动。
2. **生成配音并实测时长**。继承原项目音色和语速,按完整意群制作 beats;字幕 `text` 保留原文,`ttsText` 只处理明确读法。先查 RRF、RAG、ReAct 等缩写的现有读音规则,不假定都按同一方式念;数学字母按英文读音处理,不能把中文谐音当作发音验收。用户要求先试听某个读法时,按[短样本与局部替换](references/runtime.md#读音短样本与局部替换)生成并停下,确认后才替换完整意群。沿用旧工具生成完整音频、时间轴和对齐,核对漏字、重复及术语读音。超过2分钟只记录实测时长和超出秒数,保留全文、音频及语速;不建议或执行为赶时长而精简文稿。单阶段模式交付试听后停下。
3. **设计分镜**。先按 [动画方法](references/motion.md) 选择并锁定具体语法、色板、主体及对应的上游函数或渲染模块,写明对象怎样发生变化、为何需要运镜和最终的可见结果。按其中的[关系成组与状态表达](references/motion.md#关系成组与状态表达)组织主体、公式、参数及例外分支,避免零散堆放元素。按实际配音写 `OUTLINE.md`:每个叙事单元记录对应原文、对象、动作、前后状态、短屏幕文字、语音锚点、无声可见的结果及教学假设,不按自然段平均切镜。单阶段模式交付分镜后停下,不实现动画。
4. **制作动画、字幕与预览**。按 [画面接入](references/huashu-runtime.md) 安装并实际调用上游库,先实现最重要的一个因果过程,检查起始、中间和落定帧,再沿同一画风完成其余画面。先做出对象形变或物体动作,最后才补标签和字幕;不先搭满屏卡片再用淡入淡出充当动画。最终音频决定镜头边界;动作跟着相关词发生,动作完成后给理解和读数的停留。关键帧只用于版式辅助检查,不能代替动态预览。必须复用本项目已就绪的 Remotion Studio,或按本机流程用独立后台会话启动、写日志并记录PID,通过端口和HTTP响应确认就绪;不等待常驻服务命令退出,不把启动命令接到 `head` 管道。随后在用户可访问的浏览器打开实际URL,选择完整 Composition,检查播放时间与画面推进、音轨及字幕后,交付可播放链接和预览状态,保留服务供用户查看,再结束本轮。修音频后重新对齐和排时,旧时间轴作废;不修改 `build/` 生成文件。“不导出最终MP4”只限制第五阶段的正式出片,不限制本阶段启动Studio或生成预览视频。只有截图时不能将④标记完成;预览启动失败应报告具体错误与未完成项,不能以关键帧冒充。
5. **出片与验收**。用户推进到本阶段、明确要求导出或授权连续出片时,修完预览问题后按现有工具导出含所选音色旁白的MP4。运行共享 `verify_export.py`,再运行本 Skill 的 `scripts/one_minute.py check`。检查整条正常速度播放、完整解码、字幕及声音;按上游要求由未参与制作的 Agent 独立审片,记录时间码和可见问题。自动指标不能证明听感和教学效果。
## 最后检查
- 去掉声音后,能看到知识点里的因果过程:图形怎样拼接变形、物体怎样受力运动、粒子怎样反应,或查询怎样找到材料、两份排名怎样合并;只有卡片换页和文字淡入需要重做。
- 对象的颜色、身份、位置关系跨镜头稳定;内容看清后再切走;旁白没有提前说出尚未出现的结果。
- 输入、运算、结果与参数有清楚的成组关系;未命中等状态仍保留对象身份,状态标签不替代对象。分组括号开口朝对象、范围准确;起始、中间、落定帧和相邻转场均无穿越、遮挡或误分组。
- 全片逐场检查字幕与主画面:重复问句、解释、结论及其近义改写删除,保留对象名、公式、数值和短状态;删除后调整主体居中与空间,避免保留空标题位。底部字幕安全区始终留出,镜头推拉也不侵入。
- 在约390px信息流宽度及740px手机横屏宽度检查缩图,按实际比例核对完整标签框(含内边距、描边、阴影)、公式上标和最长字幕;主体含阴影及标签与字幕通常留48–64px。缩图辅助判断,仍需正常速度播放。把检查结果记入项目 `review.json`,不把样例的抽帧数量或时间码变成每条片的硬门槛。
- 教学假设、示例数值、简化模型明确标识,不包装成真实实验或真实模型执行。几何图形按真实比例绘制,标注的长度、面积与图形一致。RRF 名次从1开始、缺失项贡献0、排序用未四舍五入的分数;画面、字幕与旁白中出现的同一数据保持一致。
- 音色与语速没有被替换,文字稿、配音和字幕完整一致;总时长包含全部片头片尾,超过2分钟如实报告,不以缺字少字换取达标。
阶段交付只提供该阶段的实际产物、检查结果和下一阶段说明,然后停下。最终出片阶段才提供MP4、源稿与正常可复用的项目路径,简要说明实测时长及未解决项。用户只要Skill时只交付Skill,不顺便做一条样片。不自动提交、推送或发布。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |