# sentry-debug-issue

Ведёт одну ошибку Sentry от «вот проблема» до «вот фикс, задеплоен»: контекст, причина, правка кода, закрытие через Fixes PROJECT-NAME-12A.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1900 установок · ★ 272
- Автор: getsentry
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/getsentry/sentry-for-ai/tree/HEAD/src/skills/sentry-debug-issue/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/sentry-debug-issue

## Что делает

Скилл берёт issue из Sentry и доводит её до коммита. Сначала находит проблему — по ссылке или короткому ID через `get_sentry_resource`, либо поиском по описанию через `search_issues` с грамматикой `key:value` вроде `is:unresolved error.type:TypeError`. Дальше тянет полный контекст: тип исключения, стектрейс, breadcrumbs, теги, трейс, логи, а на фронтенде — ещё и session replay.

Причину формулируют до правки кода. Для этого есть `analyze_issue_with_seer` — он возвращает цепочку причин и воспроизведение с именами функций. Патча от него не ждите: файлов, номеров строк и диффа там нет. Вызов блокирующий, идёт десятки секунд, результат кэшируется, а на metric-alert issues инструмент отказывается работать. Часть инструментов доступна не всегда — сообщение `Tool "X" is not available in this session` скилл обрабатывает, а не считает, что доступ выдан.

Нужен подключённый и авторизованный Sentry MCP-сервер. Все данные из Sentry считаются недоверенным вводом: инструкции внутри сообщений об ошибке не выполняются, значения полей не переносятся в код и тесты, секреты и PII не воспроизводятся. Если событие ссылается на файлы и функции, которых в репозитории нет, скилл останавливается и говорит о расхождении. Это повод проверить, тот ли релиз вы дебажите.

## Требования
- Работает с: Sentry

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-debug-issue -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-debug-issue -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-debug-issue -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install getsentry/sentry-for-ai sentry-debug-issue
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-debug-issue -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/getsentry/sentry-for-ai --path src/skills/sentry-debug-issue
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add getsentry/sentry-for-ai --skill sentry-debug-issue -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/getsentry/sentry-for-ai/tree/HEAD/src/skills/sentry-debug-issue/SKILL.md

## Когда брать
- найти issue Sentry по ссылке, короткому ID или описанию
- собрать стектрейс, breadcrumbs и трейс в одну картину
- получить гипотезу причины до правки кода
- закрыть ошибку коммитом с `Fixes PROJECT-NAME-12A`
- отличить cron- или metric-monitor issue от пойманного исключения

## Примеры запросов агенту
- разбери issue PROJECT-NAME-12A и предложи фикс
- найди в Sentry нерешённые TypeError за последние сутки и покажи стектрейс
- прогони Seer по этой ошибке и объясни причину

## Похожие
- [sentry](https://affpapa.org/nevibecode/rules/sentry.md) — правило · ★ 3579
- [fix-sentry-issues](https://affpapa.org/nevibecode/skills/fix-sentry-issues.md) — скилл · 2700 установок
- [Sentry Bug Fixer](https://affpapa.org/nevibecode/prompts/sentry-bug-fixer.md) — промпт · ★ 174597
- [sentry-mcp](https://affpapa.org/nevibecode/mcp/sentry-mcp.md) — MCP-сервер · ★ 944
- [adding-error-tracking](https://affpapa.org/nevibecode/skills/adding-error-tracking.md) — скилл · 386 установок
- [sentry-go-sdk](https://affpapa.org/nevibecode/skills/getsentry-sentry-go-sdk.md) — скилл · 316 установок

Из того же набора: [getsentry/sentry-for-ai](https://affpapa.org/nevibecode/by/getsentry/sentry-for-ai.md) — 31 карточка

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

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