Session Evaluator

郡嶋が開発した、Claude Codeセッションの効率を分析・スコアリングするWebツール。

概要

セッションログ（JSONL）を解析し、7つの観点から100点満点でスコアリングする。 「品質」ではなく「無駄の有無」に焦点を当てた評価で、セッション効率の改善に役立つ。

起動方法

# このスキルのappディレクトリから起動
cd <skill-dir>/app && npm install && npm start

# ポート指定
cd <skill-dir>/app && npm start -- --port 8080

起動するとブラウザが自動で開く（デフォルト: http://localhost:5173）。

使い方

1. プロジェクト選択 — 左パネルに ~/.claude/projects/ 配下のプロジェクト一覧
2. セッション選択 — 中央パネルでセッションを選択（最新順）
3. 分析実行:
   • Analyze — Claude CLIでAI評価を実行（7観点スコアリング）
   • Stats Only — 統計データのみ表示（Claude CLI不要）
4. モデル選択 — 評価に使うClaudeモデルを切り替え可能（sonnet / opus / haiku）
5. History — 過去の評価履歴を表示・管理

評価の7観点（100点満点）

観点	配点	内容
A. 重複作業	/15	同一ファイル重複読み込み、複数回書き直し、subagentとの作業重複
B. トークン効率	/15	入力トークン量、キャッシュ活用率、大型ツール結果によるコンテキスト肥大
C. 目的外作業	/20	ユーザー指示と無関係なファイル操作、頼まれていない改善
D. 初動の的確さ	/15	タスクに適した初手を取れているか
E. エラー回復効率	/10	エラー後に原因分析せず即リトライしていないか
F. 不要な探索	/15	目的に不要なファイル読み込み、過剰なGlob/Grep
G. モデル選定	/10	タスク複雑さに対してモデルが適切か

スコア目安: 平均的なセッションは50〜65点。70点超えは本当に無駄のないセッションのみ。

必要環境

• Node.js 18以上
• Claude CLI（claude コマンドがPATHに通っていること）— Analyzeモードのみ
• Stats Onlyモードであれば Claude CLI なしでも利用可能

改善提案カテゴリ

評価結果には以下のカテゴリで改善提案が出力される（優先度順）:

1. hook — 機械的に検出・防止できる問題
2. rule — Claudeの判断基準に関わる問題
3. skill — 複数ステップの手順が毎回同じパターンで必要な場合
4. command — ユーザーが任意のタイミングで手動実行したい定型処理

プロジェクト構成

app/
├── bin/cli.js             # CLIエントリポイント
├── src/
│   ├── server.js          # Expressサーバー + APIルーティング
│   ├── session-finder.js  # セッションログの検出・一覧取得
│   ├── analyzer.js        # JSONL解析・統計レポート生成
│   ├── evaluator.js       # Claude CLI呼び出し・スコアリング
│   └── history.js         # 評価履歴の保存・読み込み
├── public/
│   ├── index.html         # セッション選択UI
│   └── results.html       # 評価結果表示UI
└── package.json