SuperAPI AI 工具集

session-log-analyzer

智能体与模型

查看项目

更新于 10-16 07:25

技能介绍

用途:解析 Claude Code 的 JSONL 会话日志,还原一次会话中发生了什么,包括工具调用、Token 用量、错误、子智能体树和压缩事件。基于 claude-devtools 会话解析引擎的模式。

调用方式:Skill({ skill: 'session-log-analyzer' }); 适用于调试失败会话、分析成本与 Token 用量、了解哪些工具占用最多上下文、追踪子智能体执行、定位压缩发生位置。

主要能力与用法:

  1. 定位日志:日志位于 ~/.claude/projects/{encoded-path}/.jsonl,其中 {encoded-path} 是项目目录把 / 替换为 -。可用 ls ~/.claude/projects/ 列出目录,用 ls -lt ~/.claude/projects/$(pwd | sed 's|/|-|g; s|^-||')/.jsonl | head -5 找最近会话,或用 find ~/.claude/projects/ -name "*.jsonl" -newer /tmp/yesterday -type f 按日期查找。
  2. 解析分类消息:每行是带 type 字段的 JSON 对象,类型有 user、assistant、system、progress(hook 输出)。可用 grep -o '"type":"[^"]*"' SESSION.jsonl | sort | uniq -c | sort -rn 统计。
  3. 提取工具调用清单:tool_use 出现在 assistant 消息,tool_result 出现在 user 消息。可统计 tool_use 数量、按 name 分组计数,并用 grep '"is_error":true' SESSION.jsonl 找错误。
  4. 估算 Token:日志含每轮 usage 数据,可提取 input_tokens、output_tokens 求和;无数据时按内容大小估算(字符数 / 4)。
  5. 检测子智能体:Task 工具调用会派生子智能体,可提取 subagent_type 与 task_id 构建调用树。
  6. 检测压缩边界:上下文压缩表现为相邻轮次 input_tokens 骤降,可提取序列观察相邻值间超过 30% 的下降。
  7. 生成摘要报告:包含总轮数、工具调用计数、估算 Token、发现的错误、子智能体树、压缩事件。

记忆协议(强制):开始前执行 cat .claude/context/memory/learnings.md 与 cat .claude/context/memory/decisions.md;完成后将新模式写入 learnings.md、问题写入 issues.md、决策写入 decisions.md。假定上下文可能被重置,未写入记忆即视为未发生。

限制:资料未提供该技能的安装方式、依赖、支持平台、收费与效果保证等信息,暂未提供。