iOS Crash Analysis - Multi-Agent Edition

Анализ краш-ошибок из Firebase Crashlytics с использованием трёх специализированных агентов.

ВАЖНО: ВСЕ ответы, анализы, отчёты и коммуникация ТОЛЬКО НА РУССКОМ ЯЗЫКЕ.

Multi-Agent Architecture

┌─────────────────────────────────────────────────────────────────┐
│                   /crash-report-ios                            │
└─────────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│  classifier  │───▶│  fetcher     │───▶│  forensics   │
│   iOS        │    │  (Firebase)  │    │   iOS        │
│  (Haiku)     │    │  (Haiku)     │    │  (Sonnet)    │
└──────────────┘    └──────────────┘    └──────────────┘

Workflow

ШАГ 0: Firebase Auto-Init (выполняется автоматически!)

Перед началом работы проверь и настрой Firebase:

1. Проверить окружение:
   mcp__plugin_crashlytics_firebase__firebase_get_environment

2. Если не авторизован:
   - Выведи сообщение: "⚠️ Firebase не настроен. Запускаю авторизацию..."
   - Вызови: mcp__plugin_crashlytics_firebase__firebase_login

3. Если нет активного проекта:
   - Вызови: mcp__plugin_crashlytics_firebase__firebase_list_projects
   - Выбери нужный проект
   - Вызови: mcp__plugin_crashlytics_firebase__firebase_update_environment

4. Получить app_id для iOS:
   - Вызови: mcp__plugin_crashlytics_firebase__firebase_list_apps(platform="ios")
   - Сохрани app_id для последующих вызовов

Если Firebase недоступен — продолжай с ручным вводом стектрейса (fallback mode).

ШАГ 1: Получи данные от пользователя

Попроси предоставить:

• Стектрейс (обязательно)
• Firebase Issue ID (если есть — для автозагрузки)
• Контекст: количество крашей, % пользователей, устройство, iOS версия

ШАГ 2: Вызови crash-classifier-ios

Task(
  subagent_type="crash-classifier-ios",
  model="haiku",
  prompt="Классифицируй этот iOS краш:

    Стектрейс:
    {stack_trace}

    Контекст:
    - Событий: {event_count}
    - Пользователей: {user_count}%
    - Версия: {app_version}
    - Устройство: {device}
    - iOS: {ios_version}
  "
)

Ожидаемый вывод:

priority: critical/high/medium/low
crash_type: Fatal error / SIGABRT / NSException
component: UI/Network/Database/Services/Background
trigger: user_action/background_task/lifecycle_event/async_operation

ШАГ 3: Вызови firebase-fetcher (опционально)

Если предоставлен Firebase Issue ID:

Task(
  subagent_type="firebase-fetcher",
  model="haiku",
  prompt="Получи детали краша из Firebase:

    Issue ID: {issue_id}
    App ID: {app_id} (iOS)
  "
)

Если Firebase недоступен — агент вернёт fallback mode, продолжай с ручным вводом.

ШАГ 4: Вызови crash-forensics-ios

Task(
  subagent_type="crash-forensics-ios",
  model="sonnet",
  prompt="Проанализируй iOS краш с git blame:

    Классификация: {classifier_output}
    Данные Firebase: {firebase_output}
    Стектрейс: {stack_trace}
  "
)

Агент выполнит:

1. Поиск Swift/Objective-C файлов в codebase
2. Git blame анализ
3. Определение assignee
4. Предложение фикса (Swift/Objective-C)

ШАГ 5: Вывод результатов

Агент crash-forensics-ios вернёт два формата:

Формат 1: Детальный анализ

• Базовая информация
• Анализ стектрейса
• Проверенные файлы с git blame
• Корневая причина
• Решение (before/after в Swift/Objective-C)
• Assignee с обоснованием
• Контекст и предотвращение

Формат 2: JIRA Brief

• Название и проблема
• Ключевые строки стектрейса
• Корневая причина (1-2 предложения)
• Фикс кода (ready to copy-paste)
• Приоритет, файл, assignee
• Воспроизведение

Fallback режим (если агенты недоступны)

Если Task tool не может вызвать агентов, выполни анализ напрямую:

1. Классификация: Определи тип, приоритет, компонент, триггер
2. Поиск файлов: Glob/Grep по классам из стектрейса
3. Git blame: git blame -L X,Y file.swift
4. Assignee: Выбери 2-3 кандидата с обоснованием
5. Фикс: Предложи code-level решение (Swift/Objective-C)
6. Вывод: Детальный анализ + JIRA Brief

Критерии приоритета

Priority	Когда	Примеры
🔴 Critical	Платежи/Авторизация/Безопасность, >5% пользователей	Force unwrap nil в PaymentProcessor, Keychain errors
🟠 High	Важные функции 1-5% пользователей, новые краши	Nil unwrap в главном экране, Index out of range
🟡 Medium	Редкие <1% пользователей, некритичный функционал	Optional edge cases, Background task failures
🟢 Low	Single occurrence, non-blocking	Логирующие ошибки

iOS Специфичные паттерны крашей

Force unwrap nil (самый частый!)

// ❌ Краш
let name: String? = nil
print(name!)  // Fatal error: Unexpectedly found nil

Index out of range

// ❌ Краш
let items = [1, 2, 3]
let item = items[5]  // Fatal error: Index out of range

Main thread checker

// ❌ Краш
DispatchQueue.global().async {
    self.label.text = "Hello"  // UI on background thread!
}

Чеклист перед отправкой

✅ ОБЯЗАТЕЛЬНО ПРОВЕРЬ:

• Классификация выполнена (priority, component, trigger)
• Файлы .swift/.m найдены через Glob/Grep или причина объяснена
• git blame выполнен с реальными командами
• Assignee определен с источником (git blame строка X)
• Два формата отчета (Детальный + JIRA)

🚫 НЕ ОТПРАВЛЯЙ ЕСЛИ:

• Поиск кода не выполнен
• Нет git blame для найденных файлов
• Assignee = "TBD" без анализа
• Только один формат отчета

Пример использования

Пользователь: /crash-report-ios

Claude: 🔍 iOS Crash Analysis - Multi-Agent

Пожалуйста, предоставьте:
1. Стектрейс (обязательно)
2. Firebase Issue ID (если есть)
3. Количество крашей и % пользователей
4. Устройство и iOS версия

---

[Пользователь предоставляет данные]

Claude:
📊 Шаг 1: Классификация...
[Вызывает crash-classifier-ios]

📡 Шаг 2: Загрузка из Firebase...
[Вызывает firebase-fetcher]

🔬 Шаг 3: Git blame анализ...
[Вызывает crash-forensics-ios]

✅ Анализ завершён

### Детальный анализ
[...(detailed analysis)]

### JIRA Brief
[...(JIRA format)]

Важно

Git blame + поиск кода = ОБЯЗАТЕЛЬНО
"TBD" = "я проанализировал и ownership неясен", НЕ "я не проверил"
Задокументируй точные выполненные команды
Каждый отчёт должен иметь git blame с выводом