用途:在项目内跨会话保存学习经验,避免重复踩坑。学习条目写入 .claude/learnings.jsonl(项目级,必须加入 .gitignore),每行一个 JSON 对象,追加写入。
主要能力:四种类型 pattern(已验证模式)、pitfall(已踩的坑)、preference(团队偏好)、architecture(架构约束)。字段包括 type、kebab-case 的 key(同 key 后写覆盖前写)、一句话 insight、1-10 的 confidence、files 列表、source(auto/manual)、ISO-8601 的 ts。
使用方式:/learn 按类型显示最近 20 条;/learn search <query> 搜索 key 与 insight;/learn prune 做交互式清理(过时、矛盾、去重);/learn export 导出按类型分组的 markdown;/learn add 手动添加,必须指定 type、key、insight、confidence,files 与 ts 可选。其他技能可在调试定位根因、采纳新模式、确认偏好、做架构决策时自动记录,source 为 auto,confidence 默认 5。
限制:不记录一次性任务细节、未经验证的信息或临时猜测;用户明确要求不写入时不得记录。条目超过 1000 条需 prune;confidence 不应全为 10;key 必须 kebab-case;insight 不超过一到两句。JSONL 格式错误、type 非枚举、confidence 越界需按规则修复或拒绝写入。
本技能前置加载 CANON.md,相关 URL 为 https://www.skills.sh/zeroz-lab/unified-skills/maintain-workflow-learn 。