Claude 会话使用报告
把 Claude Code 会话数据整理成可交互的 HTML 使用报告。
技能明确读取 ~/.claude/projects 中的会话转录并生成包含项目、提示词、技能和子代理信息的 HTML，但未说明用户确认、敏感信息脱敏、访问范围隔离、临时文件清理或回滚；仅使用本地捆绑脚本，未见恶意外传证据，因此保留基础分但因数据暴露和恢复控制不足扣分。
步骤、脚本参数、去重逻辑和异常数据处理在源代码中较具体，正常路径可理解；但未提供针对关键路径的测试，依赖 Node.js、用户目录结构和可编辑工具，且权限、缺失文件、损坏转录和失败反馈覆盖不足；静态评估按上限限制，扣除可复现性与边界处理分。
目标是分析 Claude Code 会话使用情况，输入、时间范围和输出形式较清楚；但未明确不适用场景、权限前置条件、触发边界或中文界面/报告支持。核心功能是本地处理，不依赖中国大陆不可达的海外服务，因此未作网络可达性扣分。
SKILL.md 结构清晰，包含步骤、参数示例、输出位置、模板约束和大 JSON 处理说明；仓库提供 Apache-2.0、官方维护背景和 CI 信号，但该技能本身缺少安装前置条件、版本策略、变更记录、已知限制、故障排查和明确维护责任，故未接近满分。
技能直接产出自包含 HTML，并要求填充异常与优化建议，预期结果可直接查看；但未提供代表性输出或静态可验证的结果样例，且报告质量依赖转录结构、模板存在和人工叙述判断，仍可能需要审阅和修正，因此按静态上限并扣除完整性保障分。
分析器源代码、参数和数据字段提供了可审计的一手证据，去重和统计意图也有注释；但未见覆盖该技能关键路径的提交测试、真实 CI 执行证据或第三方复核，静态结论无法独立验证，因此仅给有限可验证性。
- 该技能会把本地 Claude 会话中的提示词、项目名、技能和子代理统计嵌入报告；运行前应确认工作目录及报告访问者不会接触敏感信息。
- 未定义转录目录缺失、权限不足、JSON 损坏、脚本或模板缺失时的用户可理解错误处理。
- 报告通过固定的 /tmp/session-report.json 中间文件传递数据，可能产生并发覆盖或残留风险。
- 仅凭源文件无法确认实际统计准确性、HTML 可渲染性或所有关键路径已执行验证。
它能做什么 & 适用场景
Session Report 从 Claude Code 项目转录文件中分析会话使用情况。它统计令牌、缓存、子代理、技能和高消耗提示词，并生成自包含的 HTML 报告。报告默认覆盖最近 7 天，也支持自定义时间范围或全量数据。它适合需要检查使用模式、缓存表现和会话成本分布的 Claude Code 用户。
运行随技能附带的 analyze-sessions.mjs，从 ~/.claude/projects 中读取 Claude Code 转录文件，并将分析结果输出为 JSON。随后读取 overall、by_project、by_subagent_type、by_skill、cache_breaks 和 top_prompts 等数据，将其嵌入随附的 template.html。技能还会在当前工作目录创建带时间戳的 session-report-YYYYMMDD-HHMM.html，并填充异常发现和优化建议。
- 需要了解最近一周令牌消耗、缓存命中情况和项目分布的 Claude Code 用户。
- 需要定位高消耗提示词或单次调用成本异常的开发者。
- 需要比较不同子代理类型或技能使用量的团队成员。
- 需要查看缓存中断集中出现在哪些会话或时间段的用户。
- 需要将本地 Claude Code 使用数据导出为可浏览 HTML 报告的用户。
优缺点一览
- 输出自包含 HTML，包含表格、条形图和可展开的明细。
- 覆盖项目、子代理、技能、缓存中断和高消耗提示词等多个维度。
- 支持最近 7 天、自定义时间范围和全量分析。
- 依赖本地 ~/.claude/projects 中存在可读取的 Claude Code 转录文件。
- 需要 Node.js，但源材料未说明最低版本。
- 只生成报告，不提供自动告警、远程同步或数据清理功能。
- 源材料未提供测试套件或跨平台验证信息。
如何安装
该技能位于 anthropics/claude-plugins-official 的 plugins/session-report/skills/session-report/ 目录。仓库 README 说明插件可通过 Claude Code 的插件系统安装，命令格式为 /plugin install {plugin-name}@claude-plugins-official；该资料没有明确给出此技能对应的已发布插件名称，因此具体安装名未在源材料中说明。
如何使用
在已安装技能的 Claude Code 环境中，请求生成会话使用报告；可指定时间范围，例如 24h、30d 或 all。默认分析最近 7 天，并在当前工作目录保存 HTML 文件。源材料未规定固定的触发短语。