java-upgrade — правило для GitHub Copilot: обновление Java в сборке
Правило подсказывает Copilot подключить скилл java-upgrade, когда вы меняете версию Java в Maven или Gradle. Пригодится при переходе между LTS.
.github/instructions/java-upgrade.instructions.mdЧто делает java-upgrade
Правило срабатывает на файлы pom.xml, build.gradle и build.gradle.kts. Как только задача касается версии Java — compiler release, toolchain или java.version — Copilot обращается к скиллу java-upgrade. Сам скилл определяет текущую версию и подгружает только нужное руководство: 11 → 17, 17 → 21 или 21 → 25.
Если скилла в проекте нет, его ставят командой gh skills install github/awesome-copilot java-upgrade либо копируют папку skills/java-upgrade/ из репозитория. Правило лишь указывает на скилл, всю работу делает он.
Два ограничения зашиты прямо в тексте правила. Обновлять советуют по одной LTS-версии за раз и после каждого шага прогонять весь набор тестов. Перед поднятием целевой версии стоит проверить, какую минимальную Java поддерживают фреймворки и зависимости проекта — иначе сборка отвалится на несовместимой библиотеке.
Какие задачи решает
- поднять версию Java в
pom.xmlбез ручного поиска инструкций - перейти с Java 17 на 21 и не пропустить шаги миграции
- проверить, тянет ли проект новую LTS по зависимостям
- разбить обновление на этапы с прогоном тестов после каждого
- подключить нужное руководство по миграции только для своей пары версий
Примеры запросов агенту
- Обнови Java в этом проекте до 21
- Поменяй
java.versionвpom.xmlна 17 - Переведи сборку на Java 25 и проверь зависимости
Как установить java-upgrade
Вручную: положить файлы
.github/instructions/java-upgrade.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.claude/rules/java-upgrade.mdПоле paths во frontmatter ограничивает файлы: applyTo из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/java-upgrade.mdcВо frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится
Вручную: положить файлы
.devin/rules/java-upgrade.mdВручную: положить файлы
.clinerules/java-upgrade.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Из того же набора732
Весь набор →Похожие
Рядом в теме «Языки программирования»
Все правила IDE по теме «Языки программирования» →Вопросы о java-upgrade
Как установить java-upgrade в GitHub Copilot?
Положите файл .github/instructions/java-upgrade.instructions.md в проект — правило подхватится по путям applyTo. Сам скилл ставится командой gh skills install github/awesome-copilot java-upgrade.
Что делает java-upgrade?
Указывает Copilot обратиться к скиллу java-upgrade, когда задача меняет версию Java в файлах Maven или Gradle. Скилл определяет текущую версию и загружает подходящее руководство по миграции.
Какие переходы между версиями поддерживаются?
Скилл подгружает руководство под конкретную пару: Java 11 → 17, 17 → 21 или 21 → 25. Обновлять советуют по одной LTS за раз, прогоняя тесты после каждого шага.
Исходный текст
java-upgrade.instructions.md · MIT
--- description: 'Pointer to the java-upgrade skill when changing the Java version in Maven or Gradle build files' applyTo: '**/pom.xml, **/build.gradle, **/build.gradle.kts' --- # Java Version Upgrades When the task changes the Java version of this project (compiler release, toolchain, `java.version`), use the `java-upgrade` skill. It detects the current version and loads only the matching guide for Java 11 → 17, 17 → 21 or 21 → 25. If the skill is not installed, install it with `gh skills install github/awesome-copilot java-upgrade` or copy `skills/java-upgrade/` from this repository. - Upgrade one LTS version at a time and run the full test suite after each step. - Check the minimum Java version supported by the project's frameworks and dependencies before raising the target.
© github · MIT · github/awesome-copilot