# firebase-crashlytics

Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 674 у репозитория
- Автор: Ivanna Kaceviča
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/evanca/flutter-ai-rules/tree/HEAD/skills/firebase-crashlytics/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/ivanna-kacevica-firebase-crashlytics

## Что делает

Скилл объясняет, как захватывать ошибки из разных источников: фатальные через `FlutterError.onError`, асинхронные через `PlatformDispatcher.instance.onError`, isolate-ошибки через `addErrorListener`. Агент научится добавлять в отчёты кастомные ключи (до 64 пар, каждая до 1 kB), логи (лимит 64 kB на сессию) и пользовательские идентификаторы. Crashlytics хранит только последние восемь нефатальных исключений за сессию — остальные отбрасывает.

Для обфусцированных сборок агент знает, что iOS с Flutter 3.12.0+ и плагином 3.3.4+ загружает символы автоматически, а для Android нужна Firebase CLI версии 11.9.0 и выше и команда `firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/symbols`. Скилл показывает, как отключить сбор данных в debug-режиме через `setCrashlyticsCollectionEnabled(false)` и как реализовать opt-in: по умолчанию Crashlytics собирает отчёты автоматически, но можно выключить автосбор и включать вручную, когда пользователь даёт согласие — настройка сохраняется между запусками.

Для проверки настройки агент вызовет `FirebaseCrashlytics.instance.crash()`, пересоберёт приложение в release-режиме, перезапустит его и проверит дашборд Firebase Console через пять минут.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add evanca/flutter-ai-rules
```
В чате агента (не в терминале):
```text
/plugin install flutter-ai-skills@flutter-ai-rules
```
Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill firebase-crashlytics -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/firebase-crashlytics/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/firebase-crashlytics/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill firebase-crashlytics -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/firebase-crashlytics/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill firebase-crashlytics -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/firebase-crashlytics/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install evanca/flutter-ai-rules skills/firebase-crashlytics
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/firebase-crashlytics/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add evanca/flutter-ai-rules --skill firebase-crashlytics -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/evanca/flutter-ai-rules --path skills/firebase-crashlytics
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/firebase-crashlytics/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/evanca/flutter-ai-rules/tree/HEAD/skills/firebase-crashlytics/SKILL.md

## Когда брать
- захватывать фатальные ошибки Flutter и асинхронные исключения
- логировать isolate-ошибки и записывать нефатальные исключения с контекстом
- добавлять в отчёты кастомные ключи, сообщения и идентификаторы пользователей
- загружать символы обфусцированных сборок для читаемых стектрейсов
- настроить opt-in сбор данных и отключить Crashlytics в debug-режиме

## Примеры запросов агенту
- Настрой Firebase Crashlytics во Flutter-проекте и захватывай фатальные ошибки через `FlutterError.onError`
- Добавь в отчёт Crashlytics кастомный ключ `user_action` со значением `payment_completed`
- Загрузи символы обфусцированной Android-сборки в Crashlytics через Firebase CLI

## Похожие
- [firebase-ai-logic-basics](https://affpapa.org/nevibecode/skills/firebase-ai-logic-basics.md) — скилл · 146900 установок
- [firebase-apk-scanner](https://affpapa.org/nevibecode/skills/firebase-apk-scanner.md) — скилл · 6000 установок
- [firebase-development](https://affpapa.org/nevibecode/plugins/firebase-development.md) — плагин · ★ 106 у репозитория
- [firebase-remote-config-basics](https://affpapa.org/nevibecode/skills/firebase-remote-config-basics.md) — скилл · 132400 установок
- [firebase-basics](https://affpapa.org/nevibecode/skills/firebase-basics.md) — скилл · 14100 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
