SuperAPI AI 工具集

analyze-sessions

编程与开发

查看项目

更新于 10-16 02:38

技能介绍

用途:analyze-sessions 是面向插件贡献者的开发专用工具,用于分析 Claude Code 会话,发现插件改进机会。它通过结构化流水线处理会话记录,产出分析报告与改进建议。

主要能力:发现 ~/.claude/projects/*/ 下的 JSONL 会话文件,按文件大小排序(作为会话丰富度代理),排除已分析会话;提取结构化 JSON;按会话规模分配子代理分析;可选地压缩并生成综合改进报告;最后更新会话索引。

使用方式:命令为 /analyze-sessions,参数包括 count(必填,首个位置参数,指定分析会话数)、--project NAME(按项目过滤)、--synthesize(分析后压缩并生成更新报告)。示例:/analyze-sessions 20、/analyze-sessions 50 --project some-project、/analyze-sessions 30 --synthesize。

流水线:1) 发现会话,按大小降序,排除 session-index.json 中已分析项;2) 选取前 N 个未分析会话;3) 运行 python3 {SKILL_DIR}/references/extract-session.py <session.jsonl> <output.json> 提取,批量模式先建 sessions 列表 JSON 再执行 python3 {SKILL_DIR}/references/extract-session.py --batch sessions.json scratchpad/session-extracts/;4) 用 analysis-template.md 生成子代理分析,按工具调用数选择代理(>100 用 sonnet,30-100 用 haiku,<30 每 5 个批量用 sonnet);5) 若 --synthesize,运行 python3 {SKILL_DIR}/references/condense.py scratchpad/session-reports/ scratchpad/condensed.md;6) 用 Opus 代理读取 condensed.md 与现有报告,生成更新报告;7) 追加新会话 ID 到 session-index.json。

输出位置:提取 JSON 在 scratchpad/session-extracts/,分析报告在 scratchpad/session-reports/,压缩结果在 scratchpad/condensed.md,综合报告在 .claude/UPDATED_PLUGIN_REPORT_{total}_SESSIONS.md。

适用场景:插件贡献者分析会话以改进插件。限制:仅开发用途,非通用工具;依赖本地会话文件与脚本;具体效果、收费与平台支持暂未提供。