teach - LEARNING-RECORD-FORMAT

学习记录格式学习记录存放在./learning-records/中使用顺序编号0001-slug.md、0002-slug.md等。懒创建目录——只在写入第一条记录时才创建。它们是教学版的 ADR架构决策记录它们捕获非显而易见的经验教训、关键洞见和已陈述的既有知识这些将指导未来的会话。它们被用于计算最近发展区zone of proximal development。模板# {所学习或确立内容的简短标题} {1-3 句话学到了什么或确立了哪些既有知识以及为什么它对未来会话很重要。}这就是完整格式。一条学习记录可以是一个段落。价值在于记录_已知道_这个事实以及_为什么_它改变了接下来要教的内容——而不是填写各个部分。可选部分只在它们能带来真正价值时才包含。大多数记录不需要它们。状态frontmatteractive | superseded by LR-NNNN——当早期的理解被证明是错误并被替换时很有用。证据——用户如何展示了这种理解回答的问题、完成的练习、引用的既有经验。当该说法可能被重新审视时很有用。影响——这对未来会话开启或排除了什么。当不显而易见时值得记录。编号扫描./learning-records/找到现有最大编号并加一。何时写学习记录当以下任一情况为真时写一条用户展示了对某个非平凡事物的真正理解——不仅仅是接触过而是有证据表明他们能正确使用这个概念。这为接下来要教什么设定了新的底线。用户披露了既有知识——我已经知道 X。记录下来这样未来的会话不会重新教它。也要记录所声称的_深度_。一个误解被纠正了——用户之前相信了错误的东西现在明白了原因。这些是高价值的它们能预测相关主题未来的绊脚石。任务因学习而转变——用户发现自己关心的东西和原以为的不同。交叉链接到 [[MISSION.md]] 并更新它。什么_不_符合条件仅仅被覆盖过的材料。覆盖不等于学习。等待证据。任何已经以术语定义形式简洁记录在 [[GLOSSARY.md]] 中的内容。不要重复。逐会话的活动日志。学习记录不是日记——它们是决策级别的洞见。取代当一条较晚的记录与较早的记录矛盾时用户的理解加深或被纠正将旧记录标记为Status: superseded by LR-NNNN而不是删除它。理解如何演变的历史本身就是有用的信号。