用途:分析最近的 /define 会话记录,提取用户处理 /define 访谈时的模式,并写入 CLAUDE.md 的 ## /define Preferences,使后续 /define 会话自动看到这些偏好。
主要能力:按探询提示、权衡默认值、反复不变量、流程指导、质量门调整、其他六类组织模式;跨会话合并语义等价模式并标注频率;暴露会话间矛盾并附证据;区分项目特定与可泛化模式;写入前展示差异预览。
使用方式:会话 JSONL 位于 ~/.claude/projects/{project-path-encoded}/{session-id}.jsonl。可用 $ARGUMENTS 指定会话数量,否则取足够近期会话。每个会话由 define-session-analyzer 代理独立分析,输出到 /tmp/define-learn-{session-id}.md。聚合后询问写入目标(项目 CLAUDE.md、用户 ~/.claude/CLAUDE.md 或两者),展示预览并获明确批准后写入。
限制:未经用户明确批准绝不写入 CLAUDE.md;已有段落必须合并而非覆盖;仅用标准 Markdown(##、###、-、<!-- date -->);写入前必须展示差异;聚合完成后删除 /tmp 临时文件;无会话时提示先运行几次 /define;损坏文件跳过并警告。未来 /define 会话中,用户模式与内置任务文件指导冲突时以用户模式优先。每条模式带 <!-- YYYY-MM-DD --> 日期注释,用户可直接编辑 CLAUDE.md 删除。