Lesson 0004: 教学 Workspace 结构设计

不是"把文件放一起"——每个文件对应一个学习功能,按信息生命周期组织

回顾

上节课你卡在了一个问题上:teach skill 用哪两个文件来定位 ZPD?

答案是 learning-records/MISSION.md。但更根本的问题是:为什么是这两个文件?为什么不是别的? 这就要回到整个 workspace 的结构设计。

你现在的 workspace

learning/how-to-learn/ ├── MISSION.md ← 你为什么学这个? ├── RESOURCES.md ← 高质量知识从哪里来? ├── NOTES.md ← 你的学习偏好 ├── lessons/ │ ├── 0001-fluency-vs-storage.html │ ├── 0002-knowledge-skills-wisdom.html │ └── 0003-zpd.html ├── reference/ │ ├── fluency-vs-storage.html │ ├── knowledge-skills-wisdom.html │ └── zpd.html └── learning-records/ ├── 0001-fluency-illusion-recognized.md ├── 0002-fluency-vs-storage-retrieval-verified.md ├── 0003-knowledge-skills-wisdom-retrieval-verified.md └── 0004-zpd-retrieval-verified.md

每个文件解决一个具体问题

文件解决什么问题信息生命周期
MISSION.md "我为什么要学这个?"——没有它,每节课都像随机漫步。给 ZPD 提供方向 偶尔更新
RESOURCES.md "这个知识可信吗?"——防止 AI 用参数化知识瞎编。标注高质量来源 偶尔追加
NOTES.md "这个学生怎么学最好?"——记录偏好(比如你"不喜欢抽象"),个性化教学 频繁更新
lessons/ "这一课学什么?"——单次学习的最小单元。短、交互、完成后很少回看 消耗品
reference/ "过两周我还能快速查到这个概念吗?"——压缩后的精华,设计成打印友好、快速查阅 永久资产
learning-records/ "这个学生已经会了什么?哪里卡住了?"——给 ZPD 提供下边界。类似 ADR,记录决策级洞察,不是流水账 只追加
核心设计原则:lessons 是消耗品(用完即弃),reference 是永久资产(反复回看),learning-records 是定位器(定位 ZPD),MISSION 是指南针(定方向)。

这个设计和你自己的项目结构完全同构:
lessons/docs/workspace/plan/(临时)
reference/docs/reference/(永久)
learning-records/fragments/(积累后结晶)
MISSION.mddocs/roadmap.md(方向)

试一下:匹配练习

以下场景,应该用哪个文件?

1. 学生说"我不喜欢看视频,喜欢文字+练习"

2. 需要快速查"ZPD三个区域分别是什么"

3. 老师想判断下一课该教什么

为什么不是一个大文件?

把所有东西塞进一个文件 = 信息生命周期混乱。消耗品和永久资产混在一起 → 要么舍不得删(垃圾堆积),要么删错了(丢了重要参考)。

分的本质是给不同类型的信息不同的命运:lessons 可以毫不犹豫地归档,reference 可以反复精炼,learning-records 只看不删。

参考文档:Workspace 结构参考卡片

有问题?直接问。

Lesson 0004 · 2026-06-18 · Learning Records