AIKraft/AI/Войти
AIKraft/Skills/kotlin-tooling-kotlin-toolchain-plugin-authoring

kotlin-tooling-kotlin-toolchain-plugin-authoring

Помогает создавать локальные плагины Kotlin Toolchain для расширения декларативной сборки, генерации кода и кастомной верификации, когда module.yaml недостаточно. Используйте при работе с @TaskAction, @Configurable, plugin.yaml или jvm/amper-plugin. Не подходит для портирования существующих Gradle-плагинов.

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

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

Навык позволяет создавать локальные плагины Kotlin Toolchain (jvm/amper-plugin) для расширения декларативной сборки, генерации кода и кастомной верификации, когда конфигурации module.yaml недостаточно. Он предоставляет механизм для добавления пользовательских действий сборки, настроек и сгенерированных ресурсов непосредственно в проект.

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

  • Необходимость выполнения шага сборки, ожидаемого рабочим процессом библиотеки, например, генерации кода, компиляции схемы, трансформации ресурсов или проставления версий.
  • Требуется внедрить пользовательскую проверку в сборку, такую как проверки перед релизом, валидация схемы или контрактные тесты.
  • Необходимо опубликовать значение времени сборки в classpath JAR или передать его в downstream-задачи (аналог project.version в Gradle).
  • Нужно создать именованную команду CLI для повторяющегося рабочего процесса (например, ./kotlin do release).

Как работает

  1. Определить, что стандартный module.yaml не покрывает требуемую функциональность, и подтвердить необходимость создания плагина.
  2. Создать модуль jvm/amper-plugin, который будет содержать действия задач (task actions), настройки и сгенерированные источники/ресурсы.
  3. Адаптировать шаблоны кода, используя примеры из references/examples.md.
  4. Реализовать логику для генерации кода, верификации или публикации значений времени сборки.
  5. Обеспечить доступность плагина в проекте для выполнения кастомных шагов сборки.

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

Создай локальный плагин Kotlin Toolchain для генерации кода на основе схемы, так как module.yaml не справляется.
Напиши плагин для выполнения кастомной верификации схемы перед релизом.
Реализуй named CLI команду ./kotlin do release через локальный плагин.

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

  • Доступ к файлам справки и примерам из references/examples.md
  • Окружение для разработки модулей jvm/amper-plugin

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

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

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

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