Reference · User-invoked · Productivity · Off main flow

teach 速查

有状态教学工作区的口袋版。完整教学见 Lesson 0021; 原文见 SKILL.md 与四个 FORMAT sibling (MISSION · RESOURCES · LEARNING-RECORD · GLOSSARY)。

一句话

/teach当前目录变成跨会话的教学工作区:使命驱动、 资源背书、一课一件事、学完留下文件。学习是一个项目才用它;一次性澄清直接问 agent。

何时伸手

工作区文件(全部副作用面)

文件装什么何时被写
MISSION.md学这个的原因,一切教学的地基采访后首次写;变更需用户确认,同步补 learning record
RESOURCES.md高信任资源(Knowledge/Wisdom 分组)攒资源时;每条必带注记,过时即删
lessons/*.html编号自包含课,教学主单元每课一份;尽量 CLI 帮用户打开
reference/*.html课的压缩精华,会被反复查随课产出;课很少重读,它会被重读
learning-records/*.md已学会的东西(教学版 ADR),ZPD 的输入仅四时刻:真学会 / 自报先备 / 纠正误解 / mission 变
assets/*跨课复用组件(样式表、quiz 控件…)课需要新组件时;复用是默认,禁内联复制
NOTES.md用户教学偏好、工作笔记用户表达偏好时追记;写课前回读
GLOSSARY.md工作区规范语言(本课程由 CONTEXT.md 承担)仅当用户真懂才收词;有立场,列避免项

从不触碰:Issue tracker、仓库源码、系统临时目录。

学习理论词汇

Knowledge / Skills / Wisdom
三支柱:知识来自高信任资源(挂引用);技能靠互动课 + 紧反馈循环;智慧只来自真实世界 → 委托社区。
Fluency vs Storage strength
流利强度=当下能想起(会骗人);存储强度=长期留存(真目标)。
Desirable difficulty
建存储强度的三招:retrieval practice(凭记忆掏)、spacing(摊开练)、interleaving(混着练,仅技能)。
ZPD(最近发展区)
挑战「刚好够」的区间;由 learning-records + mission 算出下一课。

一课的设计规则

  1. 自包含 HTML,lessons/NNNN-slug.html,编号递增;一课一件事,挂 mission
  2. 要美(Think Tufte),要短(装得进工作记忆),给一个 tangible win
  3. 锚点互链其它课与 reference;推荐一个 primary source;带「问 agent」提醒
  4. 知识侧:难度是敌人,引用撒满全课;技能侧:难度是工具,反馈即时自动
  5. quiz 硬规则:选项单词数一致(字符数尽量),不许格式泄题

下一步

微调入口(行为不对改哪里)