check-skill-log-patterns

Skill ログパターン検証

概要

Claude Code のセッションログに記録される Skill 実行パターンを検証する。 ログフォーマットは Claude Code のバージョンアップで変わる可能性があるため、 claude -p でスキルを実行してログを生成し、既知パターンと照合する。

ツール構成

scripts/
├── run_and_dump.sh       # claude -p でスキルを実行し、セッションログを出力
└── analyze_patterns.py   # ログを分類して差分レポートを生成

使い方

スキルディレクトリ: .claude/skills/check-skill-log-patterns

1. スキルを実行してログを出力

# /skill-test を実行し、生成されたセッションログを全行出力
./scripts/run_and_dump.sh /skill-test

# skill関連のエントリのみ出力
./scripts/run_and_dump.sh -s /skill-test

# 引数付きスキル
./scripts/run_and_dump.sh -s /head go.mod

# raw JSONL で出力（jq等にパイプしやすい）
./scripts/run_and_dump.sh -r -s /skill-test

2. パイプで解析

# 実行 → 抽出 → 解析を一発で
./scripts/run_and_dump.sh -r /skill-test | python3 scripts/analyze_patterns.py --stdin

# skill関連のみ抽出して解析
./scripts/run_and_dump.sh -r -s /skill-test | python3 scripts/analyze_patterns.py --stdin

3. 既存ログを解析（実行せずに）

# 直近7日のログを解析
python3 scripts/analyze_patterns.py

# 直近1日、サブエージェント含む
python3 scripts/analyze_patterns.py --days 1 --include-subagents

# 特定セッション
python3 scripts/analyze_patterns.py --session SESSION_UUID

# 生JSON付きで詳細出力
python3 scripts/analyze_patterns.py --days 1 --verbose

4. ログを直接確認（jq）

# run_and_dump.sh の出力を jq で整形
./scripts/run_and_dump.sh -r -s /skill-test | jq .

# 特定フィールドだけ抽出
./scripts/run_and_dump.sh -r -s /skill-test | jq '{type, isMeta, toolUseResult}'

解析レポートの読み方

analyze_patterns.py は以下を報告する:

• パターン別件数 — 3パターン（直接コマンド / toolUseResult / サブエージェント）ごとの検出数
• 新規フィールド — 既知のフィールドセットにないフィールドが検出された場合に表示
• 未分類エントリ — 既知パターンに当てはまらない Skill 関連ログ

期待される正常状態

新規フィールド: なし
未分類エントリ: なし

要対応

• 新規フィールド検出: スキーマ（docs/claude/schemas/）と既知フィールドセット（analyze_patterns.py）を更新
• 未分類エントリ: 新パターンの可能性。--verbose で生ログを確認し、docs/claude/README.md とGoコード（internal/claude/sessionlog.go）を更新

既知の3パターン

詳細は docs/claude/README.md を参照。

Pattern	発生条件	検出キー
1: 直接コマンド	/skill-name 入力	<command-name> + 次行 isMeta: true
2: 暗黙的 Skill	Claude が Skill ツールを選択	toolUseResult.commandName
3: サブエージェント	Agent 内で Skill 呼び出し	assistant tool_use → user tool_result ペア