下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/indiv-yudabao--lesson-plan-zh.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @indiv-yudabao/lesson-plan-zh。lesson-plan-zh 教案模板通用识别与填充 简介 这是一个 WorkBuddy 技能(Skill),用于自动化生成教案 Word 文档。 核心能力 – 通用模板识别:自动识别任意教案模板结构(课题、教学目标、重点难点等),支持不同老师提供的不同格式模板 – 智能内容填充:从教学计划表和PPT课件中提取内容,按识别结果精准填入模板 – 绝不修改模板:只往值单元格写内容,不动标签、表格结构、边框格式 – 批量生成合并:支持多周教案一次性生成并合并为一份完整文档 适用场景 – ✅ 中小学/中职/高职教师批量生成教案 – ✅ 根据教学计划表自动填写每周教案内容 – ✅ 从PPT课件提取教学过程和图片嵌入教案 – ✅ 不同学校、不同格式的教案模板通用 核心原则 绝不修改模板 —— 只向值单元格写入内容,禁止硬编码行列索引
阅读全文 (展开查看完整说明)
概述
教案模板通用识别与填充
根据教案模板(Word 表格)和教学资料(教学计划表、PPT 课件),自动识别模板结构并生成图文并茂的教案文档。
核心原则:绝不修改模板。 只向值单元格写入内容,不动标签单元格、表格结构、边框格式。不同老师提供的模板结构不同,必须按识别结果精准定位,禁止硬编码行列索引。
工作流程总览
阶段一 ─ 引导与准备(老师提供建材 → agent 检查文件夹)
↓
阶段二 ─ 模板识别(自动识别 → agent 向老师确认字段映射)
↓
阶段三 ─ 试生成(仅生成第 1 课时 → 老师验收反馈)
↓
阶段四 ─ 批量生成(验收通过后生成全部 → 合并输出)阶段一:引导与准备
1.1 收集基本信息
启动时,先向老师确认以下信息(缺一不可):
| 信息项 | 说明 | 示例 |
|---|---|---|
| 学段 | 小学/初中/高中/中职/高职 | 中职 |
| 学科 | 课程名称 | 电子CAD |
| 学期 | 学年 + 学期 | 2025-2026 第二学期 |
| 课时总数 | 本学期共几课时 | 18 |
使用 AskUserQuestion 工具收集,不要自行假设。
1.2 约定文件夹结构
告诉老师将以下三类文件放在同一个文件夹中:
教案工作文件夹/
├── 教案模板.docx ← 必须:含教案表格的 Word 文档
├── 教学计划.doc/.docx ← 必须:含每周授课安排的文档或表格
├── 第1周.ppt/.pptx ← 可选:课件
├── 第2周.ppt/.pptx ← 可选:课件
├── 素材/ ← 可选:图片/视频/音频等
│ ├── 示例1.png
│ └── 演示.mp4
└── ...关键要求:
- 教案模板:Word 文档(.docx),内含教案表格(含"课题""教学目标"等标签字段)
- 教学计划:Word/Excel 文档,列明每周/每课时的教学内容、重难点、作业等
- 课件与素材:PPT、图片、视频等教学资源
1.3 文件夹检查
使用 scripts/template_utils.py 中的工具扫描文件夹,执行检查:
from scripts.template_utils import scan_folder, find_template_candidates
# 1. 扫描分类
files = scan_folder("工作文件夹路径")
# 2. 查找教案模板候选
candidates = find_template_candidates("工作文件夹路径")检查清单与提示规则:
| 检查项 | 条件 | 提示 |
|---|---|---|
| 缺模板 | candidates 为空 | ❌ 未找到教案模板(含"课题"或"教学过程"字段的 .docx 文件)。请将教案模板放入文件夹并告诉我文件名。 |
| 缺计划 | 无 .doc/.docx/.xlsx/.xls 文件(排除模板) | ❌ 未找到教学计划文档。请将教学计划(Word/Excel)放入文件夹。 |
| 多模板 | candidates ≥ 2 个 | ⚠️ 发现多个可能的教案模板,请确认使用哪一个:列出具名。 |
| 无课件 | files['pptx'] 和 files['ppt'] 都为空 | ℹ️ 文件夹中未检测到 PPT 课件。教案中的教学过程配图将无法自动生成,您可以在之后手动补充。 |
| 信息缺失 | 学段/学科/学期未确认 | ❌ 请先告诉我您的学段、学科和学期信息。 |
只有当"必须项"全部就绪后才进入下一阶段。 课件和素材缺失时可继续,但需告知老师。
阶段二:模板识别与确认
2.1 自动识别模板结构
调用 scripts/template_utils.py 中的识别函数:
from scripts.template_utils import detect_template, format_detection, get_main_fields
detection = detect_template("教案模板路径.docx")
print(format_detection(detection)) # 人类可读摘要
fields = get_main_fields(detection) # 主表字段列表识别原理(layout-agnostic):
- 将每个表格转为二维网格(正确处理 gridSpan 横向合并和 vMerge 纵向合并)
- 遍历网格,将文本匹配已知字段关键词的单元格识别为"标签单元格"
- 对每个标签,在同一行中向右扫描,第一个非标签单元格即为"值单元格"
- 已知字段关键词包括:课题、教学目标、教材分析、重点、难点、资源、教学过程、布置作业、板书设计、教学反思,以及科目的元数据字段(科目、班别、任课教师等)
2.2 向老师确认识别结果
将识别结果展示给老师(使用 format_detection 输出),明确告知:
- 识别出了哪些字段
- 每个字段对应的值单元格位置
- 若同一字段有多个出现(如"教学过程"通常占两行),说明如何分配内容
若识别结果明显有误(如误将"周次"识别为"课题"),请老师手动纠正映射关系,agent 据此调整。
确认后方可进入填充阶段。
阶段三:试生成(验证阶段)
3.1 生成第 1 课时教案
先只生成第 1 课时的教案,不批量:
from scripts.template_utils import fill_template, detect_template
detection = detect_template("教案模板路径.docx")
# 为第 1 课时准备内容
contents = {
'课题': '...',
'教学目标': '...',
'重点': '...',
'难点': '...',
'资源': '...',
'教学过程': ['第一部分...', '第二部分...'], # list 对应多行
'布置作业': '...',
'板书设计': '...',
'教学反思': '(课后填写)',
}
fill_template(
"教案模板路径.docx",
contents,
"教案_第1课时_草稿.docx",
image_dir="课件/素材目录" # 可选
)内容来源:
- 从教学计划文档中提取对应周次/课时的教学内容、重难点、作业
- 从 PPT 课件中提取教学过程结构(导入→新知讲授→演示→实操→总结)
- 若 PPT 中有关键截图,可提取为图片嵌入教案(使用 python-pptx)
3.2 验证与反馈
将草稿文件展示给老师,请求确认:
- ✅ 内容是否准确、完整?
- ✅ 排版格式是否符合要求?(标签未改动、表格结构完整)
- ✅ 字体字号是否合适?
若老师要求修改:根据反馈调整内容或参数(font_name / font_size),重新生成,直到满意。
只有老师确认通过后,才进入批量生成。
阶段四:批量生成与合并
4.1 批量生成
from scripts.template_utils import fill_template, combine_documents
weekly_files = []
for week in range(1, total_weeks + 1):
out_path = f"教案_第{week}周.docx"
# 根据教学计划提取该周内容
contents = extract_week_contents(week) # agent 自行组织
fill_template("教案模板路径.docx", contents, out_path, image_dir="素材目录")
weekly_files.append(out_path)
# 合并为一份
combine_documents(weekly_files, "完整教案.docx")
print("合并完成!")4.2 合并文档
combine_documents 功能:
- 以第一份文档为基础,后续每份前插入分页符
- XML 级别复制表格和段落,图片用 blob 哈希去重
- 合并完成后清理临时文件
4.3 元数据表填充(可选)
若模板中存在元数据表(含"科目""班别""任课教师"等字段),可选填:
metadata = {
'科目': '电子CAD',
'班别': '23电子1班',
'任课教师': '张老师',
'周课时': '2',
}
# 在第一次 fill_template 时一并填入,或单独处理元数据表工具脚本参考
scripts/template_utils.py 提供以下函数(使用时先 import):
高层 API
detect_template(path) → dict
# 识别任意教案模板,返回字段→值单元格坐标映射
format_detection(detection) → str
# 将识别结果格式化为人类可读摘要
get_main_fields(detection) → list[str]
# 返回主表的规范字段名列表
fill_template(template_path, contents, output_path, image_dir=None, font_name='宋体', font_size=Pt(10.5), detection=None)
# 按识别结果向模板填入内容,绝不修改模板结构
scan_folder(folder) → dict
# 扫描文件夹,按扩展名分类文件
find_template_candidates(folder) → list[dict]
# 查找含教案字段关键词的 docx 文件
combine_documents(file_list, output_path)
# 合并多份教案为一份,图片去重底层 API
fill_cell(cell, lines, font_name, font_size)
# 填充普通文本单元格(多行)
fill_process_cell(cell, items, font_name, font_size)
# 填充教学过程单元格(文字+图片混合)
# items: list[str | dict],dict 格式 {"type": "image", "file": "path"}
add_image_to_cell(cell, img_path, max_width_cm, max_height_cm)
# 向单元格添加图片,自动缩放命令行调用
python template_utils.py detect <docx_path> # 识别模板
python template_utils.py scan <folder> # 扫描文件夹
python template_utils.py candidates <folder> # 查找模板候选
python template_utils.py fill <template> <contents.json> <output> [--image-dir DIR]依赖
python-docx # 读写 Word
python-pptx # 读取 PPTX(可选,用于提取课件图片)
Pillow # 图片尺寸计算
win32com.client # Windows 下 .ppt → .pptx 转换(可选)注意事项
- 绝不修改模板:只往值单元格写内容,不动标签、结构、边框
- 教学过程多行处理:若模板中"教学过程"占两行,
contents['教学过程']传 list 即可自动分配到各行 - 先验证再批量:必须先生成 1 课时让老师确认,通过后再批量
- 字体默认宋体:可通过 font_name/font_size 参数调整
- 图片来源:从 PPT 中提取的图片需 > 512 bytes 才会嵌入
- 合并去重:多份文档中重复的图片只保留一份