用途：升级 Kotlin 仓库自身构建所使用的 Gradle wrapper 版本（gradle/wrapper/gradle-wrapper.properties 中由 ./gradlew 下载的 distributionUrl）。它只针对 ./gradlew 运行的版本，与插件编译 API 版本、集成测试版本矩阵是不同任务。
主要能力：先做幂等检查（已为目标版本则停止）；从 services.gradle.org 获取 zip 的 SHA-256；用相同参数运行两次 ./gradlew wrapper 以重生成 wrapper；依次运行 help、publish、testClasses、functionalTest，暴露并修复版本相关编译与测试失败，包括被移除/弃用的 Gradle DSL、依赖校验元数据、嵌入版本号的 *.module 测试夹具，以及调用被删 Gradle API 的测试源码。
使用方式：输入 MAJOR.MINOR.PATCH 或含 -rc-N/-milestone-N/-nightly 的版本号，原样使用。运行期间需启用 Kotlin/Native（检查 local.properties 中 kotlin.native.enabled，若为 false 则注释掉），结束时无论成败都恢复 local.properties 原状。文件读写建议用 IDE MCP 工具；Gradle 命令用默认 Bash。两个常见失败墙可用命令行开关临时绕过但不写入配置文件：依赖校验用 -Foff，警告转错误用 -Pkotlin.build.disable.werror=true。依赖校验元数据用 ./scripts/update-verification-metadata.sh 重新生成而非手改校验和。
适用场景：Kotlin 仓库根 wrapper 的补丁/次要/主要版本升级。
限制：改动应尽量窄，每处修改都需对应明确的构建输出错误或警告，不支持顺手现代化、重命名、格式化或无关清理；不以 flag 收尾，仍依赖 flag 时需向用户说明；其他 3 个独立子构建的 gradle-wrapper.properties 不同步；不提交，交由用户自行审查提交。其余细节暂未提供。