用途:从 Claude 会话记录中提取决策、经验与失败教训,形成可复用的学习记录,闭合知识循环。通常由 SessionStart 钩子自动运行,也可手动触发。
主要能力:检查待处理队列、把会话摘要转化为结构化学习文件、校验必填字段并报告结果、清空队列。自动流程:ao forge --last-session --queue 把上个会话入队到 pending.jsonl,下一会话启动时执行 ao extract 处理队列并写入 .agents/learnings/。
使用方式:自动执行时钩子调用 ao extract 2>/dev/null;手动可执行 ao extract 或查看 cat .agents/ao/pending.jsonl 前几行。若无 ao CLI,可手动处理:检查 .agents/ao/pending.jsonl,遍历 .agents/forge/*.md 候选文件,按模板提取后写入 .agents/learnings/YYYY-MM-DD-<topic>.md,高置信项(>=0.7)可直接晋升,随后清空队列 > .agents/ao/pending.jsonl。
学习文件模板字段:标题 # Learning:、ID、Category(debugging|architecture|process|testing|security)、Confidence(high|medium|low),以及 What We Learned、Why It Matters、Source 段落。写入后做字段校验,无效文件只记录警告,不删除、不重试。处理完成后执行 ao extract --clear 并汇报提取数量、关键洞察与文件位置。
限制:依赖 ao CLI 或人工回退流程;队列未清空会导致重复提取;类别与置信度取值固定,文档未提供其它平台或收费信息。