History Insight

Claude Code セッションの履歴を分析し、インサイトを抽出します。

Data Location

~/.claude/projects/<encoded-cwd>/*.jsonl

Path Encoding: /Users/foo/project → -Users-foo-project

詳細なファイルフォーマット: ${baseDir}/references/session-file-format.md

Execution Algorithm

Step 1: Ask Scope [MANDATORY]

スコープの決定:

1. 明示されている場合 (AskUserQuestion を省略可能):

   • "現在のプロジェクトのみ" / "このプロジェクト" → current_project
   • "すべてのセッション" / "全体" → all_sessions

2. 明示されていない場合 - AskUserQuestion を呼び出し:

   question: "セッション検索範囲を選択してください"
   options:
     - "現在のプロジェクトのみ" → ~/.claude/projects/<encoded-cwd>/*.jsonl
     - "すべての Claude Code セッション" → ~/.claude/projects/**/*.jsonl

Step 2: Find Session Files

# Current project only
find ~/.claude/projects/<encoded-cwd> -name "*.jsonl" -type f

# All sessions (すべてのプロジェクト)
find ~/.claude/projects -name "*.jsonl" -type f

日付フィルタリング: ファイルの mtime(修正時間) を確認後、フィルタします。OS 別の stat オプションが異なります:

• macOS: stat -f "%Sm" -t "%Y-%m-%d" <file>
• Linux: stat -c "%y" <file>

Step 3: Process Sessions

Decision Tree

Session files found?
├─ No → Error: "No sessions found"
└─ Yes → How many files?
    ├─ 1-3 files → Direct Read + parse
    └─ 4+ files → Batch Extract Pipeline

1-3 Files

直接 Read で JSONL をパースします。ファイルが大きい場合(≥5000 tokens) は extract-session.sh を使用します:

${baseDir}/scripts/extract-session.sh <session.jsonl>

4+ Files: Batch Extract Pipeline

1. キャッシュディレクトリを作成します (/tmp/cc-cache/<analysis-name>/)
2. セッションリストを保存します (sessions.txt)
3. jq でメッセージを一括抽出します (user_messages.txt)
4. 整理およびフィルタリングを行います (clean_messages.txt)
5. Task(opus) で総合分析を行います

ファイルが大きすぎる場合: 並列バッチ分析

clean_messages.txt が大きすぎて Read に失敗する場合:

1. ファイルを分割:

   split -l 2000 clean_messages.txt /tmp/cc-cache/<name>/batch_

2. 並列 Task(opus) 呼び出し:

   Task(subagent_type="general-purpose", model="opus", run_in_background=true)
   prompt: "batch_XX ファイルを読み、主題/パターンを要約して"

3. 結果をマージ: Task(opus) で総合

Step 4: Report Results

## Session Capture Complete

- **Sessions:** N files processed
- **Messages:** X total, Y after filter

### Extracted Insights
[分析結果]

Error Handling

Security Notes

• 出力に全体のパスを露出させない (~ prefix を使用)

Related Resources

• ${baseDir}/scripts/extract-session.sh - JSONL 圧縮 (thinking, tool_use を削除)
• ${baseDir}/references/session-file-format.md - JSONL 構造およびパース