k2f-lesson-plan

K2F Lesson Plan 是一个基于 K2F 的技能，目标是让智能体在动手排版之前，先为“可教的课”搭好蓝图：锚定标准、设计计时教学弧、明确学生任务，并让教师版、学生版与观察表三套产出物保持同步，避免泛泛填充、照搬课程内容或文档之间相互漂移。

用途

面向需要一个新教案的教师，学科涵盖数学、英语语言艺术、科学、社会研究，或相近的 K-12 与高等教育研讨课形式。
适合需要把教案与讲义、原始资料摘录、观察网格打包成一个连贯文档包的用户。
不适用于评分标准、只做测验的请求，或不重新架构内容、仅对现有教案做差异化调整的场景。

主要能力与产出

该技能产出 .K2F 格式的教案包。使用前需先安装核心技能：npx skills add suzheng/k2f --skill k2f。之后按 k2f 技能进行编写：解包或初始化工作区、编辑语义树、运行 pack/verify、再导出。K2F 让智能体专注于含义（阶段、任务、观察要点），而不是像素坐标；版式、字体和主题由引擎编译。

工作流分为两步。

第一步，生成 content_and_design.md，即“教什么、如何阅读与浏览”的唯一蓝图，并要求共享元素只命名一次、在所有引用处复用，便于 k2f 技能后续映射到页面。子步骤包括：

路线与澄清：从提示中推断学科、年级段、时长与课程背景；最多提出两个高杠杆问题（如要瞄准的标准、班级限制），其余采用默认值。如果学科教学法不同（现象导向的科学、探究式社会研究、问题驱动的数学、以文本为中心的英语），需注明适用哪种教学弧。
标准锚点：用教师可用的形式陈述表现目标——标准代码（若已知）加不超过 10 词的要点；列出前置知识与关键术语，便于教师尽早发现班级不匹配；标出可能的误解，在阶段笔记中处理，而不是当作讲授块。
课程速览：最多三句话，说明学生做什么、为什么适合这个班、可测量的出口；随后是按分钟计时的阶段清单（名称、分钟数、各一行），总和等于课时，每分钟都对应学生行动或形成性检查，而非教师独白。
产出物地图与共享注册表：声明文档包包含哪些文档（至少教师教案；常见还有学生材料、观察模板；有时含原始资料包或可打印教具）。在“共享内容”部分一次性登记所有需跨页一致的内容：现象/情境、题目中的数字与人名、词汇表、退出票、讨论提示、观察要点。各产出物大纲用稳定键交叉引用，防止修改时静默分叉。
各产出物大纲：教案含目标、材料、逐阶段教学引导（含提问与预期回答）、差异化切入点、收尾；学生材料只放学生纸上需要的任务——书写空间、句式支架、图表、分类项目——并匹配课程阅读水平；观察模板只放与目标一致的少量观察要点，而非通用清单；纯口头课程要明确说明不发讲义、学生用什么替代。
设计意图：为引擎捕捉审美方向（非布局坐标），包括语气（平静、适合打印、专业教师工具；学生页更友好，但不幼稚，除非年级要求）、层级（课名与目标对比度最高，阶段名可扫读，引导细节嵌套在阶段之下而非平铺）、密度（教案在备课时间内可读，用项目符号与编号步骤而非段落；学生页留有书写空白）、一致性（所有产出物对阶段与任务用同一套词汇；章节标题与块内标签不要重复同一词）、配色（最少色彩、黑白打印保真，最多用一个强调色标注阶段或目标提示）。

第二步，使用 content_and_design.md 和 k2f 技能生成 K2F 文件并导出为合适格式：按 k2f 技能从蓝图实例化文档包，应用设计意图中的角色，验证并导出可直接进课堂的交付物。

规则与限制

原创教学写作：课程或知识图谱材料可影响范围与结构，但绝不逐字复制出版商学生文本、教师脚本或题集。
金线原则：标准→目标→阶段→学生作业→退出票→观察要点；砍掉不推进目标的趣味旁支。
时间预算诚实：活动装不下时，应缩小目标或去掉某阶段，不能把学生思考时间压到零。
受众分离：教师教案保留理由与调整点；学生材料只含学习者所见；观察表放证据栏，而不是教案脚本。

常见失败模式包括：活动没有可测量的出口；阶段清单全是“讲解”；学生讲义复制完整教案；共享情境只在一个产出物中改动；标题与块标签重复；遗漏前置条件。质量检查清单覆盖标准与目标匹配、退出票评估同一技能、阶段时间总和、共享注册表、学生阅读水平、观察要点可观察性、设计意图完整性、无逐字第三方课程文本。

技能介绍