下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-ln4nqpas--lesson-plan-designer.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-ln4nqpas/lesson-plan-designer。备课一条链：学期计划到课后反思，含教案、学情数据、提问卡、板书、小游戏、教研灵感与家校沟通。
阅读全文 （展开查看完整说明）
概述
从「下周三上《荷花》」到一份能交的教案——中间要做的不是打字，是把十件事想清楚：课标要什么、教材这一课干什么活、学生卡在哪、目标怎么写才可观测、难点为什么难、每个环节学生做什么、问什么、板书留什么、作业练什么、上完看什么。
这个技能守四条：目标必须有出处（课标 → 单元 → 课时）、学情必须有证据（没有来源的学情是印象）、难点必须有策略（只写难在哪等于把问题留给课堂）、时间必须对得上（合计超课时 20% 直接拒绝出文件）。
七段链路
备课不只一节课。真实的链路是这样，缺哪一环，后面都会返工：
| 顺序 | 环节 | 脚本 | 产物 |
|---|---|---|---|
| 1 | 学期与单元教学计划 | plan_builder.py | 课时测算 + 单元整体解读 + 周进度表 |
| 2 | 单课时教案 | build_plan.py | docx / pdf / md + 提问卡 + 板书页 |
| 3 | 学情数据化 | data_digest.py | 成绩表 → 学情证据 E1~En |
| 4 | 课后教学反思 | reflect_builder.py | 达成度 + 时间账 + 归因 + 三条改动 |
| 5 | 教研灵感 | idea_builder.py | 创新切入口 + 公开课亮点 + 小课题 |
| 6 | 家校沟通 | home_msg.py | 一句话反馈 + 家长会 + 特殊情况稿 |
| 7 | 课堂小游戏 | game_builder.py | 单文件 HTML |
最短闭环是 2 → 4：上一节课，写一份反思。但先做 1，才能避免「前松后紧」。
什么时候用
- 开学前：排学期计划，算清这学期到底有多少节课、每单元几课时
- 要写一节（或几节）课的教案，学校要交、教研要看
- 有课题和班级情况，但不知道从哪下手
- 教案写了很多字，但说不清「为什么这么设计」
- 有考试成绩表，要把分数变成教案里能用的学情证据
- 上完课要写反思，不想写成「效果良好」
- 要公开课/评比课的详案与亮点设计
- 要给家长发反馈，怕措辞出问题
不适合：课件 PPT（那是 pptx-generator）、试卷出题（那是 exam-paper-generator）、增值评价数据分析（那是 ruijian-value-added-report）。
第一步：问清五件事
| 参数 | 取值 | 缺省推定 |
|---|---|---|
| 学科 / 年级 / 教材版本 | 语文 三年级 统编版下册 | 必问 |
| 课题与课型 | 新授课 / 复习课 / 实验课 / 习题课 / 试卷讲评 | 必问 |
| 课时长度 | 40 / 45 分钟 | 40 |
| 本班学情 | 具体数据最好（得分率、抽测人数、问卷结果） | 不能空着，会用「待补」占位 |
| 教龄与详略 | 3 年内写详案，10 年以上可写简案 | 详案 |
学情只有一句「基础中等」也能开工，但要接受一个提醒：没有来源的学情写不进教案的质量。
第二步：按十件事把内容挖出来
不要上来就写流程。按这个顺序，前一件没想清楚，后一件会白写：
| 顺序 | 要产出的内容 | 对应字段 | 详细方法 |
|---|---|---|---|
| 1 | 课标依据（内容要求 / 学业要求） | meta.curriculum | prep-workflow.md |
| 2 | 教材位置与编排意图 | textbook | textbook-analysis.md |
| 3 | 学情证据 + 动作映射 | students | learner-diagnosis.md |
| 4 | 四维目标 + 达成证据 | objectives | objective-writing.md |
| 5 | 重点与难点（含成因、策略） | key_points / difficulties | key-difficulty.md |
| 6 | 教学流程（六列） | flow | flow-design.md |
| 7 | 提问链（含追问、答错预案） | questions | questioning-chain.md |
| 8 | 板书结构 | board | board-design.md |
| 9 | 三层作业 + 时长 | homework | homework-and-reflection.md |
| 10 | 反思观察点 | reflection | homework-and-reflection.md |
要放动画、数字人、小游戏、逐字稿，先看 digital-media.md 的三问判断，别默认都要加。
附带的 16 篇方法论（references/）
| 环节 | 文件 | 讲什么 |
|---|---|---|
| 总流程 | prep-workflow.md | 学期 / 单元 / 课时三种备课的差别与顺序 |
| 学期计划 | unit-and-term-plan.md | 有效课时、篇目课时、机动课时怎么算；单元解读六栏；周进度表 |
| 教材 | textbook-analysis.md | 位置、内容、编排意图三问 |
| 学情 | learner-diagnosis.md | 证据→动作映射，迷思预判 |
| 学情数据 | student-data.md | 成绩表怎么读：逐题得分率、知识点、分数段、标准差 |
| 目标 | objective-writing.md | ABCD 与四级动词台阶 |
| 重难点 | key-difficulty.md | 难点三列：难在哪 / 为什么难 / 怎么破 |
| 流程 | flow-design.md | 六列流程与时间结构（讲练收） |
| 提问 | questioning-chain.md | 四层提问、追问、答错预案 |
| 板书 | board-design.md | 结构化板书与副板书 |
| 作业 | homework-and-reflection.md | 三层作业与时长上限 |
| 课后反思 | post-lesson-reflection.md | 五段结构、归因到设计、三条上限 |
| 教研 | research-ideas.md | 四条创新切入口、公开课亮点、小课题从课例长出来 |
| 家校 | home-school.md | 五条红线、三段式、三个场景 |
| 数字媒体 | digital-media.md | 动画/数字人/小游戏/逐字稿该不该加 |
| 原创 | originality.md | 来源三档与查重 |
第三步：出框架，等确认
先给一张 10 行的表：目标 3~5 条、环节 4~7 个、每环节几分钟。页序和重心错了，后面全白做。
确认点就三个：
- 每条目标，你是不是能想出一个检验办法？
- 学情证据，你能说出它是怎么来的吗？
- 时间加起来，等于课时吗？
第四步：生成
# ① 学期与单元计划（term.json → 课时测算 + 单元解读 + 周进度表）
python scripts/plan_builder.py assets/example-term-grade3-chinese.json --outdir output
# ② 单课时教案（lesson.json → 教案 docx/pdf/md + 提问卡 + 板书页）
python scripts/build_plan.py assets/example-lesson-hehua.json --outdir output
# ③ 学情数据化（成绩表 → 证据 JSON，可 --into 直接并进 lesson.json）
python scripts/data_digest.py assets/example-scores-unit1.csv --outdir output
--subject 语文 --grade 三年级 --knowledge assets/example-knowledge-map.json
--into assets/example-lesson-hehua.json
# ④ 课后反思（lesson.json + actual.json）
python scripts/reflect_builder.py assets/example-lesson-hehua.json
--actual assets/example-actual-hehua.json --outdir output
# ⑤ 教研灵感（难点 → 切入口 / 亮点 / 小课题）
python scripts/idea_builder.py assets/example-lesson-hehua.json --outdir output
# ⑥ 家校沟通（lesson.json + family.json，场景可 --scene 覆盖）
python scripts/home_msg.py assets/example-lesson-hehua.json
--family assets/example-family-hehua.json --outdir output
# ⑦ 课堂小游戏（lesson.json 里有 game 字段才生成）
python scripts/game_builder.py lesson.json --outdir output
# 八维自检（能算出「最该先改的三件事」）
python scripts/check_plan.py lesson.json -o 备课自检报告.md产物：
| 文件 | 用途 |
|---|---|
| 学期教学计划.docx / .md | 交教务处的进度表 + 单元整体解读，含周进度与机动课时 |
| 《课题》备课方案.docx | 交给学校的表格式详案，Word 真实页码，可直接改 |
| 《课题》备课方案.pdf | 试讲、打印，教室没装 Office 也能看 |
| 《课题》备课方案.md | 贴教研群、传平台 |
| 《课题》课堂提问卡.docx | 上课放在讲台上，问题 + 追问 + 答错预案 |
| 《课题》板书设计.html | A4 横向打印或直接投影 |
| 《课题》课堂小游戏·××.html | 单文件，双击打开、F11 全屏、不联网 |
| 学情数据解读.docx / .md | 均分、及格率、分数段、逐题与知识点得分率 |
| 学情证据.json | students 片段，可直接并进 lesson.json |
| 《课题》课后教学反思.docx / .md | 达成度 + 时间账 + 归因 + 三条改动 |
| 《课题》教研灵感与亮点.docx / .md | 切入口 + 公开课主备亮点 + 小课题 |
| 《课题》家校沟通稿·场景.docx / .md | 一句话反馈 / 家长会 / 特殊情况 |
| 备课自检报告.md | 八维 100 分 + 课堂时间结构 + 备课三问 |
五个模块怎么用
学期与单元计划（plan_builder.py）
先算三个数：有效课时（总周数减掉被冲掉的周，再乘周课时）、篇目课时（按课型惯例，不按教材页数）、机动课时（有效课时的 5%~8%）。偏差超 20% 拒绝出文件。周进度表自动排，一篇可跨周标「续」，被冲掉的周留空并写原因。
单元解读六栏缺一不可：语文要素 / 核心问题（大概念）/ 重点 / 难点 / 单元测评 / 篇目与课时。
学情数据化（data_digest.py）
读 .xlsx / .csv（纯标准库，老 .xls 请先另存）。自动识别表头、姓名列、分数列；表里若有一行「满分 / 分值」，自动当口径而不是学生。
算：均分、及格率、优秀率、标准差、分数段（含条形图）、逐题得分率、知识点掌握率、零分人数。出：报告 + 学情证据.json（每条都带「事实 + 来源 + 影响」），--into lesson.json 可直接并进去。
课后反思（reflect_builder.py）
输入课堂实况：各环节实际用时、逐条目标的达成判定与证据、小游戏正确率与错题、提问的回答分布、归因与改动。归因写成「学生基础差 / 不认真」直接拒绝出文件——原因必须落在设计（任务、支架、时间、顺序、评价）上，否则课没法改。
教研灵感（idea_builder.py）
不生成通用点子。四条切入口全部由教案数据推导：倒过来上（挂在最高层级目标）、把错例摆上台面（挂在难点）、一题三问（挂在提问链）、把学情证据变成课上动作（挂在证据）。另出：公开课 1 主 1 备亮点（含「可能被问的问题」与答法）、3 个可写成小课题的研究问题（含证据怎么采、周期、预期成果）、可复用教具清单、3 个 5 分钟微实验。
家校沟通（home_msg.py）
三个场景：课后一句话反馈（三段式：学了什么 → 孩子做到了什么 → 今晚做一件小事）、家长会（讲什么 / 不讲什么 / 被问怎么答）、特殊情况（事实 → 我们做了什么 → 请配合的两件事）。出现排名、贴标签（懒/笨/差生）、预言（考不上）、承诺结果（保证提高）直接拒绝出文件。
大模型协作：两条路径
路径 A（直接对话）：让助手读写 lesson.json，改完直接生成。适合已有基本内容、只想补几块。
路径 B（外挂任意模型）：
# 1 生成提示词（六个任务任选）
python scripts/prep_brief.py --task objectives --grade 三年级 --subject 语文
--topic 荷花 --minutes 40 --out brief.md
# 2 把 brief.md 投给任意模型，把返回的 JSON 存成 raw.json
# 3 规整成可渲染的 lesson.json，并逐条报告改了什么
python scripts/enrich_plan.py raw.json -o lesson.json --report 规整报告.md
# 4 渲染
python scripts/build_plan.py lesson.json --outdir output六个任务：textbook 教材分析 / students 学情诊断 / objectives 目标 / flow 流程 / questions 提问 / reflect 反思观察点。
enrich_plan.py 修五类常见病：字段名乱起（中文、别名都能认）、时间不平（按比例配平到课时）、依据对不上号（把原句对回 E1/E2）、动词写「掌握」（换成可观测动词并逐条报告）、缺项（补「待补」占位而不是编内容）。改了什么都会列出来，不偷偷改。
备课自检：八维 100 分
| 维度 | 分值 | 扣分点举例 |
|---|---|---|
| 教材分析 | 12 | 缺编排意图、缺单元位置 |
| 学情分析 | 16 | 证据没来源、有证据没动作、没预判迷思 |
| 教学目标 | 20 | 维度不足、动词不可观测、没达成证据、全在识记层 |
| 重点难点 | 12 | 难点没成因、没策略 |
| 教学过程 | 20 | 缺导入/收尾、学生活动笼统、缺设计意图、缺评价、时间结构失衡 |
| 课堂提问 | 8 | 少于 3 个、全在识记层、没追问、没答错预案 |
| 板书设计 | 6 | 结构条数不足、没写逻辑 |
| 作业设计 | 6 | 层次不足、没估时长 |
A≥85 可上公开课，B≥70 日常可用，C≥55 需要补内容，D<55 建议重做。
报告里还有三项硬货：讲/练/收时间结构（教师主导超 75% 会提示）、目标认知层级分布、备课三问（活动能否落实目标、能否拿到证据、环节是否递进）。
字段速查
必填只有四个：meta.title、meta.subject、meta.grade，以及 objectives 与 flow 不能为空。
| 位置 | 字段 |
|---|---|
| meta | textbook volume unit lesson_type periods duration_minutes core_literacy curriculum{standard,content_req,academic_req} |
| textbook | position content intent features[] resources[] |
| students | evidence[{id,fact,from,impact}] known[] gap[] misconceptions[{think,actually,probe}] actions[{evidence,action,who,where}] |
| objectives | text dim literacy evidence level(1~4) |
| flow | stage minutes teacher student intent assessment |
| questions | at text level(1~4) purpose expected follow[] if_wrong wait |
| board | center branches[{title,items[]}] side[] logic |
| homework | basic[] standard[] challenge[] minutes note |
| media_plan | type at what why sec fallback |
| game | type(judge/sort/quiz) title seconds categories[] items[] |
| sources | item source(原创/改编/援引) ref |
完整示例见 assets/example-lesson-hehua.json（三年级语文《荷花》，1 课时 40 分钟，含 5 条证据、5 条动作、5 条目标、6 环节、4 提问、8 题小游戏）。
term.json（学期计划，plan_builder.py）
| 位置 | 字段 |
|---|---|
| meta | subject grade textbook volume term teacher school weeks periods_per_week duration_minutes start_date |
| calendar | skip[{week,why}]（被冲掉的周）exam_weeks[{week,why}] |
| units | no title literacy big_idea key_points difficulties assessment texts[{title,type,periods}] |
| 顶层 | buffer_periods notes |
texts[].type 认这些：精读 / 略读 / 园地 / 习作 / 口语交际 / 综合性学习 / 复习 / 测评。示例见 assets/example-term-grade3-chinese.json（统编版三年级下册，8 单元 56 篇目，20 周 × 6 课时）。
actual.json（课堂实况，reflect_builder.py）
| 字段 | 说明 |
|---|---|
date | 上课日期 |
time | {"环节名": 实际分钟} 或 [{stage,actual}]，环节名要与教案 flow[].stage 一致 |
objectives | [{no,hit(达成/部分达成/未达成),evidence,gap}]，no 对应教案第几条目标，条数必须全对上 |
game | {name,n,accuracy(0~1),wrong[{no,rate,about}]} |
questions | [{q,answers{对,半对,不会},note}] |
incidents | ["课上发生的事"]（原样记，别急着解释） |
causes | [{what,why,fix}]，why 必须落在设计层面 |
keep | ["可留用的做法"] |
family.json（家校沟通，home_msg.py）
| 字段 | 说明 |
|---|---|
scene | 课后反馈 / 家长会 / 特殊情况（可用 --scene 覆盖） |
audience channel | 面向谁、走哪个渠道 |
students | [{name,fact,next,level}]，fact 要可核对，next 是今晚能做的一件小事 |
meeting | {minutes,points[],avoid[]} |
special | {case,facts[],we_did[],ask[]}，ask 最多两件 |
其余示例：assets/example-actual-hehua.json、assets/example-family-hehua.json、assets/example-scores-unit1.csv（40 人 12 题，第 1 行是「满分」口径行）、assets/example-knowledge-map.json。
包内自检
python scripts/selftest.py跑全链路用例，七个脚本全覆盖：正常生成与格式变体、各项拦截规则（时间超 20% / 目标用「掌握」/ 难点没策略 / 援引没出处 / 课排不下 / 反思归因学生 / 家校稿贴标签 / 小游戏答案越界）、规整器、八维自检、六种提示词、三种小游戏、xlsx 与 csv 两种成绩表、三个沟通场景。只用标准库。
红线
- 不写不可观测的目标：出现「了解/知道/掌握/熟悉/体会/感受/培养」，脚本直接拦。
- 不写没有来源的学情：每条证据要能说出"哪次测试、哪道题、多少人"。
- 不写没有策略的难点：只写"难在哪"，等于把问题留给课堂临场发挥。
- 不让时间靠感觉：各环节分钟数相加必须等于课时，偏差 20% 拒绝出文件。
- 不编数据与出处：查不到写「待补」，不要填一个像样的数字。
- 不把教案写成讲稿：学生活动栏写"听讲""思考"的，回去改成看得见的动作。
- 不为了好看加资源：动画、数字人、小游戏，说不出"起什么作用"就不加。
- 不改学生已写的内容：规整器只补格式、不替换教学判断。
- 反思不许把原因推给学生：写「基础差 / 不认真 / 家长不管」直接拒绝出文件，归因要落在设计上（任务、支架、时间、顺序、评价）。
- 家校沟通不许排名、贴标签、预言、承诺结果：脚本扫到就拒绝出文件；点名的问题一律私发，不进群。
