关于 k12-lesson-differentiation
K-12 Lesson Differentiation 面向教师,将现有课程改编为低于、符合和高于年级水平的版本。它应用学科专属的差异化规则,并可在有无 Learning Commons Knowledge Graph 连接器的情况下使用。
主要功能
- 01三个熟练度层级的课程
- 02学科专属差异化规则
- 03结合学习者需求的支架
- 04标准依据
- 05四份配套 Word 文档
适用场景
- 01按不同熟练度调整课程
- 02为已知学习需求添加支持
- 03依据标准对齐课程材料
- 04准备教师计划和分层学生文档
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ learning-commons-org/ agent-skills --skill k12-lesson-differentiation安装后在 Claude Code 中输入/k12-lesson-differentiation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSENOTICEreferences/ela.mdexample_differentiation.jsonlearning-commons-kg.mdmath.mdoutput.mdscience.mdsocial_studies.mdscripts/lesson_common.pyrender_all.shrender_documents.pyrender_lesson_docx.pyrender_lesson_html.pytheme.css详细介绍
K-12 课程差异化
根据基于研究的差异化原则(Tomlinson 框架 + 学科特定的学习机会设计),调整现有的 K-12 课程,以适应低于/达到/高于年级水平的熟练程度。可搭配或不搭配 Learning Commons Knowledge Graph 连接器使用。
本文中的“教师”始终指与你对话的用户本人,而非第三方。“面向教师”用于说明文档的受众是该用户,而不是其学生。
及时告知教师进度
教师选定路径(回答是否需要草稿)后,用一到两句话说明你接下来要做什么(例如:“我会阅读你的课程,将其与标准和课程材料相结合,设计三个层级,并制作练习单。”)。
如果有任务清单或待办事项工具,也要在其中列出此技能的步骤,方便教师查看完成进度;只有在当前对话中没有此类工具时,才可以跳过。
步骤 0 — 路由(静默执行,先于其他操作)
-
学科。 根据源课程或请求判断属于数学/英语语言艺术/科学/社会研究,然后立即读取对应的参考文件:
- 数学 →
references/math.md - 英语语言艺术 →
references/ela.md - 科学 →
references/science.md - 社会研究 →
references/social_studies.md
必须加载对应的参考文件。 其中包含步骤 1 和步骤 3 所需的教学法,包括源课程识别、课程体系检测、八项差异化规则 R1–R8、文档内容模板,以及 differentiation.json 映射。
- 数学 →
-
课程体系。 学科文件中的“识别源课程”部分包含课程体系检测(Illustrative Mathematics / OpenSciEd)。确认课程体系后,按照学科文件的要求,在教师计划中使用该课程体系的讨论用语和结构。
满足以下任一条件即可确认课程体系: 教师明确指出课程体系,或上传的源课程提及该课程体系(上传即视为默认确认)。
如果未确认课程体系(无法从上传内容或链接中识别,且教师未明确提及):不得在任何输出或聊天消息中提及具体模块、单元编号、课次编号或专有教学流程名称——即使你在训练中认出了该流程也不行。应使用自己的通用表述描述教学方法(例如“比较策略的讨论”,而不是该流程的商标名称)。这是硬性规则;违反即不符合 P9,聊天消息也包含在内。另请参阅步骤 3 后的版权防护规则,了解相关的逐字转载规则。
-
连接器。 检查当前对话中是否提供 Learning Commons Knowledge Graph 工具(例如
find_standard_statement)。这将决定步骤 2 采用哪条路径。没有连接器也能完整使用此技能。 -
州。 调用任何 KG 工具前,检查对话和已上传的源课程中是否有州信息,并将其保存为
state:- 教师表示“I teach in [state]”、“I'm in [state]”或“We're in [state]”
- 标准代码采用州特定格式(TEKS、SOL、OAS/PASS、MA、CA/HSS 或 CA/CCSS;其他以州名为前缀的代码也要核查对应州)
- 源课程 URL 包含州政府机构域名(例如 tea.texas.gov)
如果找到州信息:保存为
state = [state name]。在步骤 2 的每次find_standard_statement调用中传入jurisdiction="<state>"。所有输出均使用州级框架代码(而非全国性替代标准)。如果未找到州信息:
- 对于科学、数学或英语语言艺术,使用全国性默认标准(数学/英语语言艺术使用 CCSS,科学使用 NGSS)。在教师计划中添加以下单行页脚: “所用标准依据 [CCSS / NGSS] — 如果你在德克萨斯州、弗吉尼亚州、俄克拉何马州或其他采用独立框架的州,请告诉我所在州,我会据此重新确定标准。”
- 对于社会研究,继续之前先询问教师所在州。
步骤 1 — 确定源课程
按照学科文件中的源课程部分操作:情形 A(本次对话前文已有课程——直接使用,不要再次询问)、情形 B(教师上传课程——先阅读;如果无法读取,请说明并请求重新分享,绝不要悄悄编造)、情形 B2(教师通过 URL 链接课程——获取并阅读;如果获取失败,请让教师粘贴或上传)、情形 B3(仅限数学或科学——教师按位置或标题指定课程——例如“IM Grade 6, Unit 2, Lesson 3”或“OpenSciEd 中关于生态系统动态的课程”——步骤 1 已完成;直接进入步骤 2,由 find_curriculum_lessons 检索课程材料;不要要求教师上传或链接课程),或情形 C(没有提供源课程——先询问学科文件中的澄清问题,再继续)。
获取的链接内容会完整显示在对话中,因此,篇幅超过一节课的文档(模块或单元教师版)无法完整容纳。如果链接指向此类文档,请根据请求本身提供的信息开展工作,并向教师确认具体情况——主题、年级和标准足以作为设计依据,就像情形 C 在澄清后继续的方式一样。
**学习者需求检查(静默执行,每次都运行):**生成内容之前,检查对话中是否提到 ELL 等级、WIDA 等级、IEP 目标领域、504 便利措施或具体学生需求。如果有,将其纳入分层设计——尤其是低于年级水平层。除非教师明确指出,否则请说“家庭语言”,不要说具体语言。
如果没有提及学习者需求,且预生成阶段的 R8 提问尚未触发(范围已明确),请在首次回复中添加一句:“未提供具体的学习者需求——我已采用 UDL 默认做法(所有层级均提供句子支持和词汇支持)。如分享任何 ELL 等级、IEP 目标或具体学生数据,我会据此调整。”
即使范围已明确,也要执行此检查。
步骤 2 — 依据标准设计
**如果已连接 LC Knowledge Graph:**按照 references/learning-commons-kg.md 中对应学科的部分操作——必须在起草前调用;连接后未调用属于严重失误,无论源课程如何获得——检索课程并不能替代此步骤。
**如果未连接:**根据最佳知识继续,并在教师教案末尾添加以下脚注: “本内容生成时未使用 Learning Commons KG。标准文本、先备知识依据和常见误解均基于通用最佳实践。” 不要编造 KG 引用。
步骤 3 — 差异化规则
对每节差异化课程应用学科文件中的全部八项规则(R1–R8)。规则因学科而异(支架类型、各层级起点和拓展质量测试都因学科而异),但结构相同:输出结构(R1)、保留标准范围(R2)、各层级起点(R3)、对低于年级水平层的支架及密度上限(R4)、必需的教学基础设施(R5)、不可见的调整(R6)、同一层级内渐进式支架(R7)以及范围/默认设置(R8)。
版权防护
始终撰写原创内容。如果源课程参考了特定课程体系(IM、OpenSciEd),仅将其用于了解结构、范围、任务情境和标准对应关系——绝不要逐字复现课程材料中的学生用文本、活动叙述、探究提示、理解题或问题情境。各学科参考文件中都包含与学科相关的 Copyright 说明。
如果未确认课程体系(请参见步骤 0.2 的检测规则),则绝不要在输出或任何聊天消息中提及具体课程体系、模块、单元编号、课时编号或专有教学流程名称——即使这些内容能从训练数据中识别出来也不例外。源课程和 KG 数据可用于指导设计,但不得作为引用来源。完整规则(P9)请参见步骤 0.2。
步骤 4 — 提供草稿选项
教师可以选择在正式制作前先看一份快速草稿。询问草稿选项时,应将其作为一个独立问题,与步骤 2 前需要询问的其他内容(州、源课程、学习者需求——有结构化问题工具时使用该工具,否则通过聊天询问)一并提出;如果没有其他需要询问的内容,则单独提出。选项始终是完整套件或草稿。问题中应使用以下措辞:
- 问题:我应该制作一套可直接用于课堂的完整材料(教师计划 + 三份分层文档,均为可编辑的 Word 文档),还是你想先看一份快速草稿?
- 选项:直接制作 · 先看快速草稿 — 在此聊天中说明各层级会有哪些变化
默认制作完整套件。 回复选择草稿选项或要求查看草稿时,才提供草稿;其他所有回复都执行步骤 2–3,然后直接进入步骤 5。
确认需要草稿时,必须先完成步骤 2–3,不能跳过。 完整执行步骤 2——每一次 KG 调用都必须按原文执行——然后再执行步骤 3,之后才能构思任何内容。未基于步骤 2 的依据就构思草稿,属于严重错误。随后在聊天中展示设计——草稿只能是聊天文本; 教师批准后,才在步骤 5 进行渲染。展示以下内容:
- 一行回顾源课程、标准和年级;
- 对于每个层级(低于 / 达到 / 高于),用 2–3 个项目符号说明有哪些变化及原因;
- 学生任务概览——列出每个层级的实际任务,内容应足以让教师快速浏览并判断覆盖情况;
- 一行说明所有层级的共同内容——核心问题或核心任务——以及重新分组规则
草稿中的名称应与其预览的文档保持一致——阶段、任务、层级和章节都应使用计划中将采用的名称。
之后用简单的聊天措辞询问接下来要做什么——教师可以通过输入回复直接说明修改内容,而选择选项无法做到这一点:"想要做任何调整吗?在这里告诉我——或者告诉我继续,我就会创建材料(教师计划和三份分层文档,均为可编辑的 Word 文档)。"
在聊天中根据修改要求更新并重新展示草稿——这个阶段的修改很快。教师同意继续的那一轮就执行步骤 5。
步骤 5 — 输出(一轮完成)
教师选择完整套件时立即执行,或在教师批准草稿的那一轮执行。
四份材料——1 份教师版计划 + 3 份学生分层文档(低于 / 达到 / 高于)——全部由打包脚本根据**一个 differentiation.json(材料源文件)**生成。任何会出现在多份材料中的内容(标准、问题 / 任务组、离堂测验、词汇、句型支持、常见误解)都只在 JSON 的 shared 块中保存一次,并通过 {"type": "from_shared", "key": …} 块引入每份文档,这样教师计划和分层文档就不会相互脱节——同时从结构上确保 R6(各层级的背景相同、核心任务相同)。
每次修改都写入 differentiation.json 并重新生成(即时完成)——绝不编写布局代码、手动编辑生成的文档,也不将其重新输入为另一种格式。
与教师交流时使用通俗语言。 上述机制对教师不可见:在任何面向教师的消息中,绝不提及 JSON、HTML、架构、脚本、工具名称、渲染、文件名或代码——也绝不链接或提及渲染命令同时生成的 .html 文件。应说 "这是你的分层计划——三份分层文档很快就会生成",而不是 "我已经渲染了 differentiation.json"。文本中唯一可以提及的格式名称是“Word 文档”。这适用于每一轮,包括告知进度的消息:展示材料、询问是否满意、总结修改内容,以及错误消息(如果生成失败,应说无法创建文档——不要说脚本或 JSON 出错)。
编写 differentiation.json 之前,请完整阅读 references/output.md——其中包含硬性要求、交叉核对项、架构、修订规则和学生页面语言规则。在任何修订轮次之前,都要重新阅读。
5b. 一条命令、同一轮中渲染全部四份 Word 文档
bash scripts/render_all.sh differentiation.json "$OUTPUT_DIR"
这会在一次调用中生成 $OUTPUT_DIR/teacher_plan.docx、$OUTPUT_DIR/worksheet_group_a.docx、$OUTPUT_DIR/worksheet_group_b.docx 和 $OUTPUT_DIR/worksheet_group_c.docx,以及 .html 工作文件——无需复制;将脚本写入的所有文件留在原处(后续修订轮次会从工作文件重新渲染)。然后列出 $OUTPUT_DIR,确认每份文档都有对应的 .docx 和 .html;如果有任何文件缺失或过小,请重新运行脚本。将全部四份 Word 文档一起交给教师——最后附上教师教案,使其显示在最上方(聊天界面按最新内容优先的顺序堆叠)。如果脚本报错,请修复 differentiation.json(几乎总是 JSON 格式错误),然后重新运行。如果文件生成完全失败,请明确说明——不要悄悄改为只通过聊天交付。
5c. 收尾(每个输出轮次)
交付文件的聊天消息必须按顺序以以下三项结尾。每一项都必须出现在聊天消息本身中——只在打印版教案里提到不算。提及工作纸时,请使用其分组名称,并注明一次对应关系(Group A = 低于年级水平,等等)。
- 学习者差异说明(第一轮输出,且此前未询问过时)。 如果你在本次对话中从未询问具体的学习者需求(R8 问题),请在聊天中说明已应用 UDL 默认设置,并邀请对方提供具体信息——例如:“我没有收到有关特定学习者需求的详细信息,因此应用了 UDL 默认设置——所有三个分层工作纸都包含句型开头和词汇表。请告诉我是否有多语学习者或持有 IEP 或 504 计划的学生,我会进一步调整。” 只有在教师已经提供学习者信息时才跳过此项(此时应据此说明,例如:“Below 工作纸为新入学的 ELL 学生加入了句型框架”)。
- 三个针对本课的后续调整选项(第一轮输出)。 在聊天中提供 3–4 个迭代选项,每项一行简短说明,并针对本课(例如:增加按 WIDA 等级划分、提供句型支持的 ELD 分层;针对指定目标领域提供符合 IEP 目标的支架;在先备知识要求以下增加第四个干预层级;将范围缩小到仅包含离堂测验)。主题参考资料中的 FA 后续提示必须是其中一个选项。
- 满意度询问。 询问教师是否对全部四份文件满意,还是希望修改。不要省略此询问——每个输出轮次都必须包含,包括修订轮次。
第 6 步——完成
当教师确认对全部四份 Word 文档满意时(见 5c),该技能即完成。