职业院校专业课授课计划与教案生成
概述
本技能面向职业院校专业教师，将「学期授课计划」与「分课次教案」的设计流程固化为可复用的工作流，并借助 python-docx 脚本按学校模板批量生成 .docx。核心产出物：
- 授课计划：学期整体安排（教学目标、章节内容、学时分配、进度表）。
- 教案：每次课一份，含「课前—课中五环—课后」完整过程设计。
全部脚本与示例均脱敏：学校名称、教师姓名、班级、车型、校本考核细目、具体日期均以【占位符】表示，使用者按本校实际替换即可。模板结构（单元格索引）默认以【学校名称】专业课模板为准，换模板时需按 references/docx_tricks.md 重新映射单元格。
何时使用
当用户提出以下需求时触发本技能：
- “按模板生成《XXX》课程的授课计划”
- “批量出这学期的教案，每周一次课”
- “按上海教案规范（一线三段五环）写专业课教案”
- “把教材目录排进授课计划，对接校本考核细目”
- 需要提供授课计划模板 .docx 与教案模板 .docx 两个输入文件
工作流（四阶段）
> 严格按顺序执行；每阶段产出经用户确认后再进入下一阶段。
阶段 1 · 学习授课计划模板
- 用
Read读取用户提供的「授课计划模板.docx」，用python-docx解析其表格结构（表0 封面/说明，表1 进度表），记录需填充的单元格索引。 - 向用户确认模板结构与字段含义，确保脚本填充位置准确。
阶段 2 · 排定授课计划
- 获取并研读：人才培养方案、教材目录、校本考核细目（如【学校】版汽车维修工技能操作考核“项目1 汽车维护”细目）。
- 与用户讨论学情与范围：确定哪些教材/考核项目纳入、哪些非考证内容剔除、实训设备是否具备。
- 依据校历推算周次与授课日期（注意法定调休、停课考周、随堂考周）。
- 用
scripts/gen_plan.py生成授课计划，关键规范： - 教学目标/章节单元格解除固定行高（
relax_row_height，exact→atLeast），避免文字被裁切。 - 字号压缩（小五/六号）以收回版面，关闭“文档网格”对齐（
snapToGrid=0）。 - 弱化等级工表述：社会化第三方考核非教育系统标准，统一按常规课程内容表达（如“能检查调整离合器踏板自由行程”而非“对应考核细目1.2.1”）。
阶段 3 · 学习教案模板
- 用
Read读取「教案模板.docx」，解析表0（信息表：课次/课时/班级/周次/日期/课程/课题/教材/地点/学情/教材/三维目标/重难点/方法/环境/数字化）与表1（教学过程表：课前→五环→课后）。 - 与用户确认教学流程与环节命名（环节用实际名称，非“环节一/二”）。
阶段 4 · 逐份出教案
- 按授课计划逐课次生成，每份一份。每份结构：
- 表0 信息表按
set_cell填充（长文本单元格关闭网格对齐）。 - 表1 教学过程表：课前自学(1行) → 第一至五环(5行，必要时
add_middle_rows扩展) → 课后作业/反思(2行)。 - 五环固定为：安全教育(0.5) → 工艺学习(1.5) → 实操训练(2.5) → 工单评价(0.5) → 测验小结(1)（单位：课时，可按课型微调）。
- 教学流程文字图（一线三段五环）写入「教学方法」栏。
- 设计意图与步骤一一对应（每个环节列“步骤+意图”）。
- 用 Word COM 转 PDF 校验每份 5 页（初稿偏长时压缩学情/教材分析或缩小字号）。
核心规范清单（必读 references/conventions.md）
- 上海教案“一线三段五环”模式；动词规范“能/会+行为+条件+标准+结果”。
- 三维目标（知识/技能/素养）以任务为载体，课程思政有机融入。
- 过程性评价 + 数字技术（如学习通 APP）辅助。
- 弱化等级工表述；教材分析锚定【校本考核细目】而非等级工。
- 文字流程图置于「教学方法」栏；设计意图对应步骤。
- 5 页版式约束与 docx 修复技巧见
references/docx_tricks.md。
资源
scripts/gen_plan.py：授课计划生成器（参数化、脱敏，含relax_row_height/ 行高修复）。scripts/gen_jiaoan.py：分课次教案生成器（参数化、脱敏，含set_cell网格对齐关闭 /add_middle_rows）。references/conventions.md：规范清单与填写要点。references/docx_tricks.md：python-docx 关键技术（snapToGrid、行高、页数校验、脚本环境）。references/workflow.md：四阶段流程详解与决策要点（学情讨论、周次推算、非新授课处理）。
使用提示
- 脚本中的单元格索引已集中到
scripts/gen_plan.py的PLAN_MAP与scripts/gen_jiaoan.py的JIAOAN_MAP/JIAOAN_MAP_T2，默认值为【学校名称】专业课模板结构。换模板时只需修改这些映射，无需改动填充逻辑；也可运行python scripts/scan_template.py 你的模板.docx自动探测表头并辅助生成映射（详见references/docx_tricks.md）。 - 生成的
.docx不含任何真实校名/人名/车型，全部为【占位符】，使用者按本校实际填充 CONFIG 与 LESSONS。 - 运行环境：需
python-docx；用隔离 venv（见references/docx_tricks.md）。转 PDF 校验仅 Windows（Word COM）。
