handling-failures — скилл для Claude Code
Скилл handling-failures, который заставляет ИИ-ассистента писать честные обработчики ошибок: каждый сбой либо логируется и пробрасывается, либо возвращает типизированную ошибку, либо переводит систему в явный деградированный режим.
лицензия не указана 25 500 установок ★ 6 обновлён 2026-09-11
npx skills add riekelt/principal-engineer --skill handling-failures -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/handling-failures/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/handling-failures/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill handling-failures -a codex2Вручную: положить файлы
.agents/skills/handling-failures/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill handling-failures -a cursor2Вручную: положить файлы
.cursor/skills/handling-failures/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install riekelt/principal-engineer plugins/principal-engineer/skills/handling-failures2Вручную: положить файлы
.github/skills/handling-failures/SKILL.md1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill handling-failures -a gemini-cli2Командой платформы
gemini skills install https://github.com/riekelt/principal-engineer --path plugins/principal-engineer/skills/handling-failuresВручную: положить файлы
.devin/skills/handling-failures/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill handling-failures -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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.