学页｜录播课章节化管理器

概述

学页｜录播课章节化管理器是一款面向 K12 教培机构录播课制作团队的课程结构化设计技能。团队只需提供课程定位（或已有视频素材清单），即可获得一套"章-节-课"三级编号完整、颗粒度合规、命名规范统一的章节化课程结构，解决录播课制作中的四大痛点：

1. 课程目录随意——视频按日期或讲师习惯命名，学员找不到体系感，完课率低
2. 颗粒度失控——40 分钟"大杂烩"视频一口气讲五个知识点，学员无法按需回看
3. 录制返工频繁——录完才发现章节遗漏或内容重复，补录与剪辑成本高
4. 上架目录混乱——平台目录命名与内部管理表不一致，运营对不上账

本技能内置 4 种章节结构模型（同步进阶型/能力模块型/考点冲刺型/兴趣探究型）与学段化课时颗粒度规范，支持"录制前规划"与"已有素材整理"双模式作业，让一盘散沙的视频素材变成结构清晰、可直接上架的章节化课程。

触发场景

以下情况触发本技能：

• 直接关键词：录播课、章节化管理、课程目录、课时拆分、录制规划、视频课程整理、课程上架、章节结构、章节设计、课程颗粒度
• 语境触发：用户描述录播课结构需求（如"下学期要录一套初二物理全年录播课""手上有60多个视频要整理成课程上架"）
• 材料触发：用户上传视频清单（.xlsx/.csv）、课程大纲（.docx）、教材目录页照片，要求梳理章节结构
• 组合触发：用户已用 xueye-curriculum-builder 搭建课程体系，要求将某个课程线细化为可录制的章节结构

不触发的场景：搭建整个课程体系/课程地图（用 xueye-curriculum-builder）、直播课排期（属教务排课场景）、单课时的教学设计（用 xueye-lesson-prep）。

与其他学页技能的关系：
- xueye-curriculum-builder（课程体系搭建）→ 体系层工具，定义"有哪些课程线"；本技能（单课层工具）把某条课程线细化为"可录制的章节结构"
- xueye-lesson-prep（AI备课）→ 本技能产出录制清单后，单课时的教案/课件制作可用其完成
- xueye-quiz-generator（课堂互动题目生成器）→ 录播课内嵌互动题（暂停提问）可复用其题型库

交付物一览

工作流程

章节化管理遵循五步标准化工作流。按顺序执行，每一步的输出作为下一步的输入。

Step 1: 需求采集与模式判别

先判别作业模式，再采集要素。如信息不完整，提问补充。

模式判别规则：

需采集的要素：

采集规则：
1. 最多提问 3 个问题，一轮问完，禁止多轮追问
2. 只问缺失的必填项；用户已表达的信息不重复问
3. 整理模式下先读素材清单（提取已有命名、时长、主题），减少提问
4. 非必填项未提供时使用默认值，不提问
5. 信息齐全时直接进入 Step 2，无需确认

Step 2: 章节蓝图设计

基于采集的信息，设计课程的章节骨架。

加载参考文档： references/chapter-structure-models.md — 章节结构模型库

蓝图设计步骤：

1. 选定结构模型：按课程类型匹配默认模型，用户有偏好时尊重偏好

2. 知识体系拆解（规划模式）：依据课标与教材目录，列出知识点全景 → 按"一个课时只讲一个核心知识点"原则初步圈定课时边界
3. 素材聚类归章（整理模式）：读取素材清单 → 按主题相似度聚类 → 识别"知识孤儿"（无法归类的素材）与"重复素材"（同知识点多版本），列入待处理清单交用户决策
4. 章节颗粒度校验：每章 3-8 节、每节 2-6 课；超范围时拆章或并节，并在蓝图中说明理由
5. 难度节奏曲线：章内课时遵循"基础→进阶→挑战"排序；全课难度配比参考——同步课 基础60%/进阶30%/挑战10%，培优课 基础30%/进阶45%/挑战25%，复习课 基础40%/进阶40%/挑战20%

Step 3: 课时结构化

将蓝图细化为逐课时记录，每课必须包含完整要素。

加载参考文档： references/naming-conventions.md — 命名规范与目录模板

课时七要素：

编号规则：
1. 章编号 Ch{两位序号}（Ch01、Ch02…），节编号 {章编号}-S{两位序号}，课时编号 L{三位全局序号}（L001、L002…跨章连续）
2. 删除/合并课时后必须重排编号，禁止跳号与重号
3. 整理模式下编号重新分配，并在总表"备注"列保留原文件名溯源

命名规则：
1. 课时名 ≤20 字，知识点前置、修饰后置
2. 同一节内课时名结构保持一致（如统一"（XX精讲）"后缀）
3. 上架目录名与内部管理名统一，避免两套命名

Step 4: 结构质量审查

对照规范逐项审查 course.json 草稿，输出审查结论。

加载参考文档： references/metadata-schema.md — course.json 字段字典

审查清单：
1. 结构完整性：三级编号齐全、章节目标准确概括内容
2. 颗粒度合规：单课时长在学段区间内；超时长知识点标记"建议拆分"方案
3. 难度曲线：不存在连续 3 课以上同难度"平坡"，也不存在"基础→挑战"陡跳
4. 覆盖完整（规划模式）：对照课标知识点清单查漏；缺漏点生成"补充课时"建议
5. 冗余检测（整理模式）：同知识点多课时标注并给出合并/保留建议
6. 上下衔接：章首设导学课、章尾设复习课的结构加分项检查

Step 5: 成果生成与交付

将章节化成果转化为三份文件交付。

实现方式： 运行本技能脚本产出 .xlsx 与 .md，再调用 tencent-docx 将 .md 排版为 .docx

文件生成顺序：
1. 先写 course.json（机器可读源）
2. 运行 scripts/course_validator.py course.json 校验，错误清零（warning 逐条评估）后进入下一步
3. 运行 scripts/course_export.py course.json --outdir ./output 产出课时总表 .xlsx 与手册 .md
4. 调用 tencent-docx 将 .md 转为 .docx 章节化管理手册
5. 调用 present_files 统一交付

文件命名： {学科}_{年级}_{课程名}_章节管理手册.docx / _课时总表.xlsx

交付后提示：
- 告知制作团队文件位置，可预览/下载
- 提示"course.json 可作为录制排期与上架配置的结构化输入"
- 整理模式交付时，附"素材待处理清单"（知识孤儿/重复素材）供人工决策
- 提示教研负责人审核章节颗粒度与难度曲线后再开录，避免批量返工

参考文档索引

以下参考文档按需加载，不必一次性全部读取：

工具脚本

课程结构校验用法：

python scripts/course_validator.py course.json
python scripts/course_validator.py course.json --json

课程结构导出用法：

python scripts/course_export.py course.json --outdir ./output

依赖的 WorkBuddy 内置技能

重要约束

1. 教育专业性：章节划分必须基于课标与教材知识体系，不得凭空造章；难度配比与课程类型必须一致。
2. 颗粒度纪律：一个课时只承载一个核心知识点；超时长内容必须给出拆分方案，禁止"大杂烩"课时。
3. 编号刚性：三级编号是course.json 的主键体系，任何结构变更后必须重跑校验器，禁止跳号、重号。
4. 整理模式忠实原则：已有素材的主题、讲师口癖、版本差异需如实记录，归章建议标注置信度，存疑项交用户决策，不擅自删除素材。
5. 上架一致性：对外目录命名与内部管理命名必须同源（均出自 course.json），杜绝两套账。
6. 团队协作：AI 生成的是章节化结构方案，最终开录决策权归教研负责人；交付时须提示审核确认。