SuperAPI AI 工具集

session-historian

智能体与模型

查看项目

更新于 10-15 22:40

技能介绍

用途:回查此前 Claude Code 会话中发生了什么,适合“我忘了之前做过什么”“上次会话里发生了什么”等场景。它索引并搜索原始 JSONL 记录,并缓存会话摘要。

主要能力:脚本位于 .claude/skills/session-historian/scripts/session_query.py,可直接运行(带 shebang 和 PEP 723)。支持 list(列出会话)、messages(读取某会话的用户消息原文)、search(跨原始文件搜索主题)、show(查看会话元数据与文件路径)、index(建立索引),以及 errors(列出会话中的工具错误)、tools(统计工具调用次数与成功/失败)、irritation(检测用户纠正用语与卡住的工具循环)、current-path(打印当前实时会话的 JSONL 路径)。

索引与摘要:索引位于 ~/.claude/kaizen/session-index.duckdb(sessions 与 user_messages 表),摘要缓存于 ~/.claude/kaizen/session-summaries/。索引在首次 list 或显式执行 index 时构建,不会自动保持最新,需要重新运行 index 或加 --rebuild 才能纳入新会话。生成摘要时先运行 show 获取元数据与文件路径,读取原始 JSONL,按模板生成结构化摘要写入 ~/.claude/kaizen/session-summaries/<session-id>.md,再用 mark-summarized <session-id> 在索引中标记。

保真规则:先读实际 JSONL 文件,不要凭元数据猜测;用户消息逐字复制,绝不转述;保留计数(如“3 个子代理,2 个成功,1 个被阻塞”);区分“记录中未提及”和“没有发生”;用 search 读取原始 JSONL 而非摘要,不要用摘要核实事实。

限制:资料未提供其他功能说明、收费、价格或平台支持信息,暂未提供。