用途：解析 pi agent 的会话 JSONL 文件（存放于 ~/.pi/agent/sessions/<project>/），把原始记录转成可读输出，便于回顾、排查和分析会话。
主要能力：提供多种查看模式。toc 输出带时间戳和所用工具编号的交换列表；conversation（默认）只显示用户消息与助手文本，工具调用以 [used: ...] 提示；turn 展示某一轮的全部细节，含思考、工具调用、工具结果与成本；issues 查找错误、失败、重试和用户抱怨；overview 给出元数据与交换摘要；full 包含工具输入输出；tools 只看工具调用与结果；costs 按轮显示 token 用量与成本；subagents 查看子代理任务、状态、成本与路径。
使用方式：先定位会话，如 ls -t ~/.pi/agent/sessions/<project>/*.jsonl | head -10；再运行 uv run ${CLAUDE_SKILL_ROOT}/scripts/read_session.py <path> --mode toc 获取目录；随后用默认模式阅读对话，或加 --offset、--limit、--search、--turn、--max-content 等参数筛选与钻取。子代理会话文件可用同一脚本读取。典型流程为 toc → conversation → turn → subagents。
适用场景：回顾某次会话发生了什么、定位出错环节、分析工具调用与成本、审查委派给子代理的工作。
限制：仅适用于 pi agent 的 JSONL 会话格式；需要 uv 运行脚本；--max-content 默认每块 3000 字符，0 表示不限；仅在需要自定义解析时才参考 references/session-format.md。其余细节暂未提供。