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

126-java-exception-handling — скилл для Claude Code: установка

Скилл 126-java-exception-handling для Claude Code помогает применять правила обработки исключений в Java. Подключается к запросам на проверку типов исключений, ресурсов и передачи ошибок.

Apache-2.0 307 установок ★ 465 обновлён 2026-10-21

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

Что делает 126-java-exception-handling

Скилл предлагает улучшения для обработки исключений в Java: выбирать конкретные типы, закрывать ресурсы через try-with-resources, сохранять контекст ошибки при цепочке исключений и не раскрывать чувствительные сведения в сообщениях. Он также охватывает прерывания потоков, логирование, тайм-ауты, повторы для идемпотентных операций и распространение ошибок в асинхронном коде.

Перед изменениями агент запускает ./mvnw compile или mvn compile и останавливается, если проект не компилируется. Затем читает references/126-java-exception-handling.md, применяет подходящие рекомендации и проверяет проект командами ./mvnw clean verify или mvn clean verify.

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

  • выбрать конкретный тип исключения вместо общего
  • закрыть ресурсы через try-with-resources
  • сохранить контекст исходной ошибки при её передаче
  • проверить обработку прерываний и ошибок в асинхронном коде

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

  • Проверь обработку исключений в Java и предложи подходящие изменения.
  • Перепиши этот код на try-with-resources.
  • Добавь цепочку исключений и сохрани контекст ошибки.

Как установить 126-java-exception-handling

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 126-java-exception-handling -a claude-code

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

~/.claude/skills/126-java-exception-handling/SKILL.md

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

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

Вопросы о 126-java-exception-handling

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

Выполни npx skills add jabrena/plinth --skill 126-java-exception-handling -a claude-code. Файл скилла появится по пути ~/.claude/skills/126-java-exception-handling/SKILL.md.

Что делает 126-java-exception-handling?

Помогает улучшать обработку исключений в Java: от выбора типов и управления ресурсами до логирования и передачи ошибок между API-границами.

Что нужно для работы 126-java-exception-handling?

До изменений проект должен компилироваться: скилл запускает ./mvnw compile или mvn compile. После правок он выполняет полную проверку через ./mvnw clean verify или mvn clean verify.

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

SKILL.md · Apache-2.0
---
name: 126-java-exception-handling
description: Use when you need to apply Java exception handling best practices — including using specific exception types, managing resources with try-with-resources, securing exception messages, preserving error context via exception chaining, validating inputs early with fail-fast principles, handling thread interruption correctly, documenting exceptions with @throws, enforcing logging policy, translating exceptions at API boundaries, managing retries and idempotency, enforcing timeouts, attaching suppressed exceptions, and propagating failures in async/reactive code. This should trigger for requests such as Exception handling; Use try-with-resources in Java code; Create exception chaining in Java code; Apply fail-fast validation in Java code; Review Java exception taxonomy and propagation. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Java Exception Handling Guidelines

Identify and apply robust Java exception handling practices to improve error clarity, security, debuggability, and system reliability.

**What is covered in this Skill?**

- Specific exception types instead of generic `Exception`/`RuntimeException`
- try-with-resources for automatic resource cleanup
- Secure exception messages that avoid information leakage
- Exception chaining to preserve full error context
- Early input validation with `IllegalArgumentException`/`NullPointerException`
- `InterruptedException` handling with interrupted-status restoration
- `@throws` JavaDoc documentation, fail-fast principle
- Structured logging with correlation IDs, avoiding log-and-throw duplication
- API boundary translation via centralized exception mappers
- Bounded retry with backoff for idempotent operations only
- Timeout enforcement with deadline propagation
- `Throwable#addSuppressed` for secondary cleanup failures
- Never catching `Throwable`/`Error`
- Observability via error metrics
- Failure propagation in async `CompletionStage` code

**Scope:** The reference is organized by examples (good/bad code patterns) for each core area. Apply recommendations based on applicable examples.

## Constraints

Before applying any exception handling changes, ensure the project compiles. If compilation fails, stop immediately — do not proceed until resolved. After applying improvements, run full verification.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any changes
- **SAFETY**: If compilation fails, stop immediately — do not proceed until the project is in a valid state
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed good/bad examples, constraints, and safeguards for each exception handling pattern

## When to use this skill

- Exception handling
- Use try-with-resources in Java code
- Create exception chaining in Java code
- Apply fail-fast validation in Java code
- Review Java exception taxonomy and propagation

## Workflow

1. **Compile project before exception-handling changes**

Run `./mvnw compile` or `mvn compile` and stop immediately if compilation fails.

2. **Read exception-handling reference**

Read `references/126-java-exception-handling.md` and identify applicable failure-handling and observability improvements.

3. **Apply exception-handling improvements**

Refactor to specific exceptions, safe resource handling, error translation, and consistent logging patterns.

4. **Verify with full build**

Run `./mvnw clean verify` or `mvn clean verify` after applying improvements.

## Reference

For detailed guidance, examples, and constraints, see [references/126-java-exception-handling.md](references/126-java-exception-handling.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

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

Все скиллы по теме «Языки программирования» →
exception-logging kyy-logs Правило exception-logging для Claude Code проверяет обработку исключений и логирование в коде на Java. Контролирует пустые блоки catch, вызовы SLF4J, маскирование данных и откат транзакций. CX Codex +1 ★ 517звёзд репо devkit.java.security-review Giuseppe Trisciuoglio Команда devkit.java.security-review для Claude Code проверяет безопасность корпоративных Java-приложений. Она запускается для аудита приложения или перед выпуском в production. CX Codex +1 ★ 372звёзд репо java-junit официальный github Скилл java-junit пишет, проверяет и исправляет Java-тесты на JUnit, AssertJ и Mockito. Нужен при добавлении, рефакторинге или разборе падений тестов в Maven и Gradle. CX Codex +1 11 632установок devkit.java.dependency-audit Giuseppe Trisciuoglio Команда devkit.java.dependency-audit проверяет зависимости Java на Maven и Gradle: находит уязвимости по базам CVE, выявляет несовместимые лицензии и оценивает риски в цепочке поставок перед релизом. CX Codex +1 ★ 372звёзд репо error-handling-patterns Seth Hobson Скилл error-handling-patterns для Claude Code помогает проектировать обработку ошибок: исключения, Result-типы, передачу контекста и graceful degradation. Разбирает ошибки API и отладку сбоев. CX Codex +1 22 957установок java-upgrade официальный github Скилл java-upgrade пошагово переводит Java-проект на новый JDK и помогает освоить новые возможности языка, включая переходы 11 → 17, 17 → 21 и 21 → 25. CX Codex +1 6установок

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

Весь набор →
511-frameworks-micronaut-jdbc Скилл 511-frameworks-micronaut-jdbc проверяет и улучшает программный JDBC-код в Micronaut: SQL, транзакции, пул соединений, пакетные операции и обработку ошибок. CX Codex +1 318установок 513-frameworks-micronaut-db-migrations-flyway Скилл 513-frameworks-micronaut-db-migrations-flyway помогает добавлять и проверять миграции Flyway в Micronaut: от SQL-файлов и конфигурации до порядка применения и тестов. CX Codex +1 317установок 002-agents-inventory Скилл 002-agents-inventory для автоматического создания контрольного списка с реестром встроенных Java-агентов. Генерирует файл INVENTORY-AGENTS-JAVA.md по строгому шаблону, соблюдая точную структуру и содержание. CX Codex +1 314установок 043-planning-github-issues Скилл 043-planning-github-issues помогает настроить GitHub CLI и выстроить трассировку задач по документам в репозитории без загрузки текста issue в контекст модели. CX Codex +1 312установок 703-technologies-fuzzing-testing Скилл 703-technologies-fuzzing-testing для Claude Code настраивает fuzz-тестирование Java API с CATS по OpenAPI-контракту и проверяет некорректные данные и граничные значения. CX Codex +1 304установок 314-frameworks-spring-kafka Скилл 314-frameworks-spring-kafka настраивает обмен сообщениями Kafka в Spring Boot: продюсеры, консьюмеры, DLT и тесты с Testcontainers. CX Codex +1 297установок 182-java-observability-metrics-micrometer Скилл 182-java-observability-metrics-micrometer помогает проектировать и проверять метрики Java-сервисов на Micrometer. Пригодится при добавлении измерений или переработке существующей инструментации. CX Codex +1 297установок 403-frameworks-quarkus-validation Скилл 403-frameworks-quarkus-validation помогает добавлять и проверять валидацию Quarkus: от DTO и REST-ресурсов до настроек и обработки ошибок. CX Codex +1 296установок

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

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