98 lines
4.1 KiB
Markdown
98 lines
4.1 KiB
Markdown
# 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).
|
||
|