{title="📊 页面导航】

适用角色与上手难度

角色推荐度上手难度
🛠️ 开发★★★★★★★☆☆☆
🧪 测试★★★★☆★★☆☆☆
📦 产品★★★★☆★★★☆☆

🎯 学习产出: 掌握有状态教学法,能跨多会话系统学习一个新技能或概念

🚀 AI 能力提升: 知识管理、学习设计

/teach

预计阅读时间: 5 分钟

多会话教学。跨多个会话教用户一个技能或概念,把当前目录当作有状态的教学工作区。这是有状态的请求——用户打算长期学下去。

概述

深度学习的三个支柱:知识(来自高信任资源的捕获)、技能(基于知识的互动课程习得)、智慧(与其它学习者和实践者互动获得)。RESOURCES.md 未充实前,重点是找高质量资源——永远不信任参数化记忆

流畅强度 vs 存储强度:流畅(即时检索)给人虚幻的掌握感;存储(长期记忆)才是真目标。用合意困难设计课程:检索练习(从记忆回忆)、间隔练习(分散练习时间)、交错练习(混合相关主题——仅技能练习)。

日常使用

/teach 我想学 TypeScript 的类型体操
/teach 教我函数式编程
/teach 我想理解事件溯源

实战

教学工作区结构

文件/目录作用
MISSION.md学习动机——所有教学的锚点。用户说不清就先把问清楚
./reference/*.html参考材料:cheat sheet、算法、语法、词汇表。要打印好看、适合快速查阅。课程很少回看,参考文档会
RESOURCES.md高质量资源清单,教学的知识来源
./learning-records/*.md学习记录(类 ADR):非显然的教训和关键洞察,可能需修订或驱动未来会话。0001-<dash-case-name>.md 编号递增
./lessons/*.html课程:单个自包含 HTML,教一件紧贴使命的小事。编号 0001-<dash-case-name>.html
./assets/*跨课程复用组件:样式表、测验组件、模拟器、图表助手。复用是默认,不是例外
NOTES.md用户偏好和笔记草稿

课程设计

  • ,快速完成——学习者工作记忆很小;每课给一个能累积的具体胜利
  • 直接贴使命,在用户的最近发展区
  • 尽可能用 CLI 命令打开课程文件
  • 每课用 HTML 锚点链接到其它课程和参考文档
  • 每课推荐一个一手来源(找到的最高质量高信任资源)
  • 每课提醒用户向 agent 提问——agent 是他们的老师

共享样式表是每个工作区赚到的第一个组件:每课都链接它,让课程看起来像一个连贯的课程而不是一堆一次性产物。工作区成长,组件库也成长。

知识 vs 技能

  • 知识:获取时困难是敌人——它吃掉你理解所需的记忆。先教知识,再用互动反馈循环练技能
  • 技能:困难是工具——费力检索才建立存储强度。用测验和轻量浏览器任务,反馈循环尽可能紧(理想是即时自动)。测验答案保持等长,不通过格式给线索

智慧与社区

用户问需要智慧的问题,默认姿态是尝试回答——但最终委托给社区(论坛、subreddit、线下课、兴趣小组)。用户不想加入社区就尊重。

使命会变

用户技能增长,使命可能变化——正常。更新 MISSION.md 并加学习记录捕捉变化,改使命前和用户确认。

与其它技能的关系

  • 独立技能:不在主流程上
  • 互补:教学用到的写作材料可来自 writing-fragments/writing-beats 的产出