用途:把项目知识沉淀为随项目成长的 LEARNING.md 活文档,并在修复非平凡缺陷、做出架构决策、引入新技术、解决棘手问题或切换上下文前更新。
主要能力:LEARNING.md 包含项目概览、架构(mermaid 图)、技术栈与决策(Technology | Why | Trade-offs 表格)、经验教训(按日期:Context → Problem → Solution → Takeaway)、坑与陷阱、发现的最佳实践。写作强调对话式语气、类比、具体例子、诚实记录错误,避免干巴巴的技术文风。
使用方式:先读取或创建 LEARNING.md,用 git log --oneline -10 回顾近期工作,询问学到了什么、哪里棘手,再按日期追加新教训。可复用修复写入 docs/solutions/[category]/YYYY-MM-DD_short-description.md,分类含 auth、performance、infrastructure、database、testing、debugging,格式为 Problem / Solution / Why It Works。LEARNING.md 用于叙事性复盘与架构决策,solutions/ 用于具体可搜索的修复。
会话分析:会话文件位于 ~/.claude/projects/(项目路径中斜杠转连字符)。禁止直接读取原始会话文件,必须用 jq 提取摘要,关注模式而非单条消息,例如统计工具调用次数、重复读取、错误模式,进而提出 CLAUDE.md 更新、新技能、脚本、钩子等改进。
限制:若 obsidian CLI 不可用则跳过镜像,不使用路径回退,仓库内 LEARNING.md 为权威来源;工作项目镜像到 vault 时须排除客户名称、内部主机名与架构细节、未发布产品信息及 NDA 内容,存疑时仅保留在仓库。资料未提供安装命令、收费与平台信息。