元案（yotta-lesson）
本地、确定性的教案骨架与覆盖校验技能。元案把「课标映射包」变成可复算的教案骨架，
并把「这节课的知识点、环节、来源、时间齐了吗」变成一份确定性缺口清单。
可信契约：
- 教案骨架来自映射包与结构配置，同一输入得到同一结果（仅生成时间不同）；
- 时间分配精确到分钟且合计可校验（课时 × 每课时分钟）；
- 每条学习目标都带课标来源；缺口清单给出具体原因与关键词；
- 核心路径不联网、不调用模型，教案与映射包只在本机流转。
何时使用
- 按学校自备的课标 / 单元映射，快速起一份结构完整的教案骨架；
- 用
check核对已有教案：知识点是否都覆盖、必填环节是否齐全、是否标了来源与时间； - 教研组统一教案结构（同一映射包 + 同一结构配置 = 同一套骨架口径）；
- 把教案结构检查接入批处理或 CI（
--gate findings=<n>）。
Do NOT trigger：
- 不生成题目与学案题目内容（组卷属元题，题面由学校题库提供），不生成学生评语；
- 不替代教师的教学设计判断：骨架与清单是备课辅助，最终设计由教师定稿；
- 不联网、不调用模型、不上传教案与校本映射；
- 不内置教材与课标原文，只记录结构性元数据；引用请以官方文本为准。
快速使用
# 生成映射包与结构配置模板
python3 scripts/yotta_lesson.py template --output-dir ./lesson-template
# 生成教案骨架（Markdown）
python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1
# 两课时版本 + JSON 输出
python3 scripts/yotta_lesson.py plan --map lesson-map.json --lesson L1 --periods 2 --format json
# 检查已有教案的覆盖缺口，并在缺口 ≥ 1 时让 CI 失败
python3 scripts/yotta_lesson.py check --plan plan.md --map lesson-map.json --lesson L1 --gate findings=1
# 映射包操作
python3 scripts/yotta_lesson.py map validate --map lesson-map.json
python3 scripts/yotta_lesson.py map list --map lesson-map.json
退出码：0 正常 ｜ 1 触发 --gate ｜ 2 输入错误 ｜ 3 映射或配置错误 ｜ 4 运行时错误。
输入与输出
- 课标映射包：JSON，逐课题声明
id/title/periods/knowledge/key_points/difficulties/misconceptions/standard（课标来源，必填）； - 结构配置（可选）：
minutes_per_period、stages（环节与比例）、required_stages、check_keywords； - 输出：教案骨架 Markdown + JSON（
schema_version 1.0，含objectives/stages/checklist/findings/sources/disclaimer）； - 缺口检查：
knowledge_missing/stage_missing/source_missing/time_missing/minutes_mismatch。
字段规范见 references/map-format.md；报告契约见 references/plan-format.md。
版权与边界
- 映射包只存结构性元数据（课题 / 知识点 / 课标条目标识），不存教材正文与题目原文；
- 课标引用以官方文本为准，本技能不做课标解读；
- 输出为备课辅助，不用于教学评价结论。
详见 references/copyright.md。
家族协同
- 元镜 yotta-mirror：用学情数据反哺下一轮备课的薄弱点；
- 元题 yotta-item：按双向细目表从学校自备题库组卷、并做试卷结构校验（不生成题面）；
- 元呈 yotta-present：把教案骨架渲染成统一格式；
- 元真 yotta-humanize：教师-facing 叙述文字去 AI 味；
- 元忆 yotta-memory：按需保存映射包版本与教案骨架摘要。
渐进披露
- 映射包与结构配置：
references/map-format.md - 骨架 / 检查报告契约与退出码：
references/plan-format.md - 版权与使用边界：
references/copyright.md
按需读取，不必每次全读。
