К основному содержанию
скилл CX Codex

convex-sentinel — скилл для Claude Code: что делает и как установить

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add convex/agent-skills --skill convex-sentinel -a claude-code
Открыть на GitHub

Что делает 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.

Какие задачи решает

  • перехватывать серверные сбои и клиентские падения 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-sentinel

1Через Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-sentinel -a claude-code

2Вручную: положить файлы

~/.claude/skills/convex-sentinel/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/convex-sentinel/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о convex-sentinel

Как установить convex-sentinel в Claude Code?

Выполните в терминале команду npx skills add convex/agent-skills --skill convex-sentinel -a claude-code.

Куда сохраняются данные об ошибках?

Логи записываются в таблицу внутри вашего собственного деплоя Convex. Данные никуда не передаются на сторонние серверы.

Как convex-sentinel защищает приватные ключи и токены?

Маскирование выполняется при записи и активно по умолчанию. Оно блокирует названия ключей и шаблоны значений секретов до того, как агент передаст текст языковой модели.

Исходный текст

SKILL.md · Apache-2.0
---
name: convex-sentinel
description: "Set up Sentinel production error capture in your own Convex deployment."
---

<!-- GENERATED from convex-agents content/capabilities/sentinel.json — do not edit by hand. -->

# Capture production errors in your own deployment

Install `@convex-dev/sentinel` to capture production errors (server function failures, client JS/React crashes, OCC and scale signals) into a table in the user's OWN deployment, redacted at write time, then react to new ones. Data never leaves the user's deployment.

## Workflow

1. Install the component: `app.use(sentinel)` in `convex/convex.config.ts`.
2. Wire the client SDK: a React error boundary plus `window.onerror`/`unhandledrejection` and breadcrumbs.
3. Redaction runs at write time and is on by default (default-deny on secret key names and value patterns).
4. Read recent errors with the Convex CLI (`convex data`, `run-once-query`); react to new ones via the monitor's `prod_error` event.
5. Optionally enable the self-healing cron: `triage` classifies each error and, for recurring non-transient ones, hands it to ai-runner to open a fix PR.

## Rules

- Redaction is mandatory and on by default — never store raw secrets; the agent's reads reach the model provider.
- Data stays in the user's deployment; never send it to a third party.
- Sample and cap to control volume and cost.
- Capturing PROD errors needs a deployed cloud app; install works anonymously.

© convex · Apache-2.0 · convex/agent-skills

Похожие скиллы

Всё по теме «Бэкенд и API» →
convex-realtime waynesutton Скилл объясняет, как связать фронтенд с подписками Convex: useQuery, оптимистичные обновления, живая пагинация и борьба с лишними ререндерами. CX Codex +1 2 900установок convex Mindrally Задаёт агенту правила работы с Convex: запросы, мутации, actions, индексы и файлы. Пригодится, когда бэкенд на Convex уже выбран. CX Codex +1 651установок convex-migrations waynesutton Проводит изменение схемы Convex через шесть шагов: сделать поле необязательным, залить данные батчами, переключить валидатор, подчистить. Пригодится, когда npx convex dev падает на существующих документах. CX Codex +1 2 600установок sentry-debug-issue getsentry Ведёт одну ошибку Sentry от «вот проблема» до «вот фикс, задеплоен»: контекст, причина, правка кода, закрытие через Fixes PROJECT-NAME-12A. CX Codex +1 1 900установок sentry-nextjs-sdk getsentry Скилл сканирует проект на Next.js и помогает настроить мониторинг Sentry для браузера, Node.js и Edge Runtime. Пригодится при подключении трейсинга, сессий или сборе ошибок с роутов и Server Actions. CX Codex +1 3 600установок adding-error-tracking spencerpauly Скилл подключает Sentry к веб-приложению: ловит ошибки, считает трейсы и загружает source maps. Пригодится, когда нужен crash reporting без ручной настройки. CX Codex +1 386установок

Из того же набора32

convex-backup Настраивает регулярные снапшоты базы Convex и прогоняет учебное восстановление в одноразовый preview, чтобы проверить, что данные действительно возвращаются. CX Codex +1 35 900установок convex-migrate-rehearse Прогоняет изменение схемы и бэкфилл на превью-деплое с продовым снапшотом, а потом переносит проверенную миграцию в прод. CX Codex +1 35 900установок convex-cost Оценивает расходы на Convex и находит функции, сжигающие бюджет. Показывает график роста затрат и предлагает дешёвое исправление. CX Codex +1 35 900установок convex-insights Читает логи и состояние работающего Convex-развёртывания по запросу на естественном языке. Нужен для разбора сбоев и проверки связи ошибок с выкладкой. CX Codex +1 35 900установок convex-agent Ставит в приложение на Convex бэкенд для ИИ-агента: долгие треды, история сообщений, вызовы инструментов и поиск по векторам. CX Codex +1 35 900установок convex-test Помогает генерировать детерминированные тесты для функций Convex с помощью convex-test и vitest. Проверяет запросы, мутации и авторизацию без запуска реального бэкенда. CX Codex +1 35 900установок convex-self-heal Скилл берёт ошибку из прода, находит причину, готовит патч и проверяет его на превью. Мержит человек. CX Codex +1 35 800установок convex-suggest Скилл замечает, когда вы пишете руками то, что уже решает готовый компонент Convex, и после задачи предлагает один подходящий вариант. CX Codex +1 35 800установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой