withmarbleapp/os-taxonomy

来源：https://github.com/withmarbleapp/os-taxonomy

Marble 技能分类体系

一个开放、结构化的分类体系，描述儿童在小学阶段学习的内容——分解为细粒度的“微主题“，连接成先修关系图，并与国家课程标准对齐。由 Marble（https://withmarble.com）制作。

版本： v1 · 主题数： 1,590 · 先修边数： 3,221 · 学科数： 8

查看它

以旋转 3D 图的形式呈现该分类体系：每个点是一个微主题，按学科着色，由先修关系连接

每个点是一个微主题，按学科着色；高度代表年龄；每条连线是一条先修依赖（完整画质视频）。

在 withmarble.com/curriculum（https://withmarble.com/curriculum）上交互式探索——点击任意概念，即可追踪学习者在掌握它之前必须掌握的所有内容。

这是什么

大多数课程数据要么是扁平的标准列表，要么锁在某个产品内部。本数据集是一个互联的学习图谱：

• 1,590 个微主题 —— 一个单一的、可教授的知识点（例如*“Building sentences”、“Apparent brightness of stars”*），每个都带有通俗语言的描述、掌握度证据标准、一种类型（概念型 / 程序型 / 表征型 / 语言型 / 元认知型）、所属学科 + 领域，以及大致的年龄范围。
• 3,221 条先修依赖 —— 一个有向无环图：“主题 X 依赖于先修主题 Y”，每条边标记为 hard/soft，并附带一行理由。
• 课程对齐 —— 每个微主题都链接到其提炼来源的标准（NGSS、Common Core、英国国家课程等）。
• 领域聚类 —— 针对每个（学科、领域、年龄段）组合，提供 183 段面向家长的单段落摘要。

学科

文件

所有数据以 UTF-8 JSON 格式存放在 data/ 中。JSON Schema 见 schema/，数量统计与 SHA-256 校验和见 manifest.json。

一个主题

{
  "id": "mt_N8CpN1EJrP",
  "type": "CONCEPTUAL",
  "subject": "English",
  "domain": "Grammar & Punctuation",
  "name": "Building sentences",
  "description": "Understand that words combine to make sentences — a sentence expresses a complete thought...",
  "ageRangeStart": 4,
  "ageRangeEnd": 6,
  "centrality": 0.257,
  "evidence": [
    "Distinguish between complete sentences and fragments",
    "Compose a complete sentence with a subject and verb"
  ],
  "assessmentPrompt": "If {{name}} says something like \"The dog\", can they tell you that's not a complete sentence...?",
  "standards": ["ccss-ela:L.K.1f", "uk-nc-2013:Eng.App2.Y1.Sent.1"]
}

• id —— 稳定标识符（mt_...），被依赖关系和相邻节点引用。
• standards —— 指向 curriculum-standards.json 的键（格式为 "体系:标准ID"）。
• assessmentPrompt —— 对该知识点的自然语言检查。包含 {{name}} 占位符（孩子的名字）；展示前请替换或删除。

一条依赖

{
  "topicId": "mt__00ZSLnB7p",
  "prerequisiteId": "mt_VBl1T1sFCM",
  "strength": "hard",
  "reason": "Must understand vibrations make sound before finding volume patterns"
}

topicId 依赖于 prerequisiteId。反转这条边即可得到“解锁“关系。

如何使用

纯数据——无运行时，无依赖。加载 JSON 即可开始使用。

import topics from './data/topics.json' with { type: 'json' };
import deps from './data/dependencies.json' with { type: 'json' };

const byId = new Map(topics.topics.map(t => [t.id, t]));
const prereqs = deps.dependencies
  .filter(d => d.topicId === 'mt_N8CpN1EJrP')
  .map(d => byId.get(d.prerequisiteId).name);

校验结构与引用完整性：

node scripts/validate.mjs

许可证

本数据集采用多重许可——在使用或再分发之前请阅读以下内容。

为什么相同方式共享仍然对商业友好： ODbL 区分了衍生数据库（扩展/修改分类体系 → 必须保持开放）和产出作品（在产品、模型或应用中使用 → 归你所有）。因此你可以基于它构建商业产品而无需开源你的产品；你只需要回馈对分类体系本身的改进。

署名

任何使用都必须注明：

Marble Skill Taxonomy (v1) · © Generative Spark, Inc. (Marble) · https://withmarble.com · licensed under ODbL 1.0 (database) and CC BY-SA 4.0 (content).

另外，对于你使用的任何课程标准，还需附上 PROVENANCE.md 中的上游声明。正式引用格式见 CITATION.cff。

这里没有什么

本次发布有意排除的内容：语义嵌入（派生数据，可重新计算）以及任何针对单个儿童/用户的数据（从未发布）。见 CHANGELOG.md。