用途：该技能用于分析 Claude 会话记录，将 .jsonl 转录文件与调试日志配对解析，输出 Markdown 格式的启发式分析报告，帮助定位 API 限制、上下文溢出、钩子拦截和工具调用失败等问题。
主要能力：定位目标会话（支持显式 --session <uuid> 或自动检测最近修改的 .jsonl）；从转录文件名提取会话 ID 并匹配 ~/.claude/debug/<uuid>.txt 调试日志；逐行解析 JSONL，统计用户消息、工具调用次数（按工具名累计频次）和工具失败（is_error === true）；解析调试日志中的 [ERROR]、BLOCKED、prompt is too long、SyntaxError: Unterminated string in JSON 等行；生成含概览指标、工具使用汇总、启发式发现、前 5 条工具失败的报告。
使用方式：运行 node scripts/analyze-session-transcript.mjs 或 pnpm debug:analyze；指定会话：node scripts/analyze-session-transcript.mjs --session f1326443-490f-486b-bb67-01c72bf42408；自定义输出：node scripts/analyze-session-transcript.mjs --out .claude/context/reports/backend/session-analysis-2026-03-10.md。默认输出到 .tmp/transcript-analysis-<uuid前8位>.md。
适用场景：排查 Claude 代理会话中的上下文超限、路由协议违规、钩子 JSON 解析失败及工具错误。
限制：缺少调试日志时仅告警并继续，启发式信号会缺失；工具失败内容截断至 150 字符；报告仅展示前 5 条工具失败；项目目录由 process.cwd() 推导，需在对应检出位置运行。具体收费、平台支持等信息暂未提供。