二哥风格 Remotion 视频

本 Skill 只记流程节点和禁令。目录、命令、组件清单和素材清单统一在 共享工作流，画面偏好在 用户偏好。

按已有经验直接制作，用户负责审片，提出要调整的地方再改。不额外扩展成逐条审稿；涉及具体公告、报告结论或测试数字的镜头，先找对应的一手证据再制作。交付时只说做了什么、哪里需要用户注意。

定位项目

1. 从仓库根目录定位 docs/src/ai/script/，工具的 --project 传项目目录。
2. 继续旧项目先跑 doctor.py 看 progress，再读 script.md、beats.json、OUTLINE.md。
3. 找不到路径时修正路径，不新增另一套配置、依赖或生成目录。

流程节点

每个节点得到对应的用户回复后，用 progress.py --mark 记录。

1. 整理用稿。写项目 article.md、script.md、beats.json、OUTLINE.md。文末公众号推广尾段连同后面的图片整段删掉，正文里的资料领取（288 道、222）和结尾点赞关注保留，源文章不改。原稿“视频封面”区块里的横版 16:9 封面（标题写“16:9 封面”或“宽屏横版封面”）下载为 assets/images/cover-16x9.png 做整片首帧。
2. 用户确认口播稿，标记 script。确认前不合成配音。确认后按稿子制作，画面配合稿子讲。发现稿子和现行版本对不上，一句话告诉用户，由用户决定改不改。
3. 配音。pronunciations.py --write 套用读音词典，再 gen_audio.py、gen_cues.py、review_audio.py（生成逐词对齐）。标记 audio。
4. 逐章制作。先区分本章的事实证据与原理示意，按下方规则准备素材，并参照用户偏好的场景构思选择表达方式；再写 ch<N>-spec.json、生成时点和 Chapter<N>.tsx，跑 chapter_pipeline.py。工具报出的开口空画面处理掉，然后把 Chapter<N>Preview 交给用户。用户回复“继续”标记该章，再做下一章。
5. 出片。用户说“渲染”或“出片”才标记 render 并导出，整片渲染加 --detach。
6. 成片检查。跑 verify_export.py，通过后标记 verified。交付的是 output/<outputName>。
7. 纳入 Git。output/ 顶层只放最终 MP4，规则见 成片版本管理。commit 和 push 只按用户明确指令执行。

禁令

• 密钥只从 config.volc.apiKeyEnv 指定的环境变量读取，不写进项目、Skill、日志或命令参数。
• 不手改 build/ 下的生成文件，不按字数估算时长。配音变化后重新生成时间轴和混音。
• 用户指定音色或语速只改当前项目配置；修改共享默认值、共享组件或读音词典，不批量重做旧视频。
• 配音按确认稿朗读，不自动加语气词。text 是字幕原文，ttsText 只写读法调整。
• 没有实际试听，不说读音已验收。
• 使用原稿配图时保持原样，不用简化图形替换，也不重新生成；事实镜头优先采用对应的一手素材。带边框时取景框和图片同宽高比（fitBox），边框里不露空白。
• 自制画面的颜色只从共享色板 C 取，卡片只用共享 card 或 Card；真实截图、论文与官方图表保留原色。
• 录制还原的界面文字、顺序和数字只取自录制，没录到的不补，两次录制不拼成一次。录制只在临时目录里跑。
• 录制、调用 API、翻安装包或源码核对这类实操验证，先问用户。需要调 API 时用 DeepSeek，不调用 Anthropic API。
• 不伪造品牌标志和硬件产品图，先用共享素材库，见 品牌素材复用。

事实证据与原理示意

• 讲“官方发布了什么、报告写了什么、测出了多少”时，主动查对应官网、原论文或官方仓库，展示真实网页、原文页段或官方图表；品牌标志、手绘卡片、箭头和大数字不能充当证据。搜索摘要只用于定位，不能当作出处。
• 先让观众辨认来源，再按配音放大关键句或标出图中数据；保留日期、版本、实验条件、“约”“初步结果”和数值区间等限定。画面只加少量中文提示，不把整页小字缩进屏幕。做法见 官方证据素材。
• 解释机制、教学类比和算式时继续用动画；示例概率标明是示意，容量计算标明是估算，不冒充某个模型的真实输出或实测结果。不要把所有原理动画都换成网页截图。
• 找不到支持当前说法的一手证据，或原文与确认稿不一致时，明确告知用户，不用自画图补出“证据”，也不擅改配音。用户明确保留口播时，画面如实展示出处及完整限定，并记录该选择。

音画规则

• 配音单元。beat 按完整句子或自然意群拆分，一个 beat 里可以切换多组字幕和动画。选择题的问句和选项合成一个单元。细节见 音画对齐。
• 读音。先查 读音词典，用户指出的误读和指定的读法直接改并更新词典。方法见 TTS 使用约定。
• 画面跟着配音走。元素按配音提到的先后入场，在术语起音前 4 到 6 帧开始，之后稳定显示。每句话一开口主体区就要有相关内容。讲同一画面的相邻 beat 共用一个场景。
• 段位直接进阶梯。闯关段落从口播开头就显示阶梯与登阶动作，省略头像加旗帜的闯关提示过渡；同一期各段位统一处理，见闯关稿。
• 真实素材优先。讲 Agent 产品的具体交互时，可以提议真实录制（record_tui.py 录屏、TuiRecording.tsx 还原）；题目示意图、过渡画面优先复用本期已有的录制和原稿截图。
• 原稿配图。在 OUTLINE.md 里写清每张图对应的场景、beat 和聚焦顺序。
• 提示音。默认开启，只标少量有意义的变化，音量低于配音。用户说不要时关闭。

稿子里有“面试官问你”或面试追问时，读 面试头像开场。普通科普稿不加面试剧情。

组件和素材

• 先用共享组件，清单见 共享场景组件，新章节从 shared/remotion/examples/Chapter.example.tsx 复制起步。
• 同一个场景或图标两期以上重复手写、且不含主题数据时，提升到共享组件并登记。
• 品牌图标、面试头像、提示音在 shared/assets/，用前复制到项目 assets/images/。
• 组件代码按 JSX 元素换行，单行不超过约 160 个字符，样式常量放在文件顶部。

最短示例

python3 docs/src/ai/script/shared/tools/init_project.py --project docs/src/ai/script/<topic> --source docs/src/ai/video/<topic>.md --title '<标题>'
python3 docs/src/ai/script/shared/tools/doctor.py --project docs/src/ai/script/<topic>