# firebase-cloud-functions

Помогает агенту писать код для вызова Firebase Cloud Functions во 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-cloud-functions/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/firebase-cloud-functions

## Что делает

Скилл регламентирует интеграцию пакета `cloud_functions` во Flutter-проекты. Он учит агента использовать `httpsCallable`, передавать аргументы через `Map` и разбирать возвращаемый `result.data`. Правила запрещают передавать токены авторизации в параметрах вызова, потому что клиентский SDK добавляет их автоматически.

Шаблон охватывает перехват `FirebaseFunctionsException` с проверкой кодов вроде `unavailable` или `permission-denied`. В код закладываются таймауты через `HttpsCallableOptions` и выбор региона развёртывания с помощью `FirebaseFunctions.instanceFor`.

Для отладки без боевого окружения скилл перенаправляет запросы в Firebase Emulator Suite через `useFunctionsEmulator('localhost', 5001)`.

## Установка

### 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-cloud-functions -a claude-code
```

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- настроить вызов callable-функций Firebase из Flutter
- обработать ошибки сети и FirebaseFunctionsException
- переключить вызовы на локальный Firebase Emulator Suite
- задать регион развёртывания и таймаут выполнения

## Примеры запросов агенту
- Напиши вызов httpsCallable функции addMessage во Flutter с обработкой ошибок
- Подключи локальный эмулятор Firebase Functions на localhost:5001
- Настрой таймаут на 30 секунд для callable-функции в europe-west1

## Похожие
- [extension-to-functions-codebase](https://affpapa.org/nevibecode/skills/extension-to-functions-codebase.md) — скилл · 67500 установок
- [firebase](https://affpapa.org/nevibecode/skills/sickn33-firebase.md) — скилл · 1600 установок
- [firebase-development](https://affpapa.org/nevibecode/skills/firebase-development.md) — скилл · 732 установки
- [firebase-app-platform](https://affpapa.org/nevibecode/skills/firebase-app-platform.md) — скилл · 347 установок
- [firebase-cli](https://affpapa.org/nevibecode/skills/firebase-cli.md) — скилл · 332 установки
- [firebase-ai-logic-basics](https://affpapa.org/nevibecode/skills/firebase-ai-logic-basics.md) — скилл · 146900 установок

Из того же набора: [evanca/flutter-ai-rules](https://affpapa.org/nevibecode/by/evanca/flutter-ai-rules.md) — 39 карточек

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

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