用途:结束一次学习会话。它会将 Claude 在会话中的静默观察综合成一份回顾,供用户审阅;随后写入会话日志、更新课程状态并归档已完成的课程。适用于用户结束当天学习、想保存进度并停止,或由 /learn 在推迟或放弃课程时调用。
前提条件:必须存在活动课程 ~/.claude/learning/lessons/current.md。若不存在,提示用户:“No active lesson found. Nothing to close.”
流程:
- 读取状态:读取 current.md 与当前会话的观察(提示、困难、成功)。
- 展示回顾草稿:按固定格式列出“What you worked on”“Key learnings”“Struggled with”“Still fuzzy on”;空的部分也保留并写“Nothing notable — solid session!”。询问“Edit anything, add something I missed, or looks good?”并等待用户回应,不得在用户回复前继续。
- 判断课程状态:若全部里程碑完成,祝贺用户,状态 completed;否则询问处理方式:下次继续(保留 current.md,不归档)、推迟(归档为 postponed)、放弃(询问简短原因,归档为 abandoned)。
- 写会话日志:写入 ~/.claude/learning/logs/YYYY-MM-DD.md;同日已有该文件时使用 YYYY-MM-DD-2.md 等后缀;格式取自 ${CLAUDE_PLUGIN_ROOT}/skills/learning-data-spec.md,内容来自确认后的回顾。
- 更新课程状态:继续时更新 current.md 前置元数据中的 milestones_completed、将已完成里程碑标记为 [x]、追加会话日志条目;完成时移动到 lessons/archive/YYYY-MM-DD-<topic-slug>.md,设置 status: completed、closed、sessions,补上 ## Key Learnings 与 ## Still Fuzzy On,把 backlog.md 对应条目标记 [x],删除 current.md;推迟与放弃同样归档并设置相应状态与原因,保留里程碑进度与会话日志,最后删除 current.md。 5.5 更新洞察:以“update insights”模式调用 learning-insights 技能,传入困难、关键学习、仍模糊主题、会话中给出的提示与附带代码观察;它会更新 ~/.claude/learning/insights.md 并在有实质变化时返回一句话,展示后再进入确认步骤,无变化则静默继续。
- 确认:告知用户日志保存路径;如归档则告知归档状态与文件名;如继续则提示下次运行 /learn 从里程碑 X 继续。
注意事项:写文件前必须先展示回顾并获得用户确认;观察来自当前对话,若在新对话中调用 /end-learn(没有前置 /learn),需请用户描述其操作;logs/ 与 lessons/archive/ 目录不存在时创建;归档文件 slug 为小写、连字符、最长 50 字符。