用途：该技能用于向 AI 助手传授可跨会话保留的经验教训，把单次事故抽象为通用失败模式后写入未来会话会读取的载体。
主要能力：捕获经验；按复发性和自动修复可能性做筛查（可被评审或 lint 自动发现的不记录）；将教训路由到最合适位置——属于项目事实（路径、运行命令、模块映射、工具选择等）写入 docs/project-config.json（经 $project-config），属于规则或模式写入对应的 docs/project-reference/ 文档；评估预防深度（文档、配置、提示规则、钩子、测试或技能更新）；保存后执行 Learn Review、$why-review 与 $prompt-enhance 收尾。
用法示例：$learn always use the validation framework fluent API instead of throwing ValidationException、$learn list、$learn remove 3、$learn clear。配置字段名可运行 node .claude/hooks/lib/project-config-schema.cjs --describe 查看，写入配置优先经由 $project-config 而非手工编辑 JSON。
适用场景：纠正 AI 反复出现的错误、把团队约定或反模式固化为可被未来任务读取的文档或配置。
限制：应先泛化再保存，不得直接保存具体个案；需确认目标文件后再写入，避免重复条目；无既有配置字段时不得擅自新增顶层键；资料未提供具体收费、价格与平台信息。