126-java-exception-handling — скилл для Claude Code: установка
Скилл 126-java-exception-handling для Claude Code помогает применять правила обработки исключений в Java. Подключается к запросам на проверку типов исключений, ресурсов и передачи ошибок.
Apache-2.0 307 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 126-java-exception-handling -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/126-java-exception-handling/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/126-java-exception-handling/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 126-java-exception-handling -a codex2Вручную: положить файлы
.agents/skills/126-java-exception-handling/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 126-java-exception-handling -a cursor2Вручную: положить файлы
.cursor/skills/126-java-exception-handling/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/126-java-exception-handling2Вручную: положить файлы
.github/skills/126-java-exception-handling/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 126-java-exception-handling -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/126-java-exception-handlingВручную: положить файлы
.devin/skills/126-java-exception-handling/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 126-java-exception-handling -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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