kotlin-tooling-agp9-migration

此技能作为开发人员将 Kotlin Multiplatform (KMP) 项目过渡至 Android Gradle Plugin (AGP) 9.0 及更高版本的专业迁移助手。AGP 9.0 引入了重大变更，特别是旧版 Android 插件与 KMP 之间不相容，需要转至新的 com.android.kotlin.multiplatform.library 插件。该技能提供了一种系统化的方法来审计依赖项、现代化构建脚本，并实施新的推荐项目结构（即 KMP 模块与 Android 应用程序模块分离）。它专为在重大工具链升级期间遇到构建失败或结构性障碍的 Android 与 KMP 开发人员而设计。

• 使用内置脚本执行全面的项目分析，以识别插件配置、版本目录使用情况以及潜在的源代码集冲突。

• 指导从顶层 android {} 块过渡到封装的 kotlin { android {} } 配置模型。

• 自动化原始目录结构（如 src/androidMain、src/androidHostTest）的迁移，以符合 KMP 约定。

• 提供专家级说明，用于将 kapt 迁移至 KSP 或 com.android.legacy-kapt，以及在多平台环境中管理资源/测试的启用。

• 通过为简单的库更新与复杂的应用程序模块拆分提供清晰的路径（路径 A、B 或 C），支持架构决策。

• 首先运行内置的项目分析脚本，以生成模块类型与当前插件状态的摘要。

• 遵循逐步检查清单，确保命名空间设置、消费者 ProGuard 规则与构建变体解析均得到正确处理。

• 当遇到与 AGP 9.0、多平台插件不兼容相关的错误，或需要将单体式项目重构为新的 JetBrains 标准结构时，请使用此技能。

• 请注意，KMP 库中已移除 BuildConfig 支持，该技能提供使用 expected/actual 模式进行配置管理的解决方案。

• 在执行 build.gradle.kts 文件手动修改之前，请务必验证版本目录 (libs.versions.toml) 的一致性。