AIKraft/AI/Войти
AIKraft/Skills/kotlin-tooling-gradle-to-kotlin-toolchain-project

kotlin-tooling-gradle-to-kotlin-toolchain-project

Помогает мигрировать весь Gradle-проект (build.gradle(.kts), wrapper, libs.versions.toml, buildSrc) на Kotlin Toolchain, включая переписывание CI и замену плагинов. Не применяется для портирования одного плагина или общих задач после завершения миграции Gradle.

KOKotlin official Разработка ★ 1.1k

Что делает навык

Навык автоматизирует миграцию всего Gradle-проекта (build.gradle(.kts), wrapper, libs.versions.toml, buildSrc) на Kotlin Toolchain, включая переписывание CI и замену плагинов. Он не применяется для портирования отдельных плагинов или общих задач после завершения миграции.

Когда применять

  • Миграция существующего JVM-проекта с Gradle на Kotlin Toolchain с сохранением структуры исходного кода.
  • Замена всех Gradle-плагинов на нативные настройки Toolchain или локальные плагины (jvm/amper-plugin).
  • Переписывание CI-пайплайнов для использования команд ./kotlin вместо ./gradlew.
  • Конвертация version catalog [bundles] и convention-плагинов из buildSrc в module-шаблоны.

Как работает

  1. Phase 1: Составьте инвентаризацию Gradle-сборки (плагины, buildSrc, кастомные задачи, зависимости, CI) и запишите её в MIGRATION_PLAN.md.
  2. Phase 2: Определите layout (maven-like), набор плагинов (native/local) и scope; поищите готовые реализации плагинов в GitHub перед написанием своих.
  3. Phase 3: Скопируйте kotlin/kotlin.bat, напишите project.yaml и module.yaml, реализуйте локальные плагины и шаблоны модулей, замените Maven-координаты на $libs.*.
  4. Phase 4: Перепишите CI-скрипты, заменив ./gradlew на ./kotlin, настройте передачу тегов через переменные окружения и исправьте пути загрузки артефактов.
  5. Phase 5: Удалите старые Gradle-файлы, очистите libs.versions.toml от [plugins] и [bundles], и проведите end-to-end валидацию через ./kotlin build, test и check.

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

Мигрируй мой Gradle-проект на Kotlin Toolchain, сохранив структуру src/main/kotlin и переписав CI.
Замени плагин detekt в моем проекте на локальный плагин Toolchain, убедившись, что по умолчанию не включается type resolution.
Конвертируй все [bundles] из libs.versions.toml в module-шаблоны и перенеси логику из buildSrc в шаблоны модулей.

Что понадобится

  • Доступ к репозиторию kotlin/kotlin-agent-skills и референсным проектам Toolchain (например, kotlin/kotlin-toolchain) для поиска плагинов.
  • Наличие файла .sdkmanrc с версией kotlintoolchain, соответствующей обертке.
  • Возможность выполнения команд ./kotlin show modules, ./kotlin build, ./kotlin check в среде сборки.

Описание составлено по SKILL.md навыка, сверено 31.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «kotlin-tooling-gradle-to-kotlin-toolchain-project» из репозитория: # https://github.com/kotlin/kotlin-agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r kotlin-tooling-gradle-to-kotlin-toolchain-project/ ~/.claude/skills/kotlin-tooling-gradle-to-kotlin-toolchain-project/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.