mcpField
K
k12-lesson-differentiation

k12-lesson-differentiation

github.com/learning-commons-org其他4039 次安装1 周前更新
代码仓库

关于 k12-lesson-differentiation

K-12 Lesson Differentiation 面向教师,将现有课程改编为低于、符合和高于年级水平的版本。它应用学科专属的差异化规则,并可在有无 Learning Commons Knowledge Graph 连接器的情况下使用。

主要功能

  1. 01三个熟练度层级的课程
  2. 02学科专属差异化规则
  3. 03结合学习者需求的支架
  4. 04标准依据
  5. 05四份配套 Word 文档

适用场景

  1. 01按不同熟练度调整课程
  2. 02为已知学习需求添加支持
  3. 03依据标准对齐课程材料
  4. 04准备教师计划和分层学生文档

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/learning-commons-org/agent-skills --skill k12-lesson-differentiation

安装后在 Claude Code 中输入/k12-lesson-differentiation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE
NOTICE
references/
ela.md
example_differentiation.json
learning-commons-kg.md
math.md
output.md
science.md
social_studies.md
scripts/
lesson_common.py
render_all.sh
render_documents.py
render_lesson_docx.py
render_lesson_html.py
theme.css

详细介绍

K-12 课程差异化

根据基于研究的差异化原则(Tomlinson 框架 + 学科特定的学习机会设计),调整现有的 K-12 课程,以适应低于/达到/高于年级水平的熟练程度。可搭配或不搭配 Learning Commons Knowledge Graph 连接器使用。

本文中的“教师”始终指与你对话的用户本人,而非第三方。“面向教师”用于说明文档的受众是该用户,而不是其学生。


及时告知教师进度

教师选定路径(回答是否需要草稿)后,用一到两句话说明你接下来要做什么(例如:“我会阅读你的课程,将其与标准和课程材料相结合,设计三个层级,并制作练习单。”)。

如果有任务清单或待办事项工具,也要在其中列出此技能的步骤,方便教师查看完成进度;只有在当前对话中没有此类工具时,才可以跳过。


步骤 0 — 路由(静默执行,先于其他操作)

  1. 学科。 根据源课程或请求判断属于数学/英语语言艺术/科学/社会研究,然后立即读取对应的参考文件:

    • 数学 → references/math.md
    • 英语语言艺术 → references/ela.md
    • 科学 → references/science.md
    • 社会研究 → references/social_studies.md

    必须加载对应的参考文件。 其中包含步骤 1 和步骤 3 所需的教学法,包括源课程识别、课程体系检测、八项差异化规则 R1–R8、文档内容模板,以及 differentiation.json 映射。

  2. 课程体系。 学科文件中的“识别源课程”部分包含课程体系检测(Illustrative Mathematics / OpenSciEd)。确认课程体系后,按照学科文件的要求,在教师计划中使用该课程体系的讨论用语和结构。

    满足以下任一条件即可确认课程体系: 教师明确指出课程体系,或上传的源课程提及该课程体系(上传即视为默认确认)。

    如果未确认课程体系(无法从上传内容或链接中识别,且教师未明确提及):不得在任何输出或聊天消息中提及具体模块、单元编号、课次编号或专有教学流程名称——即使你在训练中认出了该流程也不行。应使用自己的通用表述描述教学方法(例如“比较策略的讨论”,而不是该流程的商标名称)。这是硬性规则;违反即不符合 P9,聊天消息也包含在内。另请参阅步骤 3 后的版权防护规则,了解相关的逐字转载规则。

  3. 连接器。 检查当前对话中是否提供 Learning Commons Knowledge Graph 工具(例如 find_standard_statement)。这将决定步骤 2 采用哪条路径。没有连接器也能完整使用此技能。

  4. 州。 调用任何 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 = 低于年级水平,等等)。

  1. 学习者差异说明(第一轮输出,且此前未询问过时)。 如果你在本次对话中从未询问具体的学习者需求(R8 问题),请在聊天中说明已应用 UDL 默认设置,并邀请对方提供具体信息——例如:“我没有收到有关特定学习者需求的详细信息,因此应用了 UDL 默认设置——所有三个分层工作纸都包含句型开头和词汇表。请告诉我是否有多语学习者或持有 IEP 或 504 计划的学生,我会进一步调整。” 只有在教师已经提供学习者信息时才跳过此项(此时应据此说明,例如:“Below 工作纸为新入学的 ELL 学生加入了句型框架”)。
  2. 三个针对本课的后续调整选项(第一轮输出)。 在聊天中提供 3–4 个迭代选项,每项一行简短说明,并针对本课(例如:增加按 WIDA 等级划分、提供句型支持的 ELD 分层;针对指定目标领域提供符合 IEP 目标的支架;在先备知识要求以下增加第四个干预层级;将范围缩小到仅包含离堂测验)。主题参考资料中的 FA 后续提示必须是其中一个选项。
  3. 满意度询问。 询问教师是否对全部四份文件满意,还是希望修改。不要省略此询问——每个输出轮次都必须包含,包括修订轮次。

第 6 步——完成

当教师确认对全部四份 Word 文档满意时(见 5c),该技能即完成。

评论

支持 Markdown