# convex-sentinel

Настраивает сбор ошибок продакшена прямо в базу данных деплоя Convex. Помогает отслеживать падения функций, сбои React и сигналы масштабирования без отправки логов сторонним сервисам.

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

## Что делает

Скилл помогает подключить пакет `@convex-dev/sentinel` к проекту на Convex. Ошибки серверных функций, падения клиентского кода React, события `window.onerror`, необработанные промисы и сигналы OCC записываются в отдельную таблицу внутри вашего облачного деплоя. Данные не покидают проект.

Скилл добавляет вызов `app.use(sentinel)` в файл `convex/convex.config.ts` и связывает клиентский React error boundary со сбором цепочки действий breadcrumbs. Для защиты данных маскирование ключей и шаблонов секретов включено по умолчанию прямо на этапе записи. Это критично: агент передаёт прочитанные ошибки модели ИИ.

Через Convex CLI можно читать свежие инциденты или настроить реакцию на событие `prod_error`. При желании подключается фоновый cron-скрипт: задача `triage` разбирает ошибки и передаёт повторяющиеся сбои в `ai-runner`, чтобы открыть pull request с исправлением. Для отслеживания реальных сбоев потребуется развёрнутое облачное приложение Convex.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add convex/agent-skills --skill convex-sentinel -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add convex/agent-skills --skill convex-sentinel -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add convex/agent-skills --skill convex-sentinel -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install convex/agent-skills convex-sentinel
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add convex/agent-skills --skill convex-sentinel -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/convex/agent-skills --path skills/convex-sentinel
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add convex/agent-skills --skill convex-sentinel -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/convex/agent-skills/tree/HEAD/skills/convex-sentinel/SKILL.md

## Когда брать
- перехватывать серверные сбои и клиентские падения React в таблицу Convex
- маскировать токены и секреты при записи логов
- настроить реакцию на событие `prod_error` через Convex CLI
- запускать `ai-runner` для создания pull request при регулярных ошибках

## Примеры запросов агенту
- Подключи convex-sentinel к проекту и настрой перехват ошибок в convex/convex.config.ts
- Настрой клиентский React error boundary и сбор breadcrumbs через Sentinel
- Включи cron-задачу triage для автоматической подготовки исправлений через ai-runner

## Похожие
- [convex-realtime](https://affpapa.org/nevibecode/skills/convex-realtime.md) — скилл · 2900 установок
- [convex](https://affpapa.org/nevibecode/skills/mindrally-convex.md) — скилл · 651 установка
- [convex-migrations](https://affpapa.org/nevibecode/skills/convex-migrations.md) — скилл · 2600 установок
- [sentry-debug-issue](https://affpapa.org/nevibecode/skills/sentry-debug-issue.md) — скилл · 1900 установок
- [sentry-nextjs-sdk](https://affpapa.org/nevibecode/skills/sentry-nextjs-sdk.md) — скилл · 3600 установок
- [adding-error-tracking](https://affpapa.org/nevibecode/skills/adding-error-tracking.md) — скилл · 386 установок

Из того же набора: [convex/agent-skills](https://affpapa.org/nevibecode/by/convex/agent-skills.md) — 32 карточки

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

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