kotlin-best-practices — скилл для Claude Code: стандарты Kotlin

Что делает kotlin-best-practices

Скилл описывает, как писать Kotlin в проекте: !! запрещён, вместо него ?., ?: или проверка на null со smart cast. Менеджеры возвращают Either<ClientException, T> и не бросают исключения, а контроллеры разворачивают результат через .throwOrValue(). Строки для enum не хардкодят — берут EnumName.VALUE.value.

В работе с базой скилл требует наследовать таблицы от UUIDTable, а не от Table, и использовать text() вместо varchar(). Удаление — только мягкое, через обновление deletedAt, и в каждом запросе нужен фильтр deletedAt.isNull(). Чтения идут через db.replica, записи через db.primary, а изменения в нескольких таблицах собираются в один транзакционный блок: либо всё проходит, либо всё откатывается.

Ещё одно правило касается DTO: конвертация живёт в companion object { fun from(entity) } внутри самого Response DTO, отдельные файлы-мапперы не создаются. Под каждый раздел есть подробные примеры в code-patterns.md, но сам файл в скилл не входит — без него останутся только краткие формулировки. Скилл работает с инструментами Read, Write, Edit, Glob и Grep.