AIKraft/Skills/review-logging-patterns

review-logging-patterns

Анализирует код на наличие console.log и неструктурированных ошибок, предлагая внедрение evlog. Поддерживает Nuxt, Next.js, Express и другие фреймворки, интегрируется с Axiom, Sentry, Datadog и другими системами логирования.

EVEvlog official Разработка ★ 1.9k

Что делает навык

Skill анализирует код на TypeScript/JavaScript, заменяя разрозненные console.log на структурированные широкие события (wide events) и преобразуя generic-ошибки в самодокументируемые структурированные ошибки. Он поддерживает интеграцию с системами логирования, такими как Axiom, Sentry и Datadog, а также фреймворками Nuxt, Next.js, Express и другими.

Когда применять

  • Настройка evlog в новом или существующем проекте любого поддерживаемого фреймворка.
  • Аудит кода на соответствие лучшим практикам логирования и выявление неструктурированных ошибок.
  • Конвертация существующих вызовов console.log в структурированное логирование.
  • Улучшение обработки ошибок путем добавления контекста и метаданных.
  • Настройка конвейера стока (drain pipeline), семплирования или обогащения логов.

Как работает

  1. Выполнить npx evlog init --dry-run для предварительного просмотра конфигурации, стоков и обогащений без записи изменений.
  2. Применить настройки через npx evlog init --yes с указанием параметров (например, --drain, --prodDrain, --framework).
  3. Запустить npx evlog map --no-write для получения оценки покрытия логированием и выявления 'темных' точек входа.
  4. Внести минимальные изменения в код (использование useLogger, log.set, log.audit, createError) в приоритетных местах, указанных в отчете map.
  5. Повторно запустить evlog map для проверки роста оценки покрытия.
  6. Настроить CI-гейтинг с помощью флагов --min-score или --baseline для предотвращения регрессий.

Примеры запросов агенту

Проанализируй мой проект Next.js на наличие console.log и предложи план миграции на evlog с интеграцией в Axiom.
Запусти evlog map для текущего кода Express-приложения, чтобы оценить покрытие логированием, и покажи, какие точки входа требуют исправления.
Настрой структурированную обработку ошибок в Nuxt-приложении, заменив стандартные ошибки на self-documenting structured errors через evlog.

Что понадобится

  • Установленный пакет 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.

Как подключить

1Скачать навык
# возьмите папку навыка «evloghq-review-logging-patterns» из репозитория: # https://github.com/evloghq/evlog
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r evloghq-review-logging-patterns/ ~/.claude/skills/evloghq-review-logging-patterns/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.