用途：分析 Claude Code 的 JSONL 会话记录，检测工具误用、重复错误、低效流程与可自动化改进点。记录位于 ~/.claude/projects/ 下按项目路径命名的目录中，包含主会话、孤立智能体、子智能体记录及异步任务输出。
主要能力：按 JSONL 记录类型（assistant、user、system、progress、file-history-snapshot、summary）分析。检测 Bash 中本应使用 Grep/Glob/Read/Edit 的命令；归类重复错误（未读先改、替换目标过期、权限拒绝、预提交钩子失败、命令缺失）；通过工具序列三元组发现缺失脚本或技能；分析 Task 子智能体委派与模型选择；比较同一目标成功与失败路径的步数差异；识别被放弃的调查分支；定位 compact_boundary、api_error 等系统中断对执行的影响；发现重复人工纠正（3 次以上）对应的钩子机会。
使用方式：通过 kaizen-analysis 的 get_transcript_jsonl_schema 或 resources/read kaizen://session-log/schema 获取字段路径，再用 kaizen-duckdb execute_query 对 JSONL 执行任意 DuckDB SQL（使用 read_ndjson_auto 与绝对路径，SQL 中不可用 ~）。复杂分析可用 MCP 工具 extract_tool_sequences、discover_process_model、check_conformance、find_frequent_patterns、cluster_sessions。结果写入 .planning/kaizen/analysis-DATE.md，含会话 ID、日期、严重级别、证据字段与值、出现频率、建议类型（hook、skill patch、agent prompt、CLAUDE.md 更新）。
限制：资料未提供具体命令示例之外的完整代码、平台要求或性能数据；部分功能依赖 kaizen-analysis 与 kaizen-duckdb MCP 服务可用。