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

handling-failures — скилл для Claude Code

Скилл handling-failures, который заставляет ИИ-ассистента писать честные обработчики ошибок: каждый сбой либо логируется и пробрасывается, либо возвращает типизированную ошибку, либо переводит систему в явный деградированный режим.

лицензия не указана 25 500 установок ★ 6 обновлён 2026-09-11

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

Что делает handling-failures

Скилл кодирует простой контракт: каждый путь ошибки делает ровно одно из трёх — логирует на WARN или ERROR и пробрасывает исключение, логирует и возвращает типизированную ошибку, которую вызывающий код обязан обработать, либо логирует и входит в задокументированный деградированный режим с наблюдаемым признаком. Голый catch-and-continue, возврат пустого списка или нуля, ?? fallback, который маскирует сбой, — запрещены без исключений.

Из контракта вытекают следствия, которые скилл применяет при ревью и правках. Отсутствующая обязательная запись в реестре или конфиге — это ошибка сборки или запуска, а не тихое значение по умолчанию. Повторы операций с побочными эффектами должны быть идемпотентны. У деградированного режима есть порог, после которого он превращается в аварийную остановку — именованная константа, которую может настроить оператор.

Для работы скилла нужен скилл principal-engineering из того же репозитория. При правке существующего кода, который уже проглатывает ошибки, скилл требует либо починить это в рамках задачи, либо явно пометить как долг с описанием, что именно скрывается. Новое тихое проглатывание на ревью — автоматический блокер.

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

  • исключение ловится и молча продолжает работу без следа в логах
  • catch возвращает пустой список или null, маскируя сбой
  • fallback через ?? скрывает отказ основного источника данных
  • деградированный режим работает без задокументированного порога остановки
  • повторы side-effect операций не идемпотентны

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

  • Добавь обработку ошибки в этот catch: залогируй на ERROR и пробрось исключение дальше.
  • Вот фолбэк через ?? — покажи, как сделать так, чтобы отказ основного источника был виден.
  • Проверь этот код на тихие проглатывания ошибок и предложи исправления.

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

1Через Skills CLI (Vercel)

npx skills add riekelt/principal-engineer --skill handling-failures -a claude-code

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

~/.claude/skills/handling-failures/SKILL.md

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

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

Вопросы о handling-failures

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

Выполните npx skills add riekelt/principal-engineer --skill handling-failures -a claude-code. Скилл появится в ~/.claude/skills/handling-failures/SKILL.md.

Что делает handling-failures?

Задаёт правила для любых путей ошибок: catch-блоков, фолбэков, значений по умолчанию, повторов и деградированных режимов. Каждый сбой должен быть громким — залогирован и проброшен, возвращён как типизированная ошибка или переведён в явный деградированный режим.

Что нужно для работы скилла?

Требуется скилл principal-engineering из того же репозитория riekelt/principal-engineer.

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

Все скиллы по теме «Код-ревью и рефакторинг» →
error-handling-patterns Seth Hobson Скилл error-handling-patterns для Claude Code помогает проектировать обработку ошибок: исключения, Result-типы, передачу контекста и graceful degradation. Разбирает ошибки API и отладку сбоев. CX Codex +1 22 957установок 126-java-exception-handling Juan Antonio Breña Moral Скилл 126-java-exception-handling для Claude Code помогает применять правила обработки исключений в Java. Подключается к запросам на проверку типов исключений, ресурсов и передачи ошибок. CX Codex +1 307установок golang-error-handling samber Скилл golang-error-handling помогает идиоматично обрабатывать ошибки в Go. Включается при создании, оборачивании, проверке цепочек и логировании ошибок. CX Codex +1 46 400установок error-handling affaan-m Скилл error-handling задаёт единые правила обработки ошибок в TypeScript, Python и Go: типизированные исключения, ретраи, circuit breaker, тексты для пользователя. CX Codex +1 6 600установок go-error-handling cxuu Скилл go-error-handling учит агента писать надёжную обработку ошибок в Go: выбирать между %w и %v, задавать sentinel-ошибки и не смешивать логирование с возвратом. CX Codex +1 1 400установок 0-error-handling ai-driven-dev Правило 0-error-handling задаёт единый путь обработки ошибок в TypeScript-коде: исключение поднимается до командного слоя и ловится там. CX Codex +1 ★ 571звёзд репо

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

Весь набор →
keeping-one-source-of-truth Скилл keeping-one-source-of-truth для Claude Code и других агентов: держит каждый факт в одном месте. Срабатывает, когда значение просится во второй файл или две копии уже разошлись. CX Codex +1 25 600установок testing-changes Скилл testing-changes задаёт правила проверки изменений в коде: когда нужен регрессионный тест, как закрывать краевые случаи и почему диффу нельзя оставаться без проверок. CX Codex +1 25 600установок guarding-architecture Скилл guarding-architecture защищает архитектурные границы проекта и превращает правила в автоматические тесты сборки. Пригодится при сквозных правках модулей или случайных импортах. CX Codex +1 25 600установок grounding-before-coding Скилл grounding-before-coding для Claude Code сначала изучает код и данные, а затем меняет проект или объясняет баг. Разбирает незнакомые репозитории и сложные задачи. CX Codex +1 25 600установок verifying-before-done Скилл verifying-before-done для ИИ-агента: прежде чем объявить задачу выполненной, он прогоняет изменение на его родной поверхности и показывает вывод команды проверки. CX Codex +1 25 600установок adding-dependencies Скилл adding-dependencies помогает решить, нужна ли проекту новая зависимость, как её проверить и обновлять. Пригодится перед добавлением пакета, SDK или GitHub Action. CX Codex +1 25 500установок operating-safely Скилл operating-safely задаёт правила для разрушительных операций, работы с секретами и параллельных сессий. Срабатывает до вызова опасных команд вроде удаления файлов или перезапуска сервисов. CX Codex +1 25 500установок scoping-changes Скилл scoping-changes для Claude Code помогает удерживать размер правки в границах исходной задачи. Он подключается, когда изменение разрастается или из согласованного плана начинают незаметно вырезать части. CX Codex +1 25 500установок

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

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