511-frameworks-micronaut-jdbc — скилл для Claude Code
Скилл 511-frameworks-micronaut-jdbc проверяет и улучшает программный JDBC-код в Micronaut: SQL, транзакции, пул соединений, пакетные операции и обработку ошибок.
Apache-2.0 318 установок ★ 465 обновлён 2026-10-21
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-codeЧто делает 511-frameworks-micronaut-jdbc
Скилл разбирает JDBC-доступ в Micronaut через внедрённый javax.sql.DataSource, включая Hikari из micronaut-jdbc-hikari. Он проверяет PreparedStatement с параметрами, преобразование строк ResultSet в Java records, безопасные запросы одной строки через Optional<T> и перевод SQLException в доменные исключения. Для больших выборок учитывает setFetchSize, а для массовых вставок — addBatch и executeBatch.
Отдельно проверяются границы @Transactional, TransactionDefinition.Propagation и ошибка self-invocation, когда транзакционный метод вызывают через this.method(). Скилл предлагает сверяться с references/511-frameworks-micronaut-jdbc.md и учитывать, когда вместо raw JDBC лучше выбрать Micronaut Data. Перед изменениями нужно выполнить ./mvnw compile или mvn compile, а после — ./mvnw clean verify или mvn clean verify. Если компиляция завершается ошибкой, скилл останавливается.
Какие задачи решает
- проверить параметризацию SQL-запросов
- настроить границы транзакций в сервисе
- перевести
SQLExceptionв доменные исключения - обработать большие
ResultSetбез переполнения памяти - ускорить массовые вставки через пакетные операции
Примеры запросов агенту
- Проверь JDBC-доступ в Micronaut и найди конкатенацию строк в SQL.
- Исправь обход
@Transactionalпри self-invocation и проверь границы транзакции. - Переработай чтение большого
ResultSetс учётомsetFetchSize.
Как установить 511-frameworks-micronaut-jdbc
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-code2Вручную: положить файлы
~/.claude/skills/511-frameworks-micronaut-jdbc/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/511-frameworks-micronaut-jdbc/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a codex2Вручную: положить файлы
.agents/skills/511-frameworks-micronaut-jdbc/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a cursor2Вручную: положить файлы
.cursor/skills/511-frameworks-micronaut-jdbc/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/511-frameworks-micronaut-jdbc2Вручную: положить файлы
.github/skills/511-frameworks-micronaut-jdbc/SKILL.md1Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a gemini-cli2Командой платформы
gemini skills install https://github.com/jabrena/plinth --path skills/511-frameworks-micronaut-jdbcВручную: положить файлы
.devin/skills/511-frameworks-micronaut-jdbc/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 511-frameworks-micronaut-jdbc
Как установить 511-frameworks-micronaut-jdbc в Claude Code?
Выполните npx skills add jabrena/plinth --skill 511-frameworks-micronaut-jdbc -a claude-code, затем проверьте файл ~/.claude/skills/511-frameworks-micronaut-jdbc/SKILL.md.
Что делает 511-frameworks-micronaut-jdbc?
Скилл применяет правила для программного JDBC в Micronaut: параметризованный SQL, пул DataSource, транзакции, пакетные операции, потоковое чтение и перевод ошибок в доменные исключения.
Что нужно выполнить до и после изменений?
До изменений проект должен успешно пройти ./mvnw compile или mvn compile. После изменений нужно запустить ./mvnw clean verify или mvn clean verify.
Исходный текст
SKILL.md · Apache-2.0
--- name: 511-frameworks-micronaut-jdbc description: Use when you need programmatic JDBC in Micronaut — pooled DataSource, parameterized SQL, io.micronaut.transaction.annotation.Transactional, batching, and domain exception translation. This should trigger for requests such as Review JDBC or SQL data access in a Micronaut project; Improve transactions and parameter binding for Micronaut JDBC; Translate SQLException to domain exceptions or stream large result sets; Fix self-invocation bypassing @Transactional in Micronaut; Review Hikari or pooled datasource usage in Micronaut JDBC. Part of Plinth Toolkit license: Apache-2.0 metadata: author: Juan Antonio Breña Moral version: 0.19.0 --- # Micronaut JDBC — programmatic SQL Apply programmatic JDBC patterns in Micronaut with safe SQL and clear transactions. **What is covered in this Skill?** - Injected javax.sql.DataSource (Hikari-backed with micronaut-jdbc-hikari) and try-with-resources for Connection / PreparedStatement - PreparedStatement with bind parameters — never string concatenation - Mapping ResultSet rows to Java records (dedicated mapRow method) - Safe single-row queries with Optional<T>; never assume rs.next() succeeds - SQLException translation to domain exceptions (catch-translate-rethrow) - Streaming large result sets with setFetchSize to avoid OOM - Batch updates with addBatch / executeBatch for bulk inserts - @Transactional service boundaries and TransactionDefinition.Propagation (e.g. REQUIRES_NEW for independent commits) - Self-invocation pitfall: call transactional collaborators through injected beans, not this.method() - SQL text blocks for multi-line SQL (upserts, dialect-specific clauses) - When to prefer Micronaut Data (`@512`) vs raw JDBC **Scope:** Apply recommendations based on the reference rules and good/bad code examples. ## Constraints Compile before JDBC refactors; verify after changes. - **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change - **PREREQUISITE**: Project must compile before applying JDBC improvements - **SAFETY**: If compilation fails, stop immediately - **BLOCKING CONDITION**: Compilation errors must be resolved by the user before proceeding - **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements - **BEFORE APPLYING**: Read the reference for detailed rules and examples ## When to use this skill - Review JDBC or SQL data access in a Micronaut project - Improve transactions and parameter binding for Micronaut JDBC - Translate SQLException to domain exceptions or stream large result sets - Fix self-invocation bypassing @Transactional in Micronaut - Review Hikari or pooled datasource usage in Micronaut JDBC ## Workflow 1. **Read reference and assess project context** Read `references/511-frameworks-micronaut-jdbc.md` and inspect the current project setup before proposing changes. 2. **Gather scope and decide target improvements** Identify requested outcomes, constraints, and the minimum safe set of changes to apply. 3. **Apply framework-aligned changes** Implement or refactor configuration/code following the reference patterns and project conventions. 4. **Run verification and report results** Execute appropriate build/tests and summarize what changed, what was verified, and any follow-up actions. ## Reference For detailed guidance, examples, and constraints, see [references/511-frameworks-micronaut-jdbc.md](references/511-frameworks-micronaut-jdbc.md).
© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth