review-logging-patterns
Анализирует код на наличие console.log и неструктурированных ошибок, предлагая внедрение evlog. Поддерживает Nuxt, Next.js, Express и другие фреймворки, интегрируется с Axiom, Sentry, Datadog и другими системами логирования.
Что делает навык
Skill анализирует код на TypeScript/JavaScript, заменяя разрозненные console.log на структурированные широкие события (wide events) и преобразуя generic-ошибки в самодокументируемые структурированные ошибки. Он поддерживает интеграцию с системами логирования, такими как Axiom, Sentry и Datadog, а также фреймворками Nuxt, Next.js, Express и другими.
Когда применять
- Настройка evlog в новом или существующем проекте любого поддерживаемого фреймворка.
- Аудит кода на соответствие лучшим практикам логирования и выявление неструктурированных ошибок.
- Конвертация существующих вызовов console.log в структурированное логирование.
- Улучшение обработки ошибок путем добавления контекста и метаданных.
- Настройка конвейера стока (drain pipeline), семплирования или обогащения логов.
Как работает
- Выполнить npx evlog init --dry-run для предварительного просмотра конфигурации, стоков и обогащений без записи изменений.
- Применить настройки через npx evlog init --yes с указанием параметров (например, --drain, --prodDrain, --framework).
- Запустить npx evlog map --no-write для получения оценки покрытия логированием и выявления 'темных' точек входа.
- Внести минимальные изменения в код (использование useLogger, log.set, log.audit, createError) в приоритетных местах, указанных в отчете map.
- Повторно запустить evlog map для проверки роста оценки покрытия.
- Настроить CI-гейтинг с помощью флагов --min-score или --baseline для предотвращения регрессий.
Примеры запросов агенту
Что понадобится
- Установленный пакет evlog (npm install evlog) и доступ к CLI (npx evlog, pnpm evlog или bunx evlog).
- Ключи доступа и конфигурация для целевых систем логирования (например, AXIOM_API_KEY для Axiom, ключи для Sentry/Datadog).
- Проект на одном из поддерживаемых фреймворков: Nuxt, Nitro, Next.js, TanStack Start, Hono, Express или Fastify.
Описание составлено по SKILL.md навыка, сверено 10.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.