用途:面向仓库级兼容性与分阶段升级排序,把非常老的 Android 项目带到当前受支持基线,而非孤立的 Kotlin 清理或单库重构。触发场景包括升级旧 Android 代码库、版本提升后修复构建失败、迁移废弃 Android 模式、替换废弃类、解决旧 Gradle/AGP/Kotlin 问题、处理 16 KB 对齐、现代化架构与配置。
主要能力:诊断仓库形态(AGP、Gradle、Kotlin、AndroidX/support 库、SDK 级别、原生产物、废弃 API/类);生成安全升级顺序而非一次性全部升级;为 Compose 为主、View 系统与混合互操作项目分支迁移路径;确定性修复时替换废弃导入与类,否则输出明确整改项;发布前验证原生打包与 16 KB 对齐就绪;隔离主要阻塞后交接给专用 Android 技能。
使用方式:提供三种自动化模式——audit 只检查仓库并输出结构化诊断报告,不编辑文件;safe-apply 执行确定性编辑,如仓库清理、版本提升、明显的 support 库替换、清单规范化与直接的废弃 API 替换;report 汇总未解决阻塞、文件路径、问题签名与下一步应使用的专用技能。示例命令:python3 skills/android-modernization-upgrade/scripts/scan_project.py examples/fixtures/legacy-support-app;python3 skills/android-modernization-upgrade/scripts/generate_remediation_checklist.py examples/fixtures/legacy-mismatch-app;python3 skills/android-modernization-upgrade/scripts/check_16kb_alignment.py examples/fixtures/native-misaligned-app/app-release.apk。
适用场景:support 库时代项目、AGP/Kotlin 版本错配、废弃类替换、原生打包与页大小对齐检查。
限制与护栏:只自动应用确定且可审查的改动;能分阶段迁移就不重写;把 AGP、Gradle、Kotlin、SDK、AndroidX 与原生打包视为一个兼容图;不得静默丢弃废弃行为,须记录替换与验证路径。反模式包括一次性提升所有版本、默认对纯 View 旧应用套用 Compose 迁移建议、忽略原生库/ABI 打包/页大小对齐、在仍发布废弃类与 support 库时宣称已现代化。所需工具与参考文档见资料所列脚本与 references 文件;具体收费、价格与平台信息暂未提供。