用途:把一条关于世界的持久事实写成 learning(配方卡),存放于 ~/.typmem/memory/learnings/。learning 一经捕获即有效可用,不等待评审;后续 typmem-judge 可整理学习项,并可能建议把最强的内容提升为 precedents/ 或 rules.md,但这是可选、非阻塞的。
与 retro 的区别:learning 是配方卡,记录“我现在知道的世界事实”,无故事、无时间线、无“我”,与具体日期或项目无关;retro 是日记,记录“我发生了什么”,如状态、进行中的决策、死路、后续事项,应写入 typmem-retro。判断标准:这件事在工作完成后是否仍然重要?是则属 learning,否则属 retro。
好 learning 的要点:原子化(一个文件一个事实,三个事实写三个文件);无“我”、无时间线、无故事;自包含,未参与该工作的人也能看懂;具体可执行,是约束、坑、模式或事物运作方式,而非模糊印象。例如把日记句“今天花两小时折腾 iii-engine 安装,二进制不断失败,最终放弃”转成配方卡“iii-engine 在此架构上没有预编译二进制——任何依赖它的东西都需要 Docker 回退方案”。
两种用法:一是直接捕获,已有明确事实时直接写一个 learning 文件;二是从 retro 提取,指向某个 retro 文件(或 ~/.typmem/memory/retro/ 中最新一个),读取后抽出每条持久事实,每条事实写一个 learning 文件,需提炼而非照搬叙述。
写法:先确保目录存在:mkdir -p ~/.typmem/memory/learnings;提炼事实并做上述判断,若只对当前会话有意义则停止,应写 typmem-retro;用事实本身生成 slug,小写 kebab-case,2–6 个词,无空格(如 iii-engine-no-prebuilt-binary、aca-sidecar-no-host-network);目标文件为 ~/.typmem/memory/learnings/<slug>.md,无日期前缀,因为 learning 是永恒的,只有 retro 文件名带日期。写入 frontmatter:author、reviewer、created(YYYY-MM-DD),reviewer 留空;留空只表示 typmem-judge 尚未查看,不代表不可用,本技能不要填写 reviewer。正文以配方卡形态陈述事实,简短自包含,可用自由散文,暂无固定模板,保持无“我”、无时间线。若同名 slug 文件已存在,多半是同一事实,可细化为更具体的 slug,或更新已有文件而非新建近似重复。自动去重后续由 typmem-judge / 索引搜索处理,目前靠判断。从 retro 提取时,对每条持久事实重复步骤 2–7。
文件规则:位置 ~/.typmem/memory/learnings/;文件名 <slug>.md,无日期前缀;MVP 的 frontmatter 含 author、reviewer(留空,由 typmem-judge 查看后填写)、created;一个文件一个事实。
禁止事项:不要在此写会话叙述、状态或发生经过(属 typmem-retro);不要自行填写 reviewer,那是 typmem-judge 的职责;不要把多条事实塞进一个文件,应拆分以便独立评审与提升;不要从此技能把 learning 提升到 precedents/,那是人工评审步骤,由后续技能处理。