二哥风格 Remotion 视频

本 Skill 只记流程节点和禁令。目录、命令、组件清单和素材清单统一在 共享工作流，维护 Skill 时同步更新该文件并实际跑一遍命令。

定位项目

1. 从仓库根目录定位 docs/src/ai/script/，不把终端 cwd 当作视频项目目录。工具的 --project 传项目目录。
2. 继续旧项目，先运行 doctor.py，看输出里的 progress，再读 script.md、beats.json、OUTLINE.md。没有 progress 的旧项目，以项目文件和用户最新指令判断授权范围。
3. 找不到路径时修正路径，不新增另一套配置、依赖或生成目录。

流程节点

每个节点完成并得到对应的用户回复后，用 progress.py --mark 记录，后续会话据此判断走到了哪一步。

1. 整理用稿。写项目 article.md、script.md、beats.json、OUTLINE.md。文末公众号推广尾段从起点删到文件末尾，连同后面的图片，项目内所有清单同步删除，不留“不使用”的标记。正文里的资料领取（288 道、222）和视频结尾的点赞关注保留。源文章不改。用户要求保留公众号引导时以用户为准。原稿“视频封面”区块里的横版 16:9 封面（两种封面风格，标题分别写“16:9 封面”和“宽屏横版封面”，拿不准时按实际尺寸约 1.78 判断）下载为 assets/images/cover-16x9.png，做整片首帧。原稿常在制作中途才补封面，doctor.py 的 cover 字段和渲染入口每次都会重新读原稿，封面未就绪时拒绝渲染。
2. 用户确认口播稿，标记 script。确认前不合成配音。确认后按稿子制作，不再逐条核实稿子里的技术说法，画面配合稿子讲。制作中发现稿子和现行版本对不上，先告诉用户，由用户决定改不改，不自行展开核查。
3. 配音。先跑 pronunciations.py --write 套用读音词典，再 gen_audio.py、gen_cues.py、review_audio.py。词典的 watch 项和 candidate 规则列入复听清单。标记 audio。
4. 逐章制作。每章先写 ch<N>-spec.json 并生成时点，再写 Chapter<N>.tsx，然后跑 chapter_pipeline.py 出关键帧，并在 Studio 里预览。抽查配图帧、主要场景和转场中间帧，试听提示音。用户回复“继续”或明确认可后标记该章，再做下一章。最后一章同样先给 Chapter<N>Preview，用户认可后再切到整片 Composition 连看。
5. 出片。只有用户明确说“渲染”或“出片”才标记 render 并导出，已经授权过的不重复询问。整片渲染加 --detach，轮询日志等待完成。
6. 成片检查。跑 verify_export.py，核对完整解码、尺寸、帧率、帧数、音频同步和各章截图，通过后标记 verified。交付的是 output/<outputName>，不能把 Studio 预览或旧版称作本次成片。
7. 纳入 Git。output/ 顶层只放最终 MP4，试做放 preview/，旧版放 output/legacy/，细则见 成片版本管理。commit 和 push 只按用户明确指令执行。

禁令

• 密钥只从 config.volc.apiKeyEnv 指定的环境变量读取，不写进项目、Skill、日志或命令参数。
• 不手改 build/ 下的生成文件，不按字数估算时长。配音变化后重新生成时间轴和混音。
• 用户指定音色或语速时只改当前项目配置，用户要求改默认值时才改共享配置，不从历史项目恢复旧音色或旧倍率。
• 已有视频只读自己的 project.json 配置。修改共享默认值、共享组件或读音词典，不批量重做旧视频的配音和成片。
• 配音按确认稿朗读，不自动加语气词、情绪指令或反问。text 是字幕原文，ttsText 只写读法调整。
• ASR 识别正确不等于读音正确。没有实际试听，不宣称读音已验收。用户认可某个词，只代表这一项通过。
• 原稿配图原样展示，不用简化图形替换，也不重新生成。
• 配图要么不加边框，要么边框紧贴图片：带边框时取景框和图片宽高比一致（fitBox），推近时图片也铺满边框，边框里上下左右都不能露出空白。
• 颜色只从共享色板 C 取，自制卡片只用共享 card 或 Card，不在章节里另写配色和卡片样式。
• 录制还原的界面文字、顺序和数字只取自录制和录后实测，没截到的不补。两次录制的结果不拼成一次，另一次会话用对照录制标签单独展示。录制只在临时目录里跑。
• 不伪造品牌标志。具体模型或产品先查共享官方素材库，未收录时先查官网或官方仓库；确实没有可用官方标志时才用通用概念图标并写清名称。
• 具体硬件型号使用官方产品图，标清 SXM、PCIe 等形态；不让通用双风扇显卡冒充 A100/H100。素材与来源见 硬件产品图复用。

音画规则

• 配音单元。beat 按完整句子或自然意群拆分，不为字幕换行另起一段 TTS。一个 beat 里可以切换多组字幕和多个动画时点。用户觉得停顿太多时，合并被拆开的意群重新合成。细节见 音画对齐。
• 读音。先查 读音词典，新发现的误读和用户确认的读法都更新到词典里。用户指定读法时直接采用，全文扫描当前项目；数字与型号保留原意，中文品牌读法只改 ttsText。争议术语先核对作者或官方的一手来源。已有配音的替换、朗读锚点同步和验收范围见 TTS 使用约定。
• 动画时点。元素在术语起音前 4 到 6 帧开始入场，之后稳定显示，不循环脉动。讲同一画面的相邻 beat 共用一个场景，字幕切换不等于切换场景。
• 画面跟着配音走。元素按配音提到的先后入场，没提到的不提前出现。每句话一开口，主体区就要有和这句话相关的内容，不能等到句中的关键词才出现。chapter_pipeline.py 默认给每个 beat 渲染开口帧并报出空画面，警告要处理掉再交给用户。
• 真实录制。稿子讲到 Agent 产品的具体交互（插话、取消、审批、排队）时，可以提议在临时目录里真实跑一次，用 record_tui.py 录屏，再用共享 TuiRecording.tsx 按配音还原。录制、调用 API、翻安装包或源码核对这类实操验证都要先问用户，得到同意再做。题目示意图、过渡画面优先复用本期已有的真实素材（录制画面、原稿截图），没有可用素材才自己画。命令和注意事项见 真实录制演示。
• 原稿配图。在 OUTLINE.md 里把每张图对应到场景和 beat 范围，信息量大的图同时写清聚焦顺序（先全图，再依次聚焦哪几块）。逐章预览时确认图片确实出现且可读。不采用的图要写明原因。
• 提示音。新项目默认开启。只标记少量有意义的变化，比如错误出现、结果返回、资料场景切入，放在短停顿处，音量低于配音。用户说不要时关闭。
• 时长。“3 分钟”按稿子保留，实际时长以配音为准，不为凑时长删内容。

色调与卡片、视觉版式、原稿配图聚焦、字幕分组、人物角色、闯关稿见 用户偏好，Codex 制作视频也读这份文件，入口见 画面规范。稿子里有“面试官问你”、求职者回答或面试追问时，读 面试头像开场。普通科普稿不加面试剧情。

组件和素材

• 先用共享组件：ChapterShell、SceneChain、FigureCard、FigureFocus、HostCard、InterviewStage、Icons，卡内元素用 Cards.tsx。清单见 共享场景组件，新章节从 shared/remotion/examples/Chapter.example.tsx 复制起步，卡片和色调的样张是同目录的 Cards.example.tsx。
• 同一个场景或图标在两期以上重复手写，且不含主题数据时，提升到共享组件并登记。
• 产品图标、Harness 马匹、面试头像、提示音都在 shared/assets/，用前复制到项目 assets/images/，来源记录复制到 assets/references/。Kolibri、GLM/Z.ai、Qwen、Aleph Alpha、Pi 的官方素材已保存，版本标签、背景和蜂鸟横幅视窗见 品牌素材复用。
• 组件代码按 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>

初始化只建草稿骨架，不调用 TTS，不生成成片。DraftPreview 不能当成已经制作的视频。