Initial commit

skills/bugsnag/README.md

@@ -0,0 +1,97 @@
+# Bugsnag Skill
+
+Skill для интеграции с Bugsnag API, позволяющий просматривать и управлять ошибками в проекте.
+
+## Возможности
+
+- 🏢 **Управление организациями** - Просмотр списка доступных организаций в Bugsnag
+- 📦 **Управление проектами** - Просмотр списка доступных проектов
+- 📋 **Просмотр текущих ошибок** - Получение списка активных ошибок из Bugsnag
+- 🔍 **Детальный контекст ошибки** - Просмотр полной информации об ошибке включая stack trace
+- ✅ **Управление статусами** - Пометка ошибок как выполненные (resolved)
+- 📈 **Анализ паттернов** - Автоматический анализ повторяющихся ошибок
+- 🔐 **Безопасная авторизация** - Использование API ключей из переменных окружения
+
+## Использование
+
+### Быстрый доступ (Slash Commands)
+
+Рекомендуется для частых операций:
+
+```bash
+# Работа с ошибками
+/bugsnag:list              # Список всех ошибок
+/bugsnag:list --limit 50   # С фильтрами
+/bugsnag:open              # Только открытые ошибки
+/bugsnag:details ERROR_ID  # Детали ошибки
+
+# Комментарии
+/bugsnag:comments ERROR_ID         # Просмотр комментариев
+/bugsnag:comment ERROR_ID "text"   # Добавить комментарий
+
+# Управление
+/bugsnag:fix ERROR_ID      # Отметить ошибку как исправленную
+
+# Обзор
+/bugsnag:projects          # Список проектов
+/bugsnag:orgs              # Список организаций
+```
+
+### Естественный язык (Skill)
+
+Альтернативный способ через естественный язык:
+
+```
+"показать bugsnag ошибки"
+"bugsnag открытые ошибки"
+"bugsnag детали для error_123"
+"показать комментарии для bugsnag ошибки abc123"
+"добавить комментарий к bugsnag ошибке abc123: investigating"
+"список проектов bugsnag"
+"отметить ошибку ERROR_ID как исправленную"
+"проанализируй bugsnag ошибки"
+```
+
+### Прямой вызов скрипта
+
+Для автоматизации и скриптинга:
+
+```bash
+# Обзор
+./bugsnag.rb organizations   # Список организаций
+./bugsnag.rb projects         # Список проектов
+
+# Работа с ошибками
+./bugsnag.rb list            # Список всех ошибок
+./bugsnag.rb open            # Только открытые ошибки
+./bugsnag.rb details ERROR_ID # Детали конкретной ошибки
+
+# Комментарии
+./bugsnag.rb comments ERROR_ID           # Показать комментарии
+./bugsnag.rb comment ERROR_ID "message"  # Добавить комментарий
+
+# Управление
+./bugsnag.rb resolve ERROR_ID # Отметить как выполненную
+./bugsnag.rb analyze         # Анализ паттернов ошибок
+```
+
+### Настройка
+
+#### Как получить API ключ
+
+1. Перейдите в [Bugsnag Dashboard](https://app.bugsnag.com)
+2. Настройки → Organization → API Authentication
+3. Создайте Personal Access Token с правами на чтение ошибок
+4. Получите ID проекта из настроек проекта
+
+#### Переменные окружения
+
+```bash
+export BUGSNAG_DATA_API_KEY="your_api_key_here"
+export BUGSNAG_PROJECT_ID="your_project_id_here"
+```
+
+## Подробная документация
+
+Полное описание команд и примеры использования см. в [SKILL.md](SKILL.md).
+