structured-logging-standardizer — скилл для Claude Code: что делает
Скилл structured-logging-standardizer внедряет единую схему JSON-логов с correlation ID через AsyncLocalStorage и pino. Помогает связать ошибки бэкенда с конкретными запросами.
MIT 273 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/structured-logging-standardizer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/structured-logging-standardizer/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a codex2Вручную: положить файлы
.agents/skills/structured-logging-standardizer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a cursor2Вручную: положить файлы
.cursor/skills/structured-logging-standardizer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills performance/structured-logging-standardizer/SKILL.md2Вручную: положить файлы
.github/skills/structured-logging-standardizer/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path performance/structured-logging-standardizerВручную: положить файлы
.devin/skills/structured-logging-standardizer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill structured-logging-standardizer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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