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

error-handling-standardizer — скилл для Claude Code: обработка ошибок

Скилл error-handling-standardizer помогает привести ошибки приложения к общей схеме: от собственных классов до HTTP-ответов и структурированных логов. Пригодится при пересмотре обработки исключений в API.

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

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

Что делает error-handling-standardizer

Скилл предлагает классы AppError, ValidationError, NotFoundError, UnauthorizedError и ForbiddenError, а также middleware для обработки ошибок. Известные операционные ошибки получают заданный HTTP-статус и код; для неизвестных ошибок возвращается общий ответ 500 с идентификатором запроса. Клиенту не отправляется stack trace.

В примерах используются TypeScript-типы Express и winston: логгер записывает сообщение, stack trace и контекст запроса, а asyncHandler передаёт ошибки из асинхронных маршрутов в middleware. Неизвестная ошибка приведёт к ответу 500, поэтому проверьте, что такой общий ответ подходит вашему API.

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

  • разделить ошибки валидации и программные сбои
  • сопоставить типы ошибок с HTTP-статусами
  • возвращать безопасные сообщения клиенту
  • добавить контекст запроса в логи
  • передавать ошибки асинхронных маршрутов в middleware

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

  • Приведи обработку ошибок в API к общей схеме с классами и HTTP-статусами.
  • Добавь middleware, который скрывает внутренние ошибки от клиента и пишет контекст запроса в лог.
  • Проверь асинхронные маршруты и оберни их в общий обработчик ошибок.

Как установить error-handling-standardizer

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill error-handling-standardizer -a claude-code

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

~/.claude/skills/error-handling-standardizer/SKILL.md

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

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

Вопросы об error-handling-standardizer

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

Выполните npx skills add patricio0312rev/skills --skill error-handling-standardizer -a claude-code. Файл скилла находится по пути ~/.claude/skills/error-handling-standardizer/SKILL.md.

Что делает error-handling-standardizer?

Помогает унифицировать классы ошибок, HTTP-ответы и структурированные логи. Также показывает middleware и обёртку для ошибок асинхронных маршрутов.

Как скилл обрабатывает неизвестные ошибки?

Middleware возвращает HTTP 500 с общим сообщением и идентификатором запроса. Stack trace записывается в лог, но не отправляется клиенту.

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

SKILL.md · MIT
---
name: error-handling-standardizer
description: Creates consistent error handling with custom error classes, HTTP status mapping, structured logging, safe client messages, and error taxonomy. Use when standardizing "error handling", "logging", "error responses", or "exception management".
---

# Error Handling Standardizer

Build consistent, debuggable error handling across the application.

## Error Taxonomy

```typescript
export class AppError extends Error {
  constructor(
    public code: string,
    public message: string,
    public statusCode: number = 500,
    public isOperational: boolean = true,
    public details?: any
  ) {
    super(message);
    Error.captureStackTrace(this, this.constructor);
  }
}

export class ValidationError extends AppError {
  constructor(details: Record<string, string[]>) {
    super("VALIDATION_ERROR", "Validation failed", 400, true, details);
  }
}

export class NotFoundError extends AppError {
  constructor(resource: string) {
    super("NOT_FOUND", `${resource} not found`, 404);
  }
}

export class UnauthorizedError extends AppError {
  constructor(message = "Unauthorized") {
    super("UNAUTHORIZED", message, 401);
  }
}

export class ForbiddenError extends AppError {
  constructor(message = "Forbidden") {
    super("FORBIDDEN", message, 403);
  }
}
```

## Error Handler Middleware

```typescript
export const errorHandler = (
  err: Error,
  req: Request,
  res: Response,
  next: NextFunction
) => {
  // Log error
  logger.error("Request error", {
    error: err.message,
    stack: err.stack,
    path: req.path,
    method: req.method,
    requestId: req.id,
  });

  // Operational errors (known)
  if (err instanceof AppError && err.isOperational) {
    return res.status(err.statusCode).json({
      success: false,
      error: {
        code: err.code,
        message: err.message,
        details: err.details,
        trace_id: req.id,
      },
    });
  }

  // Programming errors (unknown)
  return res.status(500).json({
    success: false,
    error: {
      code: "INTERNAL_ERROR",
      message: "An unexpected error occurred",
      trace_id: req.id,
    },
  });
};
```

## Structured Logging

```typescript
import winston from "winston";

export const logger = winston.createLogger({
  level: "info",
  format: winston.format.combine(
    winston.format.timestamp(),
    winston.format.errors({ stack: true }),
    winston.format.json()
  ),
  transports: [
    new winston.transports.File({ filename: "error.log", level: "error" }),
    new winston.transports.File({ filename: "combined.log" }),
  ],
});

// Log with context
logger.error("Payment processing failed", {
  userId: user.id,
  amount: payment.amount,
  error: err.message,
  trace_id: req.id,
});
```

## Safe Client Messages

```typescript
// Never expose internal errors to clients
const getSafeErrorMessage = (err: Error): string => {
  if (err instanceof AppError && err.isOperational) {
    return err.message; // Safe, user-facing message
  }

  // Generic message for unexpected errors
  return "An unexpected error occurred";
};
```

## Async Error Handling

```typescript
// Wrap async routes
export const asyncHandler = (fn: RequestHandler) => {
  return (req: Request, res: Response, next: NextFunction) => {
    Promise.resolve(fn(req, res, next)).catch(next);
  };
};

// Usage
router.get(
  "/users",
  asyncHandler(async (req, res) => {
    const users = await userService.findAll();
    res.json(users);
  })
);
```

## Best Practices

- Use custom error classes
- Distinguish operational vs programming errors
- Log all errors with context
- Never expose stack traces to clients
- Include trace IDs for debugging
- Monitor error rates by type
- Set up alerting for critical errors

## Output Checklist

- [ ] Custom error classes defined
- [ ] Error handler middleware
- [ ] HTTP status code mapping
- [ ] Structured logging setup
- [ ] Safe client error messages
- [ ] Async error wrapper
- [ ] Error monitoring/alerts
- [ ] Documentation of error codes

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Бэкенд и API» →
error-handling CloudAI-X Скилл error-handling для Claude Code предлагает паттерны обработки ошибок, логирования и восстановления после сбоев. Помогает проектировать слой исключений и реализовывать retry и circuit breaker. CX Codex +1 ★ 1 424звёзд репо golang-error-handling samber Скилл golang-error-handling помогает идиоматично обрабатывать ошибки в Go. Включается при создании, оборачивании, проверке цепочек и логировании ошибок. CX Codex +1 46 400установок api-error-handling secondsky Скилл api-error-handling для Claude Code задаёт стандартный формат ответов об ошибках, класс ApiError и паттерн circuit breaker. Покрывает API перед выходом в продакшен. CX Codex +1 461установок error-handling-patterns curiositech Скилл error-handling-patterns для Claude Code проектирует обработку ошибок в TypeScript и Python: помогает выбрать между исключениями и Result-типами и построить recovery-флоу. CX Codex +1 140установок Error Handling taste f Промпт Error Handling taste задаёт ИИ-ассистенту вкус бэкенд-инженера на TypeScript: как валидировать вход, разделять ожидаемые ошибки и баги, логировать и отдавать клиенту. GP ChatGPT ★ 178 201звёзд репо 0-error-handling ai-driven-dev Правило 0-error-handling задаёт единый путь обработки ошибок в TypeScript-коде: исключение поднимается до командного слоя и ловится там. CX Codex +1 ★ 571звёзд репо

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

Весь набор →
threat-model-generator Скилл threat-model-generator строит модель угроз по STRIDE: выписывает активы, находит угрозы, подбирает меры защиты и считает остаточный риск. CX Codex +1 270установок domain-model-boundaries-mapper Скилл domain-model-boundaries-mapper анализирует архитектуру проекта по принципам Domain-Driven Design: находит доменные модули, границы ответственности и зависимости. Помогает спланировать разделение связанных компонентов. CX Codex +1 270установок react-hook-builder Скилл react-hook-builder генерирует кастомные хуки React на TypeScript с обработкой ошибок, отменой запросов и типизацией. CX Codex +1 269установок mcp-server-builder Скилл mcp-server-builder для Claude Code помогает создавать MCP-серверы с инструментами, ресурсами и промптами. Запускается на просьбы собрать интеграцию MCP или собственный инструмент для Claude. CX Codex +1 269установок tech-debt-prioritizer Скилл tech-debt-prioritizer для Claude Code оценивает технический долг по влиянию, риску и трудозатратам и ранжирует задачи. CX Codex +1 268установок integration-test-builder Скилл integration-test-builder для Claude Code и Codex: генерирует интеграционные тесты API с фиксчерами, setup/teardown, сидингом БД и стратегиями для CI. CX Codex +1 267установок tanstack-query-setup Скилл tanstack-query-setup ставит TanStack Query в React-проект: провайдер QueryClient, хуки на useQuery, мутации и правила кеша. Агент получает готовые шаблоны и подставляет в них ваш код. CX Codex +1 267установок hot-reload-optimizer Скилл hot-reload-optimizer для Claude Code оптимизирует hot module replacement и fast refresh в проектах на Vite, Next.js и webpack, ускоряя пересборки сервера разработки. CX Codex +1 267установок

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

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