AntigravityでFirebase Crashlyticsのクラッシュ解析を自動化する

# crash_fetcher.py
from google.cloud import bigquery
from datetime import datetime, timedelta
 
def get_top_crashes(project_id: str, app_id: str, days: int = 7) -> list[dict]:
    """
    Crashlyticsの直近N日間の致命的クラッシュ上位10件を取得する。
    app_idはFirebaseコンソールの「プロジェクト設定」>「全般」から確認できる。
    例: "1:123456789012:ios:abcdef1234567890"
    """
    client = bigquery.Client(project=project_id)
 
    # BigQueryのテーブル名はapp_idの":"を"_"に置換した形式
    table_id = app_id.replace(":", "_")
    dataset = f"{project_id}.firebase_crashlytics"
    table = f"{dataset}.{table_id}"
 
    query = f"""
    SELECT
        issue_id,
        issue_title,
        issue_subtitle,
        COUNT(*) AS crash_count,
        ARRAY_AGG(
            STRUCT(
                application.display_version AS version,
                device.manufacturer AS manufacturer,
                device.model AS model,
                os.display_version AS os_version,
                ARRAY(
                    SELECT CONCAT(frame.file, ':', CAST(frame.line AS STRING))
                    FROM UNNEST(exceptions[OFFSET(0)].frames) AS frame
                    WHERE frame.file IS NOT NULL
                    LIMIT 10
                ) AS stack_frames
            )
            ORDER BY event_timestamp DESC
            LIMIT 3
        ) AS recent_examples
    FROM `{table}*`
    WHERE
        _TABLE_SUFFIX BETWEEN
            FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL {days} DAY))
            AND FORMAT_DATE('%Y%m%d', CURRENT_DATE())
        AND is_fatal = TRUE
    GROUP BY issue_id, issue_title, issue_subtitle
    ORDER BY crash_count DESC
    LIMIT 10
    """
 
    results = client.query(query).result()
    return [dict(row) for row in results]
 
if __name__ == "__main__":
    crashes = get_top_crashes(
        project_id="your-firebase-project-id",
        app_id="1:000000000000:ios:aaaaaaaaaaaaaaaa"  # 実際のapp_idに変更
    )
    for crash in crashes:
        print(f"[{crash['crash_count']}件] {crash['issue_title']}")
    # 出力例:
    # [247件] Fatal Exception: NSInvalidArgumentException
    # [89件] Fatal Exception: EXC_BAD_ACCESS SIGSEGV

# crash_analyzer.py
from crash_fetcher import get_top_crashes
 
def format_crash_for_ai(crash: dict) -> str:
    """
    Antigravityへのプロンプトとして、Crashlyticsレポートを構造化する。
    スタックトレースに件数・デバイス情報・具体的な質問を添えることが精度向上のカギ。
    """
    examples = crash.get("recent_examples", [])
 
    # 上位デバイス・OS情報をまとめる
    devices = list({
        f"{ex['manufacturer']} {ex['model']} (OS {ex['os_version']})"
        for ex in examples
        if ex.get("manufacturer")
    })[:3]
 
    # 最新クラッシュのスタックトレース（先頭10フレーム）
    stack_frames = []
    if examples and examples[0].get("stack_frames"):
        stack_frames = examples[0]["stack_frames"]
 
    prompt = f"""
## Crashlyticsクラッシュ解析依頼
 
**発生件数（直近7日）:** {crash['crash_count']}件
**エラータイプ:** {crash['issue_title']}
**サブタイトル:** {crash.get('issue_subtitle', 'N/A')}
**主な発生環境:** {', '.join(devices) if devices else '不明'}
 
**スタックトレース（最新クラッシュ・先頭10フレーム）:**
{chr(10).join(f'  {i+1}. {frame}' for i, frame in enumerate(stack_frames))}
 
**依頼事項:**
1. このクラッシュの根本原因として最も可能性の高い箇所を特定してください
2. コードベース内で修正すべきファイル・メソッドを示してください
3. 修正アプローチを3つ提案してください（優先度順）
4. 最小再現手順を推測してください
"""
    return prompt
 
if __name__ == "__main__":
    crashes = get_top_crashes("your-firebase-project-id", "1:000000000000:ios:aaaaaaaaaaaaaaaa")
 
    # 上位3件をAntigravityに渡すプロンプトとして出力
    for i, crash in enumerate(crashes[:3], 1):
        print(f"\n{'=' * 60}\n### クラッシュ #{i}")
        print(format_crash_for_ai(crash))