用途:Learnings System v2 是一套自我改进机制,围绕错误评分构建三层结构:Layer 1 Episodes 为原始追加日志 core/learnings/episodes.jsonl;Layer 2 Learnings 为评分条目 core/LEARNINGS.md(最多 30 条);Layer 3 Rules 为已晋升规则 rules.md / CLAUDE.md,仅所有者可编辑。
主要能力:引擎位于 ~/.claude/scripts/learnings-engine.mjs,通过环境变量 ENGINE="node ~/.claude/scripts/learnings-engine.mjs" 调用。支持 capture 记录新 episode、score 查看评分、lint 检查(HOT 频次 3+、STALE 评分低于 0.15、PROMOTE 评分高于 0.8)、promote 晋升规则、archive 归档、bump 增加频次、report 生成 Markdown 报告。
评分方式:综合分由 Recency(40%)+ Frequency(30%)+ Impact(30%)构成。Recency 为 max(0, 1 - ageDays / 30),30 天衰减到 0;Frequency 为 min(1, freq / 3),违规 3 次以上达满分;Impact 取值 critical=1.0、high=0.7、medium=0.4、low=0.1。阈值:评分大于 0.8 建议晋升规则;小于 0.15 建议归档;30 天内频次 3+ 触发警报,提示规则失效需改变系统。
记录时机:仅当所有者明确纠正(如“不,这样做”“错了”)、高代价错误(访问、安全、基础设施、数据)、重复模式(同一错误两次)或所有者设定新标准时记录。不记录普通澄清、选项选择、无模式的细微风格调整。Episode 采用 JSON 格式,含 id、ts、type、agent、source、context、error、rule、impact、tags、freq、status 等字段。
访问分区:GREEN 区(SKILL.md、TOOLS.md、LEARNINGS.md)代理可自主编辑;YELLOW 区(AGENTS.md、decisions.md)需说明理由;RED 区(rules.md、CLAUDE.md)仅所有者可编辑。频次 3+ 时按错误类型处置:忘记步骤加 hook,响应风格错误更新 CLAUDE.md 或 rules.md,用错工具更新 TOOLS.md,多余提问加规则,代码错误加测试或 lint 规则。
集成:SessionStart 注入评分前 5 条;Stop 分析会话纠正并自动捕获 episode;每周 cron 运行 lint 并报告给所有者。限制:仅所有者可晋升 RED 区规则;Learnings 最多 30 条;评分公式与阈值固定于上述资料。