用途:从 Claude Code 会话调试日志中提取可执行信号,适用于反思周期、事故响应或诊断智能体失败。
主要能力:自动检测最近日志并复制到 .tmp/ 后原地压缩;按类别归类错误模式(Hook 拦截、读取失败、Token 溢出、流式中断、智能体掉线、工具错误等);对高频错误在完整日志中交叉检索上下文;输出结构化 Markdown 报告。
使用方式:无独立工具脚本,需在智能体上下文中调用。自动模式运行 node scripts/reduce-debug-log.mjs;手动模式可指定会话 UUID 或日志路径,并配合 --output 指定输出。分析前先复制日志,再运行 reducer,读取压缩结果,分类错误,对前 3 类错误在完整副本中 grep 并读取前后 10 行上下文,最后写入 .claude/context/reports/reflections/debug-log-analysis-{YYYY-MM-DD}.md,并将新错误模式写入 .claude/context/memory/issues.md。
限制:日志格式存在已知可观测性缺口,如 Hook 拒绝原因未记录、错误行缺少智能体身份、读取失败路径缺失、流式中断无归因、成功调用几乎不记录;需借助时间戳关联或查看 hook 源码等变通方式。不得直接操作原始日志,不得仅凭单次 grep 匹配下结论。