weinaike maic-course —— OpenMAIC 课程创作 skill
把"课程"当作一个源码项目（人擅长改的大纲与讲稿 + agent 生成的画布 JSON），
编译产出平台可导入的 .maic.zip。四个功能模块（大纲 / 内容 / 语音 / 编辑）+ 贯穿的
编译-校验-打包管线。自动执行时每个生成环节后必须跑对应审查（规程见 review-checklists.md
与各 workflow-*.md；全自动串联见 workflow-auto.md）。
快速路由
| 用户意图 | 动作 |
|---|---|
| 全自动出课（brief 进 zip 出） | workflow-auto：init → 大纲+审查 → 生成+审查 → 语音 → 全课终审 → build → 报告 |
| 新建课程 / 从 brief 出大纲 | workflow-outline：interview 或 brief → outline.md → lint → 大纲审查闭环 → 门1 冻结 |
| 解包课程后补大纲 | node scripts/outline.mjs sync <dir> → 充实 → lint → 审查 |
| 审查 / 复审 | node scripts/review.mjs …（规程见 review-checklists.md） |
| 逐页生成课件与讲稿 | workflow-generate：scaffold → 逐节生成（配方库+normalize+check）→ 内容/规范审查闭环 → 门2 预览抽检 |
| 离线预览 / 审片 | node scripts/preview.mjs <dir> → 单页翻页审片台（连播模式顺序播讲稿、画布 spotlight 同步高亮、自动翻页） |
| 把课程翻译成另一语言 | workflow-translate：translate init（派生课程，结构冻结）→ 术语表 → 并行 maic-translator → verify（结构/残留）→ translation 审查 → 目标语配音出包 |
| 翻译审查 | scope=translation（T1-T5，对照源课程，必派 maic-reviewer） |
| 给讲稿配音 | workflow-voice：doctor → 门3 讲稿终审 → dry-run 成本清单 → 增量合成 → prune → 审片 |
| 改课程（任何措辞/顺序/版式/音色/配色） | workflow-edit：指令路由表 → 只改源 → edit.mjs status 级联收敛 → 全课终审 |
| 解包已有 .maic.zip 继续编辑 | node scripts/unpack.mjs <zip> <dir> |
| 出包 / 交付 | node scripts/build.mjs <dir>（内置 check error 门禁 + review blocker 门禁） |
命令（scripts/，零依赖 node ≥ 20）
node scripts/setup.mjs # 同步 @openmaic/dsl dist 到 vendor/ + 环境体检（首次必跑）
node scripts/setup.mjs --check # skill 完整性自检（SKILL·文档·脚本·dsl 四层）
node scripts/init.mjs <dir> --name 课程名 [--audience …] # 新课程脚手架
node scripts/unpack.mjs <a.maic.zip> <courseDir> [--force]
node scripts/outline.mjs lint|sync <courseDir> # 大纲结构校验 / 从场景反推大纲
node scripts/generate.mjs scaffold <courseDir> [--scenes 3-5] # 从大纲生成场景骨架
node scripts/generate.mjs normalize <scene.md>… # 生成画布补 DSL 默认值（只对生成场景用）
node scripts/review.mjs init|validate|verdict … # 审查 findings（blocker 门禁）
node scripts/compile.mjs <courseDir> [--stdout] # 源 → manifest（确定性、无损）
node scripts/check.mjs <courseDir> # 三层校验：DSL 契约 / 文档 lint / 导入模拟（error 时 exit 1）
node scripts/preview.mjs <courseDir> # 离线审片台（翻页+连播：←/→ 翻页、Space 连播、spotlight 同步高亮）
node scripts/tts.mjs doctor|verify|prune … # 连通检查 / 讲稿↔音频同步校验 / 死音频清理
node scripts/tts.mjs <courseDir> [--dry-run] [--force] [--scenes 3-5] # 增量 TTS 合成
node scripts/edit.mjs status|move|delete|insert|theme|voice … # 编辑操作 + 级联看板
node scripts/translate.mjs init|verify … # 课程翻译：派生初始化 / 结构一致性+残留校验
node scripts/build.mjs <courseDir> # compile + check/review 门禁 + zip(store) → build/<name>.maic.zip
工作目录即课程项目；产物永远在 <courseDir>/build/，不要手改产物。
必读 references（按任务加载，不要一次全读）
references/scene-source-spec.md—— 源格式全契约（编辑任何课程文件前必读）references/maic-format.md—— .maic.zip manifest 契约 + 平台导入器真实验收逻辑references/dsl-cheatsheet.md—— 画布元素 / 动作类型 / 主题 / 白名单（生成画布前必读）references/interactive-spec.md—— 交互页契约：消息协议 / 视口 / 沙箱 / 导出冻结（生成 interactive 场景前必读）references/workflow-outline.md—— 大纲模块流程（做大纲前必读）references/workflow-generate.md—— 生成模块流程（生成场景前必读）references/layout-patterns.md—— 版式配方库，校准坐标（写画布时必读）references/review-checklists.md—— 审查框架规则 + 五域清单 O/C/S/T/I（任何审查前必读）references/workflow-voice.md—— 语音模块流程 + 密钥/音色参考（配音前必读）references/workflow-edit.md—— 编辑模块：指令路由表 + 级联收敛 + 全课终审（任何编辑前必读）references/workflow-auto.md—— 全自动模式流水线 + 停止红线 + 报告模板（自动出课前必读）references/workflow-translate.md—— 翻译模块：派生课程/术语表/译者派发/审查与配音（翻译前必读）references/translation-style.md—— 翻译风格契约：反翻译腔清单/生态惯用表述/盲读与回译规程（译者与翻译审查必读）references/agents.md—— 上下文隔离派发配置：导演-演员分工矩阵 + 三个 sub agent 提示词模板（批量生成/审查前必读）
环境变量（语音模块，M4；豆包首发、可替换）
MAIC_TTS_PROVIDER=doubao # doubao | openai-compatible | edge | platform
MAIC_TTS_API_KEY= # 豆包：Agent Plan key（ark-…）或 "appId:accessKey"
MAIC_TTS_BASE_URL= # 可选端点覆盖
MAIC_TTS_VOICE= # 音色，如 zh_male_liufei_uranus_bigtts
MAIC_TTS_SPEED=1.0
MAIC_TTS_MODEL= # openai-compatible 专用
连接信息只在 env；course.yaml 只存非密钥偏好（默认音色名等）。
硬性规则
- 编辑永远作用于源文件（scenes/*.md、course.yaml），改完必须
check；讲稿文本变了 ⇒ 受影响音频自动失配（键 = hash(text|voice|speed)）——用tts.mjs verify <dir>校验三态（一致/失配/死音频），已配音课程失配时 build 会硬拒绝，重跑tts.mjs <dir>+prune收敛。 build的 error 门禁不可绕过；warnings 需在报告里向用户明示。- 画布 text 元素 content 只用白名单 HTML（p/span/br/b/strong/i/em/u/a + 限定 style 属性）。
- 场景顺序 = 文件名数字前缀；重排序 = 改名。
- 自动模式（用户说全自动/不要问我）下，每个生成环节后仍必须执行对应审查并自动修复（≤2 轮），审查报告落
build/review/，未解决的 blocker 必须停下升级给人。 - 派发纪律（见 references/agents.md）：≥3 节批量生成或自动模式，生成派
maic-scene-generator（风格锚点+批后承接缝合+git 写面校验）；审查永远派maic-reviewer（工具面只读——机制保证隔离，同上下文自审无效）；修复派maic-fixer。三个注册类型装于.claude/agents/（软链，见 agents.md 安装节），未注册环境退回内联模板。跨任务状态只走文件，派发前确认用户口头偏好已落盘。