convex-sentinel — скилл для Claude Code: что делает и как установить
Настраивает сбор ошибок продакшена прямо в базу данных деплоя Convex. Помогает отслеживать падения функций, сбои React и сигналы масштабирования без отправки логов сторонним сервисам.
npx skills add convex/agent-skills --skill convex-sentinel -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/convex-sentinel/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-sentinel/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-sentinel -a codex2Вручную: положить файлы
.agents/skills/convex-sentinel/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-sentinel -a cursor2Вручную: положить файлы
.cursor/skills/convex-sentinel/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-sentinel2Вручную: положить файлы
.github/skills/convex-sentinel/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-sentinel -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-sentinelВручную: положить файлы
.devin/skills/convex-sentinel/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-sentinel -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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