逐字稿转分节授课提示词

将原始课程资料转为可运行的分节 MarkdownFlow 授课脚本。

输出边界

• 生成结果从“正式授课引导”开始。
• 不在最终授课文件写“制作规范/语法说明/执行说明”。
• 这些说明统一放到 skill 与 references。

执行流程

1. 读取输入资料并规范顺序。
2. 调用 mdf-material-adapter 做清洗与语义分段。
3. 生成课节切分候选，并保证单节单核心问题。
4. 调用 mdf-teaching-script-generator 生成逐节 MDF（强制应用可迁移教学骨架）。
5. 汇总课节索引与变量总表。
6. 执行强制门控，仅重算失败课节。

输入合同

至少满足以下之一：

• 单份长逐字稿或课程文档。
• 多份同主题文档，并提供顺序。

可选约束：

• 目标学员画像。
• 课节粒度（short、medium、long）。
• 术语/语气/措辞保留要求。

详见 references/input-contract.md。

输出合同

输出内容：

• 分节 MDF 文件（每节一份）。
• 课程索引（lesson id、标题、核心问题、源片段映射）。
• 全局变量总表（定义、用途、跨节引用）。

详见 references/output-contract.md。

强制门控

必须全部通过：

• 代码块逐字符保留。
• 图片链接与相对位置保留。
• 单节只解决一个核心问题。
• 每节至少一个合法 MDF 交互，且单节互动总数 <= 5。
• 每节包含最小教学闭环：引导、讲解、交互、总结。
• 每节采用“用户直达”授课语句，不输出流程旁白。
• 每节至少包含一个“认知深化互动”（观点澄清/边界校准/反直觉提示）。
• 行动型任务符合通用约束：当下可启动或明确后续模块联动。
• 变量命名一致且可追踪。
• 禁止未采集/未注入变量在正文占位输出（unknown 风险）。
• 不把整节内容包进 === === 固定块。
• 固定输出只用于“必须原样输出”的题目/规则/概念，禁止包裹需要模型演绎执行的段落。
• 知识段落之间使用 --- 保持讲述节奏。
• 每次变量采集后必须有即时反馈并影响后续内容。
• 互动选项必须使用完整文本，禁止 A/B/C 代指选项值。
• 每个互动后必须回显变量（如 用户的选择是{{var}}），并按该值分流反馈。
• 核心知识点必须“图+文”配套：先给可视化任务，再给文字讲解图与机制边界解释，禁止只给图或只给文字。
• 同一知识块图像编排避免重复：建议“1张生成图 + 1张原始图”互补展示。
• 互动分布受控：单次连续采集不超过 3 个变量；单节互动总数不超过 5。
• 课程级变量去重：同一门课内禁止重复采集同一变量；如需复采，必须明确“前后对比/阶段演进”目的。
• 变量使用安全：未采集变量不得提前出现；已采集变量可在后续章节直接复用。
• 教学表达必须面向用户：禁止在授课正文出现“全局变量/原文口径/收集变量/映射说明”等元约束词。
• 互动题干必须具体：禁止抽象提问（如“澄清观点”）；必须写成可直接对话的问题句。
• 结构灵活：按内容选择讲解结构，禁止机械套模板；信息密度不得低于源资料关键要点密度。
• 语义去重审计：除变量名去重外，还要检查“同义互动问题”是否跨章节重复；若保留，必须标注“前后对照/阶段演进”目的。
• 观点题分流：*_viewpoint_check 类互动禁止使用统一模板回复，必须按选项分叉反馈并落到下一步动作。
• 互动有效性审计：每个互动变量都要在本节后文产生可见作用（分流、建议差异、交付物差异），不可只做记录。
• 交付前必须进行 MDF 语法校验；发现语法错误视为重大失误，禁止输出。
• 所有改动需写入独立变更日志文档，不得写入授课提示词正文。

详见 references/preservation-rules.md、references/markdownflow-spec.md。

MarkdownFlow 语法规范（必须遵守）

1. 变量：

• 用 {{var_name}} 引用变量；
• 变量名不可含空格；
• 未赋值变量默认 "UNKNOWN"。

2. 交互：

• 单选：?[%{{var}} 选项A | 选项B | 选项C]
• 多选：?[%{{var}} 选项A || 选项B || 选项C]
• 输入：?[%{{var}} ... 请输入]
• 按钮+输入：?[%{{var}} 选项A | 选项B | ...其他，请填写]

3. 分镜：

• 用 --- 分隔模块；
• 每个模块只完成一个明确目标。

4. 确定性输出：

• 单行固定文本：===固定文本===
• 多行固定文本围栏：

!===
第1行
第2行
!===

5. 普通内容写作原则：

• 普通内容是“给AI的创作指令”，不是直接给读者的成文；
• 禁止直接输出整篇文章正文，应指导AI生成正文。

回溯规则

• 仅重算受影响课节。
• 共享变量变更时，重算其依赖课节。
• 源内容顺序全局变化时，才允许整课重算。

失败处理

当资料质量较差时：

• 先输出粗粒度课节版本。
• 显式标注不确定片段。
• 按最佳可行方案继续生成，不中断流程。