README“Using it”提供topics.json、dependencies.json的import示例,并说明“Pure data — no runtime, no dependencies”。
Marble Skill Taxonomy:把儿童学习拆成可追踪的知识图谱
给教育产品和课程设计者的儿童学习JSON图谱,区别于标准清单的是可追踪先修关系。
🧭 决策指南
为什么现在热: 无法从材料判断
适合,如果你
-
你要在JavaScript中加载1,591个micro-topics并追踪先修节点。
-
你的课程产品需要把主题连接到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
不适合
我正在做浏览器端家长课程导航,核心图只有 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个主题没有研究
- 项目洞察:浏览器一次性加载完整研究文件可能增加初始加载时间和内存占用
适合
我正在用 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
- 项目洞察:没有运行时、外部依赖或服务端
视情况
我维护一个同时对齐 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记录受版权政策影响的省略路径
- 项目洞察:标准映射不等于完整覆盖或国家课程完全等价
✨ 核心亮点
-
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先修关系的课程设计者