用途:在完成任何有意义的任务后,从交互中提炼可复用的模式、教训与洞见,并持久化保存,避免下次从零开始。核心原则是“解决难题却不记录发现,等于下次重新解决”。
主要能力:提供反思、提炼、去重、持久化、修剪的捕获流程;按类别记录有效模式、失败与补救、用户偏好、项目专属知识;使用带日期、上下文、洞见、置信度、确认次数的条目结构;支持去重与矛盾条目替换;当同类洞见累积到 3 次以上确认时,可形成“信念”,并建议提升为项目 CLAUDE.md 规则。
使用方式:任务完成后依次执行 REFLECT(发生了什么、有何意外)、DISTILL(抽象出通用模式)、DEDUPLICATE(是否已记录、是否矛盾)、PERSIST(写入对应记忆文件并附日期与上下文)、PRUNE(删除被新证据推翻的旧条目)。存储位置为 Claude Code 记忆系统 ~/.claude/projects/[项目]/memory/,文件包括 effective-patterns.md、failure-analysis.md、project-map.md、human-preferences.md。会话开始时读取全部记忆文件,识别未综合的洞见簇、标记可能过期的条目、提示可提升的信念。
适用场景:交付复杂功能、解决顽固缺陷、收到评审反馈、被用户纠正、大幅修改计划、通过试错发现代码库约定之后。
限制:一行式琐碎修复、未产生新信息的交互、用户明确拒绝时可例外,但需与人类确认。禁止跳过反思、禁止无日期无上下文记录、禁止未经用户同意自动写入 CLAUDE.md、禁止重复记录、禁止保留被新证据推翻的条目、禁止记录实现细节而非通用模式。信念提升必须获得用户同意,人类是永久规则的最终决定者。
该技能与其他技能双向集成:历史失败分析可支持故障诊断,捕获的约定可强化模式匹配,过往测试失败可影响测试策略,过往计划失败可避免重蹈覆辙;评审反馈、验证失败、走查发现、计划执行结果也会反哺本技能。