用途:对项目会话历史做多会话回顾分析,适用于里程碑之后、开启新阶段前、怀疑愿景漂移时,或每 3-5 个会话定期检查。
主要能力:发现并校验会话导出(~/.claude/exports/{project-name}/*.txt),检测已有回顾文档,按需为每个新导出派发并行后台 historian 代理,再综合为结构化分析。两种模式:full 输出独立 ANALYSIS(超集,可删除旧回顾);incremental 输出增量 UPDATE(引用旧回顾,不可删除旧回顾)。参数支持无参数(上下文感知默认)、full、since-last-retro、last-N。
使用方式:historian 使用 Agent 工具、model 为 opus、subagent_type 为 general-purpose、run_in_background 为 true,按 9 点提取模板(会话如何开始、原始意图与实际、关键决策、用户纠正、错误与反模式、质量时刻、路线图演变、交付物、交接)输出 markdown 文本数据,不写文件。综合后写入 docs/retros/YYYY-MM-DD-PROJECT-HISTORY-ANALYSIS.md(full)或 docs/retros/YYYY-MM-DD-PROJECT-HISTORY-UPDATE.md(incremental),更新 MEMORY.md 并提交。
限制:无导出目录或 .txt 文件时立即停止;部分导出缺失则继续并标注缺口。incremental 无基线时自动切换 full。已有回顾覆盖的会话不重复派发 historian。historian 失败重试一次,仍失败则继续并标注缺口,不得猜测。反模式包括单代理处理全部导出、压缩 historian 报告、跳过用户纠正、从 MEMORY.md 写作、用 TeamCreate、用 Haiku/sonnet、只做摘要而非提取、incremental 重析旧会话、incremental 后删除旧回顾等。具体收费、平台与效果资料暂未提供。