Marble Skill Taxonomy:把儿童学习拆成可追踪的知识图谱
给教育产品和课程设计者的儿童学习JSON图谱,区别于标准清单的是可追踪先修关系。
GitHub withmarbleapp/os-taxonomy 更新 2026-10-20 分支 main 星标 6.1K 分叉 1.0K
JavaScript 教育数据 JSON 课程标准

🧭 决策指南

适合,如果你

  • 你要在JavaScript中加载1,591个micro-topics并追踪先修节点。
    README“Using it”提供topics.json、dependencies.json的import示例,并说明“Pure data — no runtime, no dependencies”。
  • 你的课程产品需要把主题连接到NGSS或Common Core标准。
    README“What this is”说明每个micro-topic链接到NGSS、Common Core、UK National Curriculum等标准。
  • 你需要为Science或Mathematics主题读取教学活动和评估信息。
    README“Teaching research”说明研究覆盖547个Science主题和504个Mathematics主题。

不适合,如果你

  • 你需要每个主题都有教学研究,尤其要覆盖English、History或Computing。
    README明确指出其他540个topics在本版本没有research;教学研究当前只覆盖Science和Mathematics。
  • 你需要已经实证验证的教学干预或新近核验的来源。
    README“Teaching research”明确说activities不是empirically validated interventions,sources未重新抓取或核验。
  • 你需要每个儿童的用户数据或semantic embeddings。
    README“What’s not here”明确排除per-child/user data和semantic embeddings。

前置条件

  • 数据以UTF-8 JSON存放在data/目录。
  • README说明“Pure data — no runtime, no dependencies”。
  • 使用teaching-research.json时,需处理约24 MB文件及topicFileSha256绑定。
  • assessmentPrompt包含{{name}}占位符,展示前需要替换或移除。

第一步命令(README 原文)

node scripts/validate.mjs

要注意

  • English主题的guidanceByTopic.get会返回undefined,因为English尚未覆盖。
    README“Using it”的代码注释明确写出“undefined: English is not covered yet”。
  • 修改topics.json后必须重新生成研究投影,即使topic ID没有变化。
    README“Teaching research”说明研究文件绑定topics.json的精确字节,并要求canonical topic file变化时重新生成。
  • assessmentPrompt不能直接展示{{name}},否则会保留儿童姓名占位符。
    README“A topic”说明该字段包含{{name}},展示前应替换或移除。
  • 不要把confidence high或verified true当作本次发布的新证据评级。
    README明确说明历史verified: true和confidence: high不是新的evidence ratings。

材料未说明

  • README没有说明数据文件的下载包大小,只有teaching-research.json约24 MB。
  • README没有说明Node.js的最低版本要求。
  • README没有给出JSON Schema的具体约束内容或校验失败示例。
  • README没有说明1,591个主题和3,225条依赖边的人工审核覆盖率。
  • README没有说明趋势关注是由课程标准、数据规模还是withmarble.com/curriculum可视化带来的,因此无法从材料判断。

💡 深度解析

4
不适合 我正在做小学科学和数学备课工具,希望利用 1,051 条教学研究记录生成活动、反馈和诊断提示;这些记录能否直接作为已验证的教学干预库?
适合读者: 正在做小学科学和数学教师备课工具、希望利用 1,051 条教学研究记录生成活动与诊断提示的教育产品工程师

不适合直接当作已验证干预库,因为README明确把活动定义为research-informed proposals,而不是经验验证过的干预措施。

  • teaching-research.json覆盖科学547个主题和数学504个主题,记录包含教学摘要、活动、反馈、评估、误解模式和来源信息,适合生成备课草案。
  • 但记录由代理撰写或整理,来源在本版本没有重新抓取或验证;confidence不是独立质量评分,历史verified: true也不是新证据评级。
  • 部分活动没有直接关联的source claim,且版权处理会把部分标准原文替换成引用路径。
  • 另有540个主题没有研究记录,缺失不表示主题不可教。

因此可作为带来源和免责声明的内容输入,不能把输出标记为经过实证验证的教学方案。

  • Teaching research:1,051 records;覆盖547 Science和504 Mathematics topics
  • Teaching research:Activities are research-informed proposals, not empirically validated interventions
  • Teaching research:Sources were not re-fetched or re-verified;confidence不是独立质量评分
  • Teaching research:the other 540 topics have no research
材料未说明:README未说明每条活动在真实课堂中的效果量、样本量或复现实验结果;README未说明教学研究记录是否经过学科专家逐条审核
不适合 我正在做浏览器端家长课程导航,核心图只有 1,591 个主题,但教学研究文件约 24 MB;我能否把整个仓库一次性放进首屏加载?
适合读者: 为浏览器端家长课程导航应用工作的 JavaScript 工程师、需要控制约 24 MB 教学研究文件的首屏加载和内存占用

不适合把整个仓库无条件放进首屏,因为约24 MB的教学研究文件会增加浏览器初始加载时间和内存压力。

  • README把核心数据拆成topics.json、dependencies.json、标准、摘要和teaching-research.json,说明可以按功能分开消费。
  • 教学研究文件约24 MB,而核心主题和依赖图本身可先支持主题浏览、先修追踪和领域导航。
  • 研究只覆盖科学和数学的1,051个主题,另外540个主题没有记录;家长导航不需要为英语、历史、计算机等主题预先下载不存在的研究内容。
  • 项目提供176个面向家长的领域摘要,适合优先加载摘要和主题数据,再按学科、年龄段或主题请求研究内容。

README没有给出切分接口或压缩格式,因此具体的分块与缓存实现仍需由应用负责。

  • Files:teaching-research.json约24 MB;clusters.json包含面向家长的领域摘要
  • Teaching research:覆盖1,051个主题;540个主题没有研究
  • 项目洞察:浏览器一次性加载完整研究文件可能增加初始加载时间和内存占用
材料未说明:README未提供浏览器端分块、压缩、缓存或按topicId查询的现成接口;README未给出不同设备上的加载时间和内存基准
适合 我正在用 JavaScript 构建小学自适应学习产品,需要根据 1,591 个微主题和 3,225 条先修边生成知识路径;这个项目能否直接作为课程图数据层?
适合读者: 正在用 JavaScript 构建自适应小学学习产品、需要处理 1,591 个微主题和 3,225 条先修边的教育软件工程师

适合,前提是你把它当作可加载的课程数据集,而不是现成的推荐服务。

  • topics.json提供节点,dependencies.json提供有向无环依赖图;边的语义是“topicId depends on prerequisiteId”,反向遍历才能得到“解锁了什么”。
  • 每条边带有hard/soft强度和自然语言reason,可用于生成可解释路径。
  • 数据使用UTF-8 JSON,没有运行时、服务端或外部依赖,JavaScript 产品可以自行加载、缓存和遍历。
  • 主题还关联年龄范围、掌握证据、assessmentPrompt及NGSS、Common Core、英国国家课程等标准。

但项目没有查询API、推荐算法或个体学习数据,因此掌握度预测和个性化排序仍需自行实现。

  • What this is:1,591 micro-topics;3,225 prerequisite dependencies;directed acyclic graph
  • Files:topics.json;dependencies.json;topicId depends on prerequisiteId
  • 项目洞察:没有运行时、外部依赖或服务端
材料未说明:README未说明浏览器端或Node.js端的具体加载API、性能基准和增量更新方案;README未说明依赖图是否经过真实学习行为数据验证
视情况 我维护一个同时对齐 NGSS 和 Common Core 的小学课程规划工具,还要比较科学、数学、英语等 8 个学科;这个数据集能否作为跨课程标准的统一映射层?
适合读者: 维护 NGSS 和 Common Core 对齐的小学课程规划工具、需要比较 8 个学科内容覆盖的课程设计者

视情况:它适合作为微主题到标准条目的索引层,但不适合作为标准等价或合规认证层。

  • 每个微主题都能链接到其提炼来源,包括NGSS、Common Core、英国国家课程等,适合做追溯、覆盖分析和内容筛选。
  • 数据覆盖8个学科,共1,591个主题;科学547个、数学504个、英语286个,能支撑多学科导航。
  • README明确说标准映射表示主题与标准的关联,不等于完整覆盖该标准,也不等于不同国家课程完全等价。
  • 标准原文可能因版权政策被替换为课程引用,变换路径记录在publicationNotes中。

因此,若工具需要“这个微主题关联哪些标准”,可以采用;若要输出法定课程合规结论,现有数据不足。

  • What this is:Curriculum alignment;NGSS、Common Core、the UK National Curriculum
  • Subjects:8个学科;Science 547、Mathematics 504、English 286
  • Teaching research:publicationNotes记录受版权政策影响的省略路径
  • 项目洞察:标准映射不等于完整覆盖或国家课程完全等价
材料未说明:README未给出每个标准映射的完整覆盖率或映射置信度;README未说明各国家标准版本的生效日期和地区适用范围

✨ 核心亮点

  • 1,591个micro-topics组成可追踪学习图谱
  • 3,225条依赖边构成带理由的DAG
  • 覆盖NGSS、Common Core等课程标准
  • 教学研究仅覆盖Science与Mathematics的1,051条记录

🔧 工程化

  • 以topics.json和dependencies.json提供纯JSON学习图谱
  • 用assessmentPrompt与evidence描述掌握证据
  • node scripts/validate.mjs可校验结构与校验和

⚠️ 风险

  • 540个topics在本版本没有教学研究记录
  • 研究记录由agent编写且来源未重新核验
  • activities是research-informed proposals而非验证过的干预

👥 适合谁?

  • 需要读取JSON构建课程图谱的JavaScript开发者
  • 制作小学教育产品且需要NGSS或Common Core对齐的团队
  • 研究Science、Mathematics先修关系的课程设计者