session-analyzer

name	session-analyzer
effort	high
description	全 Claude セッションをスキャンし、ユーザーが何をしているかを分析して、 スキル・MCP プラグイン・エージェント・CLAUDE.md のどれに最適化すべきかを分類し、 具体的な改善提案（優先度・実装難易度・推奨アクション付き）を生成する。 Use when the user wants to analyze their Claude usage patterns, or when asked to "scrape sessions", "what do I do with Claude", or "what should be a skill vs agent vs claude.md".
argument-hint	[--days N] (デフォルト: 全期間)

Session Analyzer

全 Claude セッションのユーザーメッセージを抽出し、パターンを分析して最適化提案を行う。

実行手順

1. セッションデータ抽出

npx tsx "$HOME/.claude/skills/session-analyzer/scripts/extract-sessions.ts" > tmp/sessions-output.txt 2>&1

出力が大きいため tmp/sessions-output.txt に保存してから読む。

2. パターン分類

抽出したメッセージを以下の4カテゴリに分類する:

スキル (Skills) に向いているもの

• 繰り返し実行されるワークフロー（週次・日次のルーティン）
• 定型の手順があるもの（毎回同じステップを踏む）
• スラッシュコマンドで呼び出す明確なトリガーがあるもの
• 例: worklog 更新、1on1 準備、commit & push

MCP プラグイン に向いているもの

• 外部サービスとの永続的な接続が必要なもの
• 認証・セッション管理が必要なもの
• 双方向のリアルタイムデータが必要なもの
• 例: Notion, Slack, GitHub, Google Calendar への頻繁なアクセス

エージェント (Agents) に向いているもの

• 複数ステップの並列実行が必要なもの
• 長時間・高コストのタスクで main session を圧迫するもの
• 独立した文脈で動ける専門タスク
• 例: コードレビュー, モジュール移行, PR 修正

CLAUDE.md に入れるもの

• すべてのセッションで常に適用したいルール
• ツール選択の優先順位（jq 優先、git -C 禁止など）
• プロジェクト構造・命名規約
• 繰り返し修正を求めるパターン（Claude が同じ間違いを繰り返すもの）

3. レポート出力

分析結果を以下の形式でまとめる:

## セッション分析レポート

### 全体統計
- 期間: YYYY-MM-DD 〜 YYYY-MM-DD
- セッション数: N
- 主なプロジェクト: ...

### カテゴリ別分類

#### ✅ 既にスキル化されている
（現在のスキルと実際の使用状況を照合）

#### 🆕 スキル化を推奨
| パターン | 頻度 | 理由 |
|----------|------|------|

#### 🔌 MCP プラグイン化を推奨
| サービス | 用途 | 現在の方法 |
|----------|------|------------|

#### 🤖 エージェント化を推奨
| タスク | 並列化メリット | 推定コスト削減 |
|--------|--------------|----------------|

#### 📝 CLAUDE.md に追加を推奨
| ルール | 根拠（何度修正を求めたか） |
|--------|--------------------------|

4. 改善提案生成

分類結果をもとに、具体的なアクションを提案する。

優先度の判断基準:

• 高: 週3回以上繰り返している / Claude が同じ間違いを3回以上している
• 中: 週1〜2回 / 毎回手順を思い出すコストがかかる
• 低: 月1〜数回 / あると便利だが緊急ではない

各提案に以下を付与する:

提案	カテゴリ	優先度	実装難易度	推奨アクション
（観察されたパターン）	スキル/MCP/エージェント/CLAUDE.md	高/中/低	低/中/高	PR直接作成 / issue起票

推奨アクションの基準:

種別	推奨アクション
CLAUDE.md への追記（1行程度）	PR を直接作成
スキル説明文の改善	PR を直接作成
新スキル・新エージェント提案	GitHub issue を起票
大きなアーキテクチャ変更	GitHub issue を起票

5. 優先度トップ3

### 優先度トップ3
1. 最も ROI が高い改善（推奨アクション: ...）
2. 次点（推奨アクション: ...）
3. 3位（推奨アクション: ...）

注意

• セッションファイルにはプライベートな情報（コード・会議内容等）が含まれる
• 分析結果はローカルのみで処理し、外部送信しない
• 大量のセッションがある場合は直近 90 日に絞っても良い