android-crash-analyzer

Imported from xtone/ai_development_tools (android_development/.claude/skills/android-crash-analyzer/SKILL.md). Install upstream with npx skills add xtone/ai_development_tools --skill android-crash-analyzer. Copyright stays with the author.

Android Crash Analyzer

Firebase Crashlyticsのスタックトレースを解析し、トリアージ分類→根本原因分析→修正提案を出力する Claude Code スキルです。

目的

クラッシュ対応ワークフローを標準化し、対応品質と速度を向上させる:

• 対処不要なクラッシュを即座に切り分け（MONITOR）
• 修正可能なバグには具体的なコード修正を提案（FIX）
• システム例外には防御的ハンドリングを提案（DEFEND）
• パターンをCLAUDE.mdに蓄積し、同じクラッシュの再分析を防止

Quick Reference

トリアージ分類マトリクス

判定フロー

スタックトレース入力
  → タイプ判定（ANR/error/crash）
    → アプリフレーム有無
      → MONITOR / INVESTIGATE / FIX / DEFEND

トリガー

• /crash-analyze <file_path> — 指定ファイルのスタックトレースを解析
• /crash-analyze — ファイルパス入力を促す
• 「このクラッシュを分析して」「スタックトレースを解析して」等の自然言語

System Instructions

ユーザーが Firebase Crashlytics のスタックトレース解析をリクエストした場合、以下の手順に従ってください:

ステップ0: 入力取得・ヘッダー解析

ファイルパスが指定されている場合

Read ツールでファイルを読み込む。大容量ファイル（1000行超）の場合、最初に先頭100行のみ読み込み、その後 Grep でアプリフレームを抽出する。

ペースト入力の場合（ファイルなし）

ユーザーが直接貼り付けたスタックトレースからそのまま解析を開始する。

ヘッダー情報の抽出

ファイル先頭7行程度から以下を抽出:

パッケージ名が不明な場合: Glob で **/AndroidManifest.xml を検索し、package= 属性から取得する。フォールバックとして build.gradle* の applicationId を使用。

ステップ1: タイプ分類

以下の優先順で判定:

1. ファイル名パターン（最優先）:

• _ANR_ を含む → ANR
• _error_ を含む → error（Non-fatal）
• _crash_ を含む → crash（Fatal）

2. フォールバック（ファイル名なし/ペースト入力）:

• 本文に ANR / Application Not Responding → ANR
• 本文先頭が Exception / Error でプロセス終了なし → error
• 本文に FATAL EXCEPTION / Process: ... has stopped → crash
• 判定不能 → unknown（ユーザーに確認）

ステップ2: スタックトレース構造解析

ステップ0で取得したパッケージ名を使い、スタックトレース内のアプリフレームを特定:

# アプリフレームの検索
パッケージ名（例: jp.co.nttdocomo.dmenunews）を含む行を抽出

判定基準:

• アプリパッケージ名を含む at 行が 1行以上 → アプリコードあり
• アプリパッケージ名を含む行が 0行 → アプリコードなし

Caused by チェーン: 複数の Caused by: がある場合、最後の Caused by を根本原因として扱う。

ProGuard難読化の検出: 単一文字のクラス名（at a.b.c.d(Unknown Source)）を検出した場合:

⚠️ ProGuardで難読化されたスタックトレースです。
mapping.txt を使用してデコードしてから再分析することを推奨します:
$ retrace mapping.txt stacktrace.txt

ステップ3: トリアージ分類

ステップ1のタイプとステップ2のアプリフレーム有無から、Quick Reference のマトリクスに従い判定する。

crash + アプリコードありの場合の追加判定:

• 例外クラスがアプリ固有（アプリパッケージ内の例外） → FIX
• 例外クラスが java.lang.* / kotlin.* でアプリコードが直接の原因 → FIX
• 例外クラスがシステム/フレームワーク例外（android.os.*, android.app.* 等）でアプリコードは呼び出し元 → DEFEND

システム例外の例:

• android.os.DeadSystemException
• android.os.TransactionTooLargeException
• android.view.WindowManager$BadTokenException
• java.lang.SecurityException（権限関連）
• android.os.DeadObjectException

ステップ4: 分析

判定結果に応じて分析を実行:

MONITOR の場合

理由を簡潔に説明し、モニタリング方針を提示:

## クラッシュ分析レポート

**判定**: 🔍 MONITOR
**タイプ**: {ANR/error/crash}
**例外**: {例外クラス名}: {メッセージ}

### 理由
{対処不要と判断した理由}

### モニタリング方針
- 発生頻度が急増した場合に再調査
- 影響バージョン: {version}
- Issue: {hash}

INVESTIGATE の場合（ANR + アプリコードあり）

ANRのアプリフレームを特定し、メインスレッドブロック箇所を分析:

## クラッシュ分析レポート

**判定**: 🔎 INVESTIGATE
**タイプ**: ANR

### メインスレッドブロック箇所
{アプリフレームからの推定箇所}

### コードベース調査
{対象ファイルのRead結果に基づく分析}

### 修正提案
{具体的な修正方法}

FIX の場合

アプリフレームを特定し、コードベースを検索して修正を提案:

## クラッシュ分析レポート

**判定**: 🐛 FIX
**タイプ**: {error/crash}
**例外**: {例外クラス名}: {メッセージ}

### 根本原因
{最後のCaused byチェーンとアプリフレームの分析}

### 対象コード
`{ファイルパス}:{行番号}`

### 修正提案
{修正前/修正後のコード}

DEFEND の場合

システム例外を特定し、防御的ハンドリングを提案:

## クラッシュ分析レポート

**判定**: 🛡️ DEFEND
**タイプ**: crash
**例外**: {システム例外名}: {メッセージ}

### 原因
{システム例外が発生する条件の説明}

### 防御コード提案
{try-catch等の防御的ハンドリングコード}

ステップ5: 修正提案生成

FIX / DEFEND の場合、以下を実行:

1. ステップ4で特定したアプリフレームのファイルパスを Grep/Glob で検索
2. 対象ソースファイルを Read
3. 修正前/修正後のコードを提示

### 修正前
```kotlin
// {file_path}:{line}
{現在のコード}

修正後

// {file_path}:{line}
{修正後のコード}

修正理由

{なぜこの修正が必要か}

### ステップ5a: ANRプロアクティブスキャン

ANR + アプリコードなし（MONITOR判定）の場合、コードベースを自動スキャンしてANR原因となりうるパターンを検出:

| パターン | 検索対象 | 推奨修正 |
|---------|---------|---------|
| メインスレッドでのネットワーク | `URL(...).openStream()` / `openConnection()` タイムアウト未設定 | OkHttp + タイムアウト設定 |
| 同期SharedPreferences | `SharedPreferences.commit()` | `apply()` に変更 |
| メインスレッドブロック | `runBlocking`（非テストコード） | `launch` / `async` に変更 |
| 大容量画像デコード | `BitmapFactory.decode*`（Dispatchers.IO外） | `withContext(Dispatchers.IO)` |
| 同期ContentResolver | `contentResolver.query/insert/update/delete`（コルーチン外） | `withContext(Dispatchers.IO)` |

Grep で各パターンを検索し、検出結果があれば報告:

```markdown
### ANRプロアクティブスキャン結果

コードベースをスキャンし、ANRの潜在的原因を検出しました:

| 箇所 | パターン | リスク |
|------|---------|------|
| `{file}:{line}` | {パターン名} | {説明} |

ステップ6: パターン蓄積（オプション）

分析完了後、ユーザーに確認の上、CLAUDE.md の ## Crash Patterns セクションに追記する。

蓄積フォーマット

## Crash Patterns

このセクションはクラッシュ分析パターンから自動生成されました。
`/crash-analyze` コマンドで更新できます。

### 非アクション対象
- `{例外名}: {メッセージ}` は{理由}。アクション不要
  - 📊 Issue {hash} (v{version}) — {date}

### バグ修正
- `{例外名}: {メッセージ}` — {根本原因の要約}
  - 🐛 Issue {hash} (v{version}) — {date}

### 防御的ハンドリング
- `{例外名}` — {条件}にtry-catch必要
  - 🛡️ Issue {hash} (v{version}) — {date}

セクションの配置

• ## Crash Patterns セクションがあればそこに追記
• なければ ## CI Learnings の後に作成
• どちらもなければ CLAUDE.md 末尾に新規作成

重複チェック

追記前に既存の ## Crash Patterns セクションを確認し、同一 Issue hash または同一例外パターンが既に記録されている場合はスキップ。

エラーハンドリング

エラー1: ファイルが見つからない

指定されたファイルが見つかりません: {file_path}
パスを確認してください。

エラー2: スタックトレースではないファイル

このファイルはスタックトレースではないようです。
Firebase Crashlyticsからエクスポートした .txt ファイルを指定してください。

エラー3: パッケージ名が特定できない

アプリのパッケージ名を特定できませんでした。
AndroidManifest.xml が見つかりません。パッケージ名を教えてください。

エラー4: ProGuard難読化

⚠️ ProGuardで難読化されたスタックトレースです。
mapping.txt を使用してデコードしてから再分析することを推奨します:
$ retrace mapping.txt stacktrace.txt

重要事項

• CLAUDE.mdはプロジェクト全体で共有されるファイル。慎重に編集すること
• 既存の内容は変更しない（追記のみ）
• Issue hash とバージョンを必ず残す（追跡可能性）
• 追記・変更は必ずユーザーの承認を得てから実行する
• 大容量ANRファイル（1000行超）は全文Readせずヘッダー + Grepで処理
• Caused by チェーンは最後のものを根本原因として扱う
• ProGuard難読化を検出した場合は mapping.txt 使用を案内

互換性

Agent Skills (Open Standard)

このスキルは Agent Skills オープンスタンダードに準拠しています。

対応ツール:

• Claude Code
• GitHub Copilot
• VS Code
• Cursor (Nightly)
• OpenAI Codex

.claude/skills/ ディレクトリに配置することで、上記すべてのツールで使用可能です。

バージョン

v1.0 - 初回リリース (2026-02-25)

• トリアージ分類マトリクス（MONITOR/INVESTIGATE/FIX/DEFEND）
• ANR/Non-fatal/Fatal 全タイプ対応
• ANRプロアクティブスキャン（5パターン）
• Caused by チェーン解析
• ProGuard難読化検出
• 大容量ファイル対応（1000行超）
• CLAUDE.md Crash Patterns 蓄積機能
• すべての説明を日本語で記述