# 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).