AI 拆机课 · 系列课工作室

一个主题 → 一整套课：每节 4–7 分钟的讲解视频（1080p MP4）、同源的互动版网页（可暂停、点图看出处）、汇总大纲与视频的课程总页，外加 2–3 分钟的导学视频。

已验证的成品（同一套引擎）：

• 第一季「AI 入门课」12 节（马卡龙/薄荷主题，人物历史 + 概念）
• 第二季「AI 实战课：从提示词到 Codex」13 节（真实终端录屏 + 涂鸦讲解）
• 「WorkBuddy 上手课」25 节 + 导学（Notion 极简手绘风，开源书改编，像素讲解小人）
• 「Claude Code 做视频：Opus 5.5 编排课」导学 + 10 节、「Opus 5.5 宣传片实战课」导学 + 8 节 + 行业加餐（cine 代码成片引擎：每帧代码算出、真片段叠加、一次真实会话贯穿全课）

核心主张（不能丢）

1. 没出处不上屏：数字、功能、步骤、引语都要能追到来源；引用逐字、标章节；推断要说「可能」；示意数据写明「示例数据」。
2. 一源双出：同一份 narration.json + scenes.json 同时出 MP4 和互动版。
3. 由浅入深、一节讲三件事：开头「这一节讲三件事」，中间至少一个「暂停想一想」，结尾回顾导图 + 预告下一节。
4. 先定再做：资料、对象、课时、大纲、音色、画风都先给用户确认，再批量生产。
5. 隐私与版权：截图里的个人信息、二维码、密钥、本机用户名一律裁掉或打码；图标、插画库来源统一在片尾致谢卡标注，书中内容和截图的出处逐处标。

工作区

引擎在本 skill 的 engine/。先建工作区和系列：

python3 ~/.claude/skills/ai-teardown/engine/scripts/new_series.py ~/Desktop/<工作区> <系列名> --style sketch --title "课程名"

• --style sketch：Notion 极简 + 手绘引擎 + 像素讲解小人 + 贴纸风（新课默认，scenes.json 文件头 "sticker": true）（推荐；讲软件、书、开源项目）。
• --style lesson：模板编译器（马卡龙/薄荷/夜间主题，擅长人物、时间线、终端录屏）。
• --style cine：代码成片引擎（暗场「王炸」画面：粒子、3D 镜头、着色器、动态大字；可叠真实成片片段、曲库配乐；只出视频，不出互动版）。讲 AI 编排、动效、做视频这类「片子本身就是作品」的课，或实战课。细节见 references/10-cine.md，实战课做法见 references/11-practice-course.md。
• 已有工作区（原始项目在 ~/Desktop/ai-teardown）直接在里面建系列。
• 课目录必须在工作区之内：<工作区>/examples/<系列>/lessons/<NN>/。

环境依赖和一次性配置见 references/02-pipeline.md 的「环境」一节（MiMo 密钥、whisper 模型、Playwright、Hyperframes、esbuild、配乐库）。

流水线（六段，三个确认点）

批量时用多智能体：每个助手按系列目录里的 BRIEF.md 做一节的「旁白 + 配音 + 编排」（不渲染、不发布、不改引擎代码），主会话负责质检、排渲染、发布。一次开 3 个助手。BRIEF 模板见 references/brief-template.md（cine 系列用 templates/series-cine/BRIEF.md）。

cine 系列的编排和渲染换成：写 lessons/NN/film.js → cine/tools/stills.py 看接触表 → cine/queue.txt + cine/tools/queue.sh（clips → record → finish → deliver），命令见 references/10-cine.md。

常用命令（在工作区根目录跑）

L=examples/<系列>/lessons/NN
python3 scripts/make_lesson.py $L voice > $L/voice.log 2>&1   # 配音 + whisper 对齐 + MiMo 回读
python3 scripts/check_scenes.py $L                              # 场景自检
rm -rf $L/build/stills && python3 scripts/make_lesson.py $L build   # 编排 + 接触表
echo NN >> examples/<系列>/render.queue                         # 排进渲染队列（runner 见 02-pipeline）
python3 scripts/sketch_publish_files.py $L                      # 算互动版要上传的文件
python3 scripts/course_page.py examples/<系列>/series.json examples/<系列>/publish/course

质检门（每节都过）

• voice.log：回读 < 95% 或出现「⚠ 可疑读数」的拍，删 build/audio/<拍>.* 重合成；专名、缩写用 whisper-cli 复听确认。
• 接触表 + 可疑单帧：文字溢出/重叠、圈注对不准、空屏、小人挡字、出处小字被压。
• 成片抽 6 帧拼图再看一遍才发布。
• 清单全文见 references/07-qa-checklist.md；踩过的坑见 references/08-pitfalls.md（改引擎前必读）。

参考文件