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

structured-logging-standardizer — скилл для Claude Code: что делает

Скилл structured-logging-standardizer внедряет единую схему JSON-логов с correlation ID через AsyncLocalStorage и pino. Помогает связать ошибки бэкенда с конкретными запросами.

MIT 273 установок ★ 64 обновлён 2026-01-12

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

Что делает structured-logging-standardizer

Скилл задаёт строгую схему LogEntry для бэкенда: поля timestamp, level, service, environment, а также идентификаторы requestId, traceId и userId. Он объясняет агенту, как настроить сквозную трассировку через middleware с заголовком x-request-id.

Логика построена вокруг библиотеки pino и контекста AsyncLocalStorage, откуда логер автоматически забирает requestId. Скилл запрещает интерполяцию строк в логах и требует передавать контекст объектами со snake_case-ключами вроде duration_ms.

Шаблон ориентирован на стек Node.js и TypeScript. Если в проекте нет AsyncLocalStorage или используется другой язык, примеры middleware и обёртку логера придётся переписывать вручную.

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

  • связать цепочку логов с конкретным HTTP-запросом через x-request-id
  • стандартизировать структуру JSON-логов на базе pino
  • устранить строковую интерполяцию в сообщениях логера
  • добавить сохранение контекста пользователя и запроса в AsyncLocalStorage

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

  • Настрой middleware сквозного requestId и структурированный логер для Express-сервиса
  • Переведи логи сервиса на единый формат LogEntry с полями timestamp, service и userId
  • Исправь интерполяцию строк в логах на передачу параметров отдельным объектом

Как установить structured-logging-standardizer

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a claude-code

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

~/.claude/skills/structured-logging-standardizer/SKILL.md

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

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

Вопросы о structured-logging-standardizer

Как установить structured-logging-standardizer в Claude Code?

Запустите команду npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a claude-code. Также файл скилла можно положить напрямую в ~/.claude/skills/structured-logging-standardizer/SKILL.md.

Что делает structured-logging-standardizer?

Скилл учит ИИ-ассистента настраивать сквозное структурированное логирование. Он задаёт интерфейс LogEntry, правила передачи correlation ID и запрещает склеивание строк вместо JSON-объектов.

Какие библиотеки нужны для работы шаблона из скилла?

Примеры кода опираются на логер pino, генератор идентификаторов uuid и встроенный модуль AsyncLocalStorage платформы Node.js.

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

SKILL.md · MIT
---
name: structured-logging-standardizer
description: Enforces consistent structured logging with request correlation IDs, standardized log schema, middleware integration, and best practices. Use for "structured logging", "log standardization", "request tracing", or "log correlation".
---

# Structured Logging Standardizer

Implement consistent, queryable, correlated logs.

## Log Schema

```typescript
interface LogEntry {
  timestamp: string; // ISO 8601
  level: "debug" | "info" | "warn" | "error" | "fatal";
  message: string;
  service: string;
  environment: string;

  // Request context
  requestId?: string;
  traceId?: string;
  userId?: string;

  // Additional context
  [key: string]: any;
}
```

## Request ID Middleware

```typescript
import { v4 as uuidv4 } from "uuid";

app.use((req, res, next) => {
  // Generate or use existing request ID
  req.id = req.headers["x-request-id"] || uuidv4();

  // Add to response headers
  res.setHeader("x-request-id", req.id);

  // Store in async local storage
  asyncLocalStorage.run(new Map(), () => {
    asyncLocalStorage.getStore()?.set("requestId", req.id);
    next();
  });
});

// Logger with request context
const logger = pino({
  mixin() {
    return {
      requestId: asyncLocalStorage.getStore()?.get("requestId"),
    };
  },
});
```

## Standardized Logger

```typescript
class StandardLogger {
  private logger = pino();

  info(message: string, context?: Record<string, any>) {
    this.logger.info(
      {
        ...this.getContext(),
        ...context,
      },
      message
    );
  }

  error(message: string, error?: Error, context?: Record<string, any>) {
    this.logger.error(
      {
        ...this.getContext(),
        ...context,
        error: {
          message: error?.message,
          stack: error?.stack,
          name: error?.name,
        },
      },
      message
    );
  }

  private getContext() {
    return {
      requestId: asyncLocalStorage.getStore()?.get("requestId"),
      userId: asyncLocalStorage.getStore()?.get("userId"),
    };
  }
}
```

## Best Practices

```typescript
// ✅ DO: Structured fields
logger.info({ userId: '123', action: 'purchase', amount: 99.99 }, 'Purchase completed');

// ❌ DON'T: String interpolation
logger.info(\`User 123 purchased for $99.99\`);

// ✅ DO: Consistent field names
logger.info({ duration_ms: 150 }, 'Request completed');

// ❌ DON'T: Inconsistent naming
logger.info({ durationMs: 150 }, 'Request done');
```

## Output Checklist

- [ ] Request ID middleware
- [ ] Structured log schema
- [ ] Correlation IDs
- [ ] Standardized logger
- [ ] Best practices documented
      ENDFILE

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Бэкенд и API» →
logging-best-practices andrelandgraf Скилл logging-best-practices учит агента писать структурированные логи через Pino: контекст первым аргументом, уровни для разных сценариев, обёртка для воркфлоу. CX Codex +1 111установок pino-logging oakoss Скилл pino-logging помогает настроить структурированные логи Pino в Node.js: от контекста запросов и маскировки секретов до вывода в разные места. CX Codex +1 217установок application-logging aj-geddes Скилл application-logging для Claude Code помогает настроить структурированные логи и их централизованный сбор. Включается при отладке приложения, настройке ELK или анализе его поведения. CX Codex +1 503установок better-logging biw Скилл better-logging для Claude Code помогает проектировать структурированные события для HTTP, IPC, tRPC, фоновых задач и очередей. Помогает искать сбои и задержки по разрозненным логам. CX Codex +1 497установок fastify-best-practices mcollina Скилл fastify-best-practices обучает ассистента архитектуре серверов на Fastify для Node.js. Он помогает настраивать маршруты, плагины, валидацию схем и логирование через Pino. CX Codex +1 100 800установок nodejs ulpi-io Скилл заставляет агента писать бэкенд на Node.js или Bun по правилам конкретного проекта, а не по усреднённым шаблонам из интернета. CX Codex +1 163установок

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

Весь набор →
evaluation-harness Скилл evaluation-harness для Claude Code и ещё пяти агентных платформ, который выстраивает повторяемую оценку LLM-приложений: golden-датасеты, рубрики скоринга, пороги pass/fail и отчёты о регрессиях. CX Codex +1 275установок backend-latency-profiler-helper Скилл backend-latency-profiler-helper разбирает медленные эндпоинты API: находит узкие места, перечисляет возможные причины и раскладывает исправления по приоритетам. CX Codex +1 275установок rbac-policy-tester Скилл rbac-policy-tester генерирует матрицу проверок и тесты прав доступа, чтобы защитить ролевую модель от регрессий в CI. CX Codex +1 274установок etl-sync-job-builder Скилл etl-sync-job-builder помогает проектировать ETL-пайплайны и синхронизацию данных с водяными знаками, идемпотентными вставками и повторными попытками. CX Codex +1 274установок data-retention-archiving-planner Скилл data-retention-archiving-planner помогает составить политики хранения данных, настроить регламенты комплаенса и автоматизировать перенос старых записей в архив или S3. CX Codex +1 273установок reliability-strategy-builder Скилл reliability-strategy-builder собирает схему отказоустойчивости сервиса: circuit breaker, ретраи с backoff, fallback, bulkhead и SLO с error budget. CX Codex +1 273установок e2e-test-builder Скилл e2e-test-builder генерирует сквозные браузерные тесты для Playwright и Cypress с паттерном Page Object, фикстурами и селекторами по ролям. CX Codex +1 273установок caching-strategy-optimizer Скилл caching-strategy-optimizer для Claude Code настраивает кэширование зависимостей, Docker-слоёв, сборки и тестов в CI/CD. Разбирает пайплайны с долгой сборкой или тестированием. CX Codex +1 272установок

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

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