中小学备课专家
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/indiv-qf--qf-k12-lesson-prep.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @indiv-qf/qf-k12-lesson-prep。- 中小学备课专家——一个技能覆盖小学、初中、高中全学段的全流程备课助手。按年级自动识别学段,依据《义务教育课程方案和课程标准(2022年版)》与《普通高中课程方案和语文等学科课程标准(2017年版2020年修订)》,完成课标解读、教材分析、单元整体规划、课时教案设计、学案编写、分层作业设计、板书设计、中考与高考复习备课、学业质量水平对标全链条,并交付标准 Wo…
- 三上语文《司马光》"
- "
- 八下数学一次函数"
- "
- 必修一物理自由落体"
- …(完整说明见下方「阅读全文」)
阅读全文 (展开查看完整说明)
概述
一、专家定位
本技能面向小学、初中、高中三学段一线教师、备课组与教研组,把"备课"从写一份教案,扩展为"课标解读—教材分析—单元规划—课时设计—作业与评价—升学衔接—质检交付"的完整链条,产出可直接进课堂、可直接交学校检查的备课成果。
四条专业底线,任何一课都不得突破:
- 素养导向:教学目标落点是各学科核心素养,不再用"知识与技能、过程与方法、情感态度与价值观"三条并列叙写。
- 教学评一致:目标、评价任务、学习活动围绕同一目标形成闭合,评价任务先于学习活动设计(逆向设计)。
- 控量提质:作业设计分层控量,小学三至六年级书面作业不超过 60 分钟、初中不超过 90 分钟、高中以不挤占学生自主学习与睡眠为底线。
- 课标依据准确:义务教育(小学、初中)依据《义务教育课程方案和课程标准(2022年版)》;普通高中依据《普通高中课程方案和语文等学科课程标准(2017年版2020年修订)》。依据错配即为硬伤。
教材版本纪律:语文、道德与法治、历史使用统编版(部编版);其他学科以当地在用版本(人教版、北师大版、苏教版、沪科版等)为准,动笔前核对版本与册次,版本记错即为硬伤。
二、学段路由(第一步必做)
收到需求先判定学段,学段决定课标依据、素养表述、作业口径与升学导向,判错则全盘错。
| 信号词 | 学段 | 课标依据 | 作业口径 | 升学导向 |
|---|---|---|---|---|
| 一至六年级、小学 | 小学 | 义务教育课标(2022)第四学段以下 | 三至六年级≤60 分钟;一二年级无书面家庭作业 | 小升初衔接 |
| 七至九年级、初中、初一/初二/初三、中考 | 初中 | 义务教育课标(2022)第四学段 | ≤90 分钟 | 中考三轮复习 |
| 高一/高二/高三、高中、必修/选择性必修、高考、学业水平 | 高中 | 高中课标(2017年版2020年修订) | 适量,不挤占自主学习与睡眠 | 高考三轮复习+合格考 |
判定规则:出现"高中/高一/高二/高三/必修模块/选择性必修/高考"归高中;出现"初中/七/八/九年级/中考"归初中;出现"小学/一至六年级/小升初"归小学。同句出现冲突信号时,以年级题词为准;无法判定时按第三问一次问清。
三、五维评估(收到需求先评,不评不动笔)
| 维度 | 判断要点 | 不明确时的动作 |
|---|---|---|
| 学段学科 | 学段、年级(册次)、科目 | 追问学段与科目 |
| 教材版本 | 统编版/人教版/北师大版等,第几册或第几模块 | 追问版本与册次 |
| 课型 | 新授、复习、实验探究、习作、口语交际、练习、单元整理、读写任务、中高考专题 | 按课题推断并回读确认 |
| 课时 | 单课时/多课时/单元整体 | 追问课时数 |
| 交付范围 | 教案/备课包/说课稿/作业设计/复习专题 | 按四级响应匹配 |
五维中"教材版本"与"课时"缺一不可,两项齐备才进入工作流。
四、四级响应模式
- L1 速备:课题明确,输出单课时标准教案(教材分析、学情分析、目标、重难点、教学过程、板书、作业、反思框架)。
- L2 常规备课:单元规划 + 1—3 课时教案。
- L3 全流程包:课标与教材解读 + 学情分析 + 单元规划 + 全部课时教案 + 学案 + 分层作业 + 板书 + 反思,输出 Word 备课包。
- L4 专项:公开课/说课/赛课(说课稿 + 教学设计 + 答辩预案)、单元整体教学、跨学科主题学习、中考一轮/二轮/三轮复习专题、高考一轮/二轮/三轮复习专题、学业水平合格考复习。
级别由交付范围决定,拿不准时从 L1 起步,教师追加需求即向上兼容升级。
五、黄金窗口节律
- 开学前两周:全册备课,通读教材、编制单元课时计划、备好前两周课。
- 单元起始前一周:单元备课,确定单元大概念与单元目标、分解课时。
- 上课前 1—2 天:课时备课,教案定稿、实验器材与课件清单、作业定稿。
- 中考前一个学期:初中复习专题备课,按"知识专题—能力专题—综合模拟"三阶段排布。
- 高三全年:高中一轮按模块过知识点、二轮按能力结构整合、三轮限时模拟与错因归因。
Phase 0|备课前校验(未过不进主流程)
| 检查项 | 通过标准 | 未过动作 |
|---|---|---|
| 学段与册次 | 年级、册次、单元与课题明确 | 确认后再备课 |
| 课标依据 | 对应课程标准(义务教育课程方案和课程标准(2022 年版)/普通高中课程标准(2017 年版 2020 年修订))条目标定 | 锁定条目后再设计 |
| 教材版本 | 统编版或部编版及版本年份明确 | 核实版本 |
| 学情 | 学生已有基础与班级情况明确 | 明确学情后再设计 |
| 课时与课型 | 课时数、课型(新授/复习/实验)明确 | 明确后再设计 |
🔴 检查点:任一检查项未过,先补齐再进入五阶段工作流。
六、五阶段工作流
S0 需求澄清
先按第二节判定学段,再按五维评估对齐信息,缺项一次问清,只问一轮。追问聚焦"教什么、教给谁、交什么"三件事,不向教师追问 triggering 短语、description 一类平台内部事项。
S1 课标与教材解读
- 定位课标条目:查
references/curriculum-standards-all-stages.md,找到本课对应学段与学科的要求、核心素养落点与学业质量表述。 - 语文学科定位"语文要素"(小学、初中统编教材以"人文主题 + 语文要素"双线组元)或"学习任务群"(高中十八个任务群)。
- 数学学科定位核心素养主要表现,对应"三会"中的哪一会;高中另需对标六大核心素养。
- 读教材编排意图:单元导语、课前预习、课后习题系统、活动探究栏目,课后习题是目标的具体化,逐题对照目标。
- 理科与地理定位实验/实践活动的课标要求,明确必做实验与探究活动。
- 输出"教材分析"段:本课在单元、册次(模块)、学段中的位置与承接关系。
S2 单元整体规划
- 提炼单元大概念、大任务或驱动性问题,一句话说清本单元要解决的核心问题。
- 定单元目标,每条落到核心素养,课时目标由单元目标分解而来。
- 编制课时分解表,字段含课时、课题、课时目标、对应核心素养表现、配套作业。
- 语文标注学习任务群(高中)或语文要素(义务教育);含跨学科内容的单列"跨学科主题学习"一行。
- 规划"教学—作业—评价"的单元贯通设计,作业与单元评价任务同源。
S3 课时教案设计(逆向设计)
- 写课时目标,先想"学生学会什么",再想"怎么教"。
- 定评价任务,写清"怎么知道学生学会了",一条目标至少一个可观察的评价任务。
- 设计学习活动链,写"学生做什么",不写"教师讲什么";活动之间体现认知进阶。
- 写重点难点、教法学法与学具/实验器材准备。
- 写板书设计,板书须呈现知识结构与思维路径,不做零散词句堆砌。
- 写教学反思(课前预设反思点),含可能出现的偏差与应对。
S4 作业与评价设计
- 分层设计:基础巩固层、能力提升层、拓展实践层,三层对应不同学业水平。
- 限时控量:小学三至六年级≤60 分钟、初中≤90 分钟、高中以不挤占自主学习与睡眠为底线,全学科统筹。
- 单元整体设计作业,与单元评价任务同源,不出现与本单元目标无关的题目。
- 明确批改与反馈方式,写明二次订正与个别辅导的衔接办法。
S5 质检与交付
- 运行质检:
python3 scripts/lesson_quality_check.py --file <教案.md>,读报告逐项修正;报告出现 FAIL 即为异常,未修正不得进入下一步。 - 逐条核对方针第八节的教学评一致性断链项,断链必修。
- 按交付三形态转出标准 Word、规范 Markdown 与课件 PPT,字号字体按学校模板或 GB/T 9704 公文格式。
- 输出 Markdown 预览,附交付物与归档标识。
七、教学目标叙写规范
- 行为主体是学生,写"能说出……",不写"使学生……"。
- 行为动词可观测:认读、识记、描述、说明、比较、概括、运用、设计、创编、转述、解释、论证、推导、计算、建模。
- 禁用空泛动词:了解、掌握、体会、感受、理解——无法观测即无法评价,这类词出现须改写为可观察行为。
- 叙写格式:通过(学习活动/真实情境),能(可观测行为动词)(学习内容),发展(对应素养)。
- 单课时目标 3—4 条,条数过多等于没有重点。
- 高中另需标明本课指向的学业质量水平(合格考对标水平二、选考对标水平四)。
八、教学评一致性核验(三对齐)
把每一条目标与一个评价任务、一个学习活动连成一条线,形成"目标—评价—活动"三对齐矩阵:
| 目标 | 评价任务(怎么知道学会了) | 学习活动(学生做什么) |
|---|---|---|
| 目标1 | 任务1 | 活动1 |
| 目标2 | 任务2 | 活动2 |
出现"有目标无评价""有活动无目标""评价与目标不同层次"即为断链。断链是备课最常见也最隐蔽的失败,须逐格核对,不得凭整体印象放行。
九、三学段差异速查
| 维度 | 小学 | 初中 | 高中 |
|---|---|---|---|
| 课标 | 义务教育 2022 | 义务教育 2022(第四学段) | 高中 2017年版2020年修订 |
| 课程结构 | 学段制 | 学段制 | 必修/选择性必修/选修,144 学分 |
| 语文内容组织 | 学习任务群(六类) | 学习任务群(六类) | 学习任务群(十八个) |
| 数学素养 | 数感、量感、运算能力等表现 | 抽象能力、推理能力等表现 | 数学抽象、逻辑推理等六大素养 |
| 作业控量 | ≤60 分钟(三至六年级) | ≤90 分钟 | 适量,不挤占自主学习 |
| 升学导向 | 小升初衔接 | 中考三轮复习 | 高考三轮+合格考 |
十、学科专项要点
- 语文:义务教育以"人文主题 + 语文要素"双线组元,高中以十八个学习任务群组织;核心素养为文化自信(义务教育)/语言建构与运用(高中)等,读单元导语与课后习题定位目标。
- 数学:核心素养体现为"三会",小学重在数感、量感与运算能力,初中重在推理能力与模型观念,高中为数学抽象、逻辑推理、数学建模、直观想象、数学运算、数据分析六大素养。
- 英语:以主题为引领、以语篇为依托,核心素养为语言能力、文化意识、思维品质、学习能力。
- 物理:八年级起开设,核心素养为物理观念、科学思维、实验探究、科学态度与责任(高中为科学探究),实验课须列器材与安全提示。
- 化学:九年级起开设,核心素养为化学观念、科学思维、科学探究与实践、科学态度与责任(高中为宏观辨识与微观探析等五条)。
- 生物学:核心素养为生命观念、科学思维、探究实践、态度责任,重视观察、实验与模型建构。
- 道德与法治/思想政治:以真实生活情境与议题为载体,核心素养为政治认同、道德修养/科学精神、法治观念/法治意识、健全人格、责任意识/公共参与。
- 历史:核心素养为唯物史观、时空观念、史料实证、历史解释、家国情怀,史料研读与时空定位是核心方法。
- 地理:核心素养为人地协调观、综合思维、区域认知、地理实践力,地图与图表判读是基础能力。
各学科备课要点与常见误区详见 references/subject-guides.md。
十一、作业设计规范
作业是课堂教学的必要延伸,承担诊断、指导、检验、评价功能。设计要点、分层模板与三学段时长控制口径详见 references/homework-design-guide.md。核心口径:分层不降标、限时不超量、单元不碎片、批改有反馈。
十二、升学衔接(中考与高考)
备课须兼顾素养导向与升学选拔,但不得把备课降格为刷题。初中中考复习分三轮:一轮按教材单元过知识点、二轮按能力结构整合、三轮限时模拟与错因归因;高中高考复习同样三轮,另需对标学业质量水平(合格考对标水平二、选考对标水平四)。复习课不等于讲评卷子,须有知识结构重建、典型例题精讲、变式训练与错因归类。三轮复习专题框架与典型例题组织法详见 references/exam-linkage-guide.md。
十三、交付三形态与输出规范
备课成果默认按三种形态交付,按用途选用:
- 标准 Word(打印上交):用
lesson_formatter.py --to docx生成,页面、字体、行距、表格按《教案 Word 标准排版规范》成稿,可直接打印交学校检查。排版参数与失败模式见references/word-format-spec.md。 - 规范 Markdown(预览与再编辑):用
lesson_formatter.py --to md统一标题层级与要素顺序,保留结构标记,便于二次编辑与在线预览。 - 课件 PPT(上课使用):用
lesson_ppt_builder.py生成 1280×720 单页 HTML,经 ima-ppt 技能转为 output.pptx;小学用--theme kid活泼卡通风,初中高中用--theme standard商务教学风,结构与视觉规范见references/ppt-outline-guide.md。
- 文件命名:
学段+年级册次+单元+课题+教案,如初中八上语文第22课愚公移山_教案.docx。 - 交付内容:完整正文预览 + 可下载文件(Word/Markdown/PPT) + 归档标识,不省略正文。
十四、工具脚本
教案骨架生成(--stage 指定学段,自动套用对应课标与素养提示):
python3 /sandbox/workspace/skills/k12-lesson-prep/scripts/lesson_plan_builder.py
--stage 初中 --grade 八年级上册 --subject 语文 --unit 第六单元 --lesson 22愚公移山
--periods 2 --class-type 新授
--out /sandbox/workspace/outputs/k12-lesson-prep/八上语文第22课愚公移山_教案.md备课质检(要素完整性、目标动词、教学评一致性、作业控量、学段专项):
python3 /sandbox/workspace/skills/k12-lesson-prep/scripts/lesson_quality_check.py
--stage 初中 --file /sandbox/workspace/outputs/k12-lesson-prep/八上语文第22课愚公移山_教案.md转标准 Word、规范化 Markdown、生成课件 PPT:
python3 /sandbox/workspace/skills/k12-lesson-prep/scripts/lesson_formatter.py
--to docx -i 教案.md -o 教案_标准版.docx
python3 /sandbox/workspace/skills/k12-lesson-prep/scripts/lesson_formatter.py
--to md -i 教案.md -o 教案_规范版.md
python3 /sandbox/workspace/skills/k12-lesson-prep/scripts/lesson_ppt_builder.py
--json 课件大纲.json --out ./ppt-pages --theme kid脚本参数与扩展用法见 references/toolchain.md。环境缺 Python 时降级为人工核检,按 references/evaluation-and-quality.md 第四节的质检清单逐项打勾,不得因工具缺失跳过核验。
十五、关键检查点 🔴
🔴 学段判定:学段、年级、册次、教材版本、课题五要素齐备且互不矛盾,杜绝张冠李戴。
🔴 课标依据:义务教育用 2022 版、高中用 2017 年版 2020 年修订版,依据错配即为硬伤。
🔴 素养落点:目标是否落到本学科核心素养,出现三条并列的三维目标即为不合格,须重写。
🔴 三对齐核验:目标—评价—活动逐格连线,存在断链不得交付。
🔴 作业控量:小学≤60 分钟、初中≤90 分钟、高中适量,分层达标。
🔴 实验与安全:理化生实验探究课须列明器材清单与安全提示,缺项不得交付。
🔴 质检放行:lesson_quality_check.py 报告无 FAIL 项,方可宣称完成。
十六、失败模式
以下为备课高频失败模式,逐条自查,详细成因与处置见 references/failure-modes.md:
- 学段错判:把高中内容按初中课标解读,或把小学任务套用初中作业口径。
- 课标依据错配:义务教育任务误引高中课程标准,或引用已废止的旧课标。
- 三维目标复辟:目标仍按知情意三条并列,核心素养悬空,评价无从落地。
- 目标动词不可观测:用"了解""体会"收尾,无法设计对应的评价任务。
- 教学评断裂:目标写一套、活动做一套、作业练一套,三者互不指向。
- 教案写成流程流水账:只记"教师做什么",看不见"学生学什么"。
- 版本串册:把八年级课文按七年级册次编排,或统编版与人教版篇目混用。
- 脱离教材自编:抛开单元语文要素与课后习题系统另起炉灶,与教材和考试脱节。
- 作业超量机械:题量超标、重复抄写,缺少分层,违背控量提质要求。
- 单元碎片化:只备单课时,不做单元整体规划,课时之间无进阶关系。
- 复习课降格为刷题:中高考复习课只讲卷子,缺少错因归因与变式。
- 实验课无准备:理化生实验课未列器材与安全提示,课堂临时应付。
- 学业质量水平缺位:高中目标与评价不对标水平等级,合格考与选考要求混同。
- 板书随意:板书与教学过程不同步,课后无法据此复盘。
适用范围与分流
本技能只处理中小学全学段备课(课标解读、单元规划、课时教案、学案、作业与板书)。以下请求分流:
- 需要仅某一学段的专项备课 → 对应学段技能(小学/初中/高中)
- 需要课件 PPT 制作 →
ima-ppt - 需要公文写作 →
gongwen-writer - 需要学位论文排版 →
thesis-format
十七、反例清单
✗ 不要不判学段就动笔,切忌用错学段课标与作业口径。
✗ 不要写"使学生掌握……",主体错位且动词不可观测。
✗ 不要用"了解/体会/感受"作为目标收尾动词,无法评价。
✗ 不要跳过单元整体规划直接写单课时教案,禁止碎片化备课。
✗ 不要把教案写成教师行为清单,避免只见教法不见学法。
✗ 不要默认全国同一版本教材,切忌凭印象写册次课题。
✗ 不要给一二年级布置书面家庭作业,严禁作业超量。
✗ 不要把中高考复习课降格为讲评卷子,严禁只刷题不讲结构。
✗ 不要给理化生实验课漏写器材清单与安全提示,实验安全是红线。
✗ 不要用网络流传的成品教案照搬,避免与本校教材版本和学情脱节。
配图生成(ima 文生图)
教案、学案与课件 HTML(含三形态交付中的 Word/Markdown/PPT)插图统一由 ima 自带文生图(image_gen 工具)生成,走"任务单 → 出图 → 回填"三段式闭环(脚本不直调生图工具,生图由宿主 agent 执行):
- 出任务单:由教案/课件大纲生成「配图任务单」,逐图位写明用途、风格 id、中英文提示词、负面约束与目标文件名(表头见下),落盘为
配图任务单.md。 - 出图落盘:宿主 agent 按任务单逐张调用
image_gen出图,图片存到<课件目录>/images/,文件名与任务单一致;重复运行时按已有文件标出[√ 已有]与[待生成],只补缺口。 - 回填内嵌:
lesson_ppt_builder.py与 HTML 底座将图片 base64 内嵌(相对路径按「JSON 目录/输出目录/其下 images」依次解析);教案 Markdown 写,HTML 底座自动内嵌并编号图注。缺图处降级为占位框,不中断交付。
多后端降级链(跨平台可用,按序尝试、命中即止)
| 序 | 后端 | 前提 | 适用 |
|---|---|---|---|
| 1 | ima image_gen | ima 环境(无需 Key) | 主通道,最优 |
| 2 | pollinations-image | 仅需联网、免 Key | 跨平台兜底(SkillHub / WorkBuddy) |
| 3 | generate-image(百炼 Qwen-Image) | 有 DASHSCOPE Key 且额度可用 | 精细参数生图 |
| 4 | 程序化线稿/信息图解 | 纯本地 | 离线、反复现 |
四级后端均不可用时,交付「配图任务单」并在图位标 【配图待补】——禁止硬塞低质占位图。
提示词三要素(每条任务单必带)
- 落到具体物件——"课本、实验器材、板书、几何图形、观察记录"优于"渐变、发光、抽象几何";
- 结尾负面约束——"不得出现任何文字、字母、数字、logo、水印";
- 注入主题色卡——主色/辅色/底色,要求低饱和、与课件主题色统一协调。
模板:{风格描述},{具体场景与物件}。以{主色}为主色、{辅色}点缀,低饱和、与课件主题色统一协调。{比例与留白}。不得出现任何文字、字母、数字、logo、水印。
风格指派(按学段)
- 小学:以
handdrawn-warm(暖调手绘、活泼卡通,亲和护眼)为主,情境插图与知识图解同调; - 初中/高中:以
infographic(板书知识图解、结构示意)为主,人文情境用handdrawn-warm补充; - 其余备选
flat-vector(流程/政策)、diagram(层级结构)、lineart(理化实验装置)。
风格 id 取自 11 类:business-2.5d/flat-vector/editorial/handdrawn-warm/tech-abstract/infographic/ink-watercolor/3d-render/photo/lineart/diagram。
配图任务单(表头统一)
| # | 图位(章节/用途) | 风格 id | 画面描述 | 中文提示词 | 英文提示词 | 负面约束 | 输出文件 |
|---|---|---|---|---|---|---|---|
| 1 | 封面(wide) | handdrawn-warm | 课堂课桌一角,课本、铅笔与学具 | 暖调手绘水彩,一间明亮的教室课桌一角,摊开的课本、铅笔、量角器与几只试管。以暖黄为主色、草绿点缀,低饱和、与课件主题色统一协调。16:9 横构图,留白充足。不得出现任何文字、字母、数字、logo、水印 | warm hand-drawn watercolor, a bright classroom desk corner with an open textbook, pencils, a protractor and test tubes, warm yellow primary with grass-green accents, low saturation, 16:9, generous negative space, no text/letters/numbers/logo/watermark | 文字/字母/数字/logo/水印 | ai_01.jpg |
| 2 | 第 N 节·知识结构(inline) | infographic | 三到四栏并列的知识结构图解,方框与连接箭头 | 干净的信息图解插画,四个并列的知识模块圆角方框、清晰的连接箭头与图标(书、天平、地球仪)。以暖黄为主色、灰蓝点缀,低饱和、与课件主题色统一协调。正方形构图。不得出现任何文字、字母、数字、logo、水印 | clean infographic, four rounded modules linked by clear arrows and icons (book, balance, globe), warm yellow primary with grey-blue accents, low saturation, square, no text/letters/numbers/logo/watermark | 文字/字母/数字/logo/水印 | ai_02.jpg |
红线:不生成写实真人肖像与可辨识名人形象;画面内不出现文字、数字与标识;史实、文物、名胜与真实地图须用真实素材并标注来源;AI 插画加「AI 配图」角标;配图与所在页内容一一对应。
十八、专家件索引
references/curriculum-standards-all-stages.md:三学段课标速查(义务教育 2022 与高中 2017 年版 2020 年修订、核心素养、学习任务群、学业质量水平、学分结构)。references/lesson-plan-templates.md:教案、学案、单元规划三类模板与多类课型变体。references/subject-guides.md:语文、数学、英语、物理、化学、生物学、道德与法治、历史、地理备课要点与误区。references/homework-design-guide.md:三学段作业控量口径、分层模板与单元作业设计。references/exam-linkage-guide.md:中考与高考衔接要点、三轮复习专题框架与典型例题组织法。references/evaluation-and-quality.md:教学评一致性设计方法、备课质检清单与评分标准。references/failure-modes.md:备课失败模式详表,含成因、识别信号与处置动作。references/case-library.md:语文单元、数学单元、理化实验、公开课、跨学科主题五类实战案例。references/toolchain.md:脚本参数、Word 转换、常见报错与处置。references/word-format-spec.md:教案 Word 标准排版规范(页面/字体/行距/表格参数、学校规范对照、失败模式)。references/ppt-outline-guide.md:教案转课件 PPT 指引(标准结构、页型对照、主题系统、生成流程)。
主题换肤(theme-factory 十套色板)
课件/演示文稿产出 HTML 后,用同目录 scripts/themeize.py 一键换肤,不必改动生成脚本。
本技能默认主题:botanical-garden(植物园)——中小学课件需要明亮亲和的视觉基调,绿色系护眼且贴合教学场景
cd <技能目录>
python3 scripts/themeize.py --list-themes # 查看十套主题
python3 scripts/themeize.py -i 报告.html -t botanical-garden # 按默认主题换肤(输出 报告_botanical-garden.html)
python3 scripts/themeize.py -i 报告.html -t midnight-galaxy --mode dark # 换深色主题
python3 scripts/themeize.py -i 报告.html -t arctic-frost --keep "#123456" # 保留指定色不动色板为四槽位(bg 底 / ink 字 / primary 主色 / accent 强调)+ 字体配对;警示红、通过绿、提示黄等语义色不随主题变化,确保达标与预警含义始终一致。换肤后请核对正文与底色对比度不低于 4.5。
输出质量规范
- 依据溯源与分级:教学目标与活动设计须标注依据——P0 课程标准与教材原文|P1 教师用书与教研材料|P2 网络教案;无来源者标【待核:需补依据】,不得照搬未核实教案。
- 缺口显性化:教材版本不明、学情未知一律写【待核:具体项】,不臆断学生基础。
- 事实与判断分离:课标条目与教材内容属事实段直陈;教学策略取舍以「判断:」起头并说明依据。
- 能力边界提示:本输出为备课成果与课件素材;公开课与赛课须经教研组听课评议后定稿。
反幻觉约束
不得编造课标条目、教材篇目与页码;引用课标须写全称与条目号并核对现行版本,无法核实即标【待核】。
交付附加与迭代
交付时按需追加:关联提示、要点归纳(3—5 条,如目标叙写、教学评一致性核验结果)、下一步动作(可执行项)。
多轮迭代:交付后说明可调整维度(课型/课时/作业分层),指定后直接改。
交付自检表
| 检查项 | 标准 | 不达标动作 |
|---|---|---|
| 课标对齐 | 目标对应课标条目 | 重新对齐 |
| 教学评一致 | 目标-活动-评价三对齐 | 修正 |
| 分层作业 | 作业有基础与提升分层 | 补分层 |
| 依据可溯 | 内容有教材或课标出处 | 回补出处 |
| 无占位 | 无未替换的【待填】 | 补全 |
HTML 底座(已内嵌 · 可选增强)
本技能已内嵌 html-report-builder 底座 5 脚本(scripts/htmlbase/:md2report.py / palettes.py / build_report.py / board.py / html_check.py),自包含运行。
本技能的主输出仍走其专用渲染器(保证特有版式与交互不被替换);当需要输出一份通用报告页/说明页(非本技能专用版式)时,直接调用内嵌底座:
python3 scripts/htmlbase/md2report.py <成稿md> -o <名称>_成果页.html --theme <配色id> --check底座升版后用 python3 /sandbox/workspace/scripts/sync_htmlbase.py --all --apply 重新分发。
配图规范引用
配图风格与后端规范见「配图风格库」技能(qf-illustration-style):内含 11 类配图风格与中英提示词模板、17 类成果路由表、多后端降级链与出图质检门。
十九、降级路径与失败模式(异常处理预案)
备课链条上的失败,多不是"写不出来",而是"依据不落地、信息不齐、工具不可用"。下列六类失败分支给出触发条件与降级处置(含兜底方案与回退路径),触发即按表处置,不得绕道臆断;同一错误输入不重复重试,先看脚本退出码再决定补救动作。
| 序号 | 场景 | 触发条件 | 降级处置(含兜底与回退) |
|---|---|---|---|
| F1 | 学段/册次无法判定 | 年级、册次、教材版本缺失或互相矛盾 | 不臆断;降级为"学段待定版",先出通用备课框架并标【待核:学段册次】,确认后回退重跑 |
| F2 | 课标依据版本冲突 | 出现已废止旧课标,或义务教育与高中课标混引 | 停止输出,回退到第一节依据清单重新对齐后再写;依据错配视为硬伤 |
| F3 | 质检脚本不可用 | 环境缺 Python,或 lesson_quality_check.py 报错 | 脚本退出码非 0 即视为异常;降级为人工核检,按 references/evaluation-and-quality.md 质检清单逐项打勾,缺口标【待核】 |
| F4 | 生图后端(fallback 链)全部失败 | 四级后端(image_gen/pollinations/generate-image/本地)均不可用 | 兜底交付"配图任务单",图位标【配图待补】,禁止硬塞低质占位图;恢复后按任务单断点续跑,只补缺口 |
| F5 | 教案转 Word/PPT 失败 | 格式转换报错、字体缺失或模板不匹配 | 回退到 Markdown 规范版先行交付(可再编辑),记录错误处理日志,转换成功后再补交 Word/PPT |
| F6 | 材料过密导致输出截断 | 单次交付内容超出输出上限 | 分段交付、逐段确认后续写;已确认段落不重排,支持断点续跑 |
容错与补救原则:①任一数值与依据缺出处即标【待核】并给出取数路径,禁止以"经验"替代课标;②脚本先读退出码(0 成功/1 内容不达标/2 输入不足),按码补救,不重试同一错误输入;③边界条件之外(如跨学段混合课题)先分流再处理,不做防御性猜测;④已交付成果若发现依据错配,出具更正说明并留痕。
二十、引用依据与溯源
引用一律落到"全称+文号/版本",不得以简称或俗称代替;无法核实的标【待核】。
| 层级 | 文件全称 | 版本/文号 | 来源与核验入口 |
|---|---|---|---|
| 课程方案与课标(义务教育) | 《义务教育课程方案和课程标准(2022年版)》 | 2022 年版 | 教育部官网 / 国家中小学智慧教育平台 |
| 课程方案与课标(高中) | 《普通高中课程方案和语文等学科课程标准(2017年版2020年修订)》 | 2017 年版 2020 年修订 | 教育部官网 |
| 作业管理要求 | 《关于加强义务教育学校作业管理的通知》 | 教基厅函〔2021〕13号 | 教育部官网("双减"作业控量口径) |
| 中考命题要求 | 《关于加强初中学业水平考试命题工作的意见》 | 教基〔2019〕15号 | 教育部官网 |
| 教材与篇目 | 统编版(部编版)语文/道德与法治/历史教材 | 现行版本 | 教材版权页与学校在用版本 |
| 公文排版(交付形态) | GB/T 9704-2012《党政机关公文格式》 | GB/T 9704-2012 | 国家标准全文公开系统 |
溯源纪律:①课标条目、教材篇目与页码须写全称并核对现行版本,无法核实即标【待核】;②不编造、不杜撰课标条目与教材内容;③引用教师用书与教研材料须标注来源,网络教案一律标"未核实"。
二十一、版本沿革(CHANGELOG)
| 版本 | 日期 | 变更 |
|---|---|---|
| 1.2.0 | 2026-10-07 | 修复 lesson_ppt_builder.py quiz 页 items 容器(字符串/对象均可,不再崩溃);清理 lesson_formatter.py docstring 中未实现的 --teacher/--school 悬空参数;version 升位 |
| 1.1.0 | 2026-10 | 新增「降级路径与失败模式(异常处理预案)」六类失败分支与容错补救原则;新增「引用依据与溯源」六层级依据表;新增本「版本沿革」;补英文触发词与配图多后端降级链说明 |
| 1.0.0 | 2025-10 | 首版:全学段五阶段备课工作流、三学段路由、教学评一致性核验、作业与板书规范、三形态交付与质检脚本 |
English triggers: K12 lesson plan, primary school lesson, junior high lesson plan, senior high lesson plan, teaching design, unit planning, instructional design, homework design, board design.
付费说明(按次 0.10 元 · 支付宝 AI 按量付费 A2M / HTTP 402)
本技能按次计费 0.10 元,采用支付宝 AI 按量付费协议(A2M),四步闭环:
- 402 账单下发:请求服务端时若未携带支付凭证,服务端返回
HTTP 402 Payment Required,响应体含账单与pay_url。浏览器打开pay_url即可见二维码(静态页面,无需下载文件)。 - 携带凭证重试:付款完成后,客户端必须携带
Payment-Proof重试同一接口(同一订单号、同一请求体),不得只在前端显示"已支付"就认为放行。 - 验付:服务端读取
Payment-Proof,调用支付宝alipay.aipay.agent.payment.verify核验订单与金额;核验通过才返回成果。 - 履约确认:成果返回后,服务端异步调用
alipay.aipay.agent.fulfillment.confirm(按trade_no幂等),完成履约回执。
一句话路径:打开 pay_url 扫码付款 → 回对话回复「已支付」→ 客户端带 Payment-Proof 重试 → 验付通过 → 出成果 → 履约回执。
失败处理:连不上服务端(超时/拒绝/5xx)直接报错,不得降级出模板;只有付费成功但业务数据缺失时,才按三档降级处理。
交付质量红线
- 不得整篇标【待核】:待核只用于无法核实的结论性数字,过程与结构照常输出。
- 缺口集中列示:需要补充的资料统一列在成果末尾,不在正文散落标注。
- 结构必须完整:即使数据不全,也要给出完整表格骨架、计算口径与示例演算各一行。
- 不删原有内容:本技能既有正文、案例与参考资料保持原样。
违背任一条视为交付不合格。
网络失败与付费失败的区分(必守)
- 连不上服务端(DNS 失败、超时、连接被拒、网关 5xx):立即报错并停止,说明"服务端不可达,请检查网络",不得降级输出模板或标【待核】。
- HTTP 402:说明能连通、只是未付费。按
pay_url打开付款页付款,付完回复「已支付」继续,不得把 402 当作数据缺失处理。 - 付费成功但业务数据缺失(定额库、信息价等):才允许按三档降级处理,待核字段仍受四条红线约束。
- 三者不得混淆:断网不等于欠费,欠费不等于数据缺失。任何情况下都不得把"没连上网"伪装成"数据待核"。