用途:当问题涉及 Android/Gradle 构建性能、配置缓存(configuration cache)或 KSP 与 kapt 对比时使用。核心目标是诊断并改善构建性能,适用于构建速度、任务抖动、缓存未命中或 CI 墙钟时间问题,而非构建逻辑结构问题。
主要能力:识别问题属于本地开发者反馈时间、CI 构建时长还是两者;使用 --profile、--scan、配置缓存诊断或内置审计脚本逐条测量构建路径;检查 gradle.properties、插件接线、依赖声明、任务注册方式和模块约定中的常见性能隐患;一次应用一项高置信度优化并对比前后行为。
使用方式:先测量再提出修复,区分观察与推断。可读取 references/patterns.md 获取测量阶梯与常见性能异味,读取 references/scenarios.md 获取示例项目的审计入口。示例命令:python3 skills/android-gradle-build-performance/scripts/audit_build_performance.py examples/orbittasks-compose --json;bash skills/android-gradle-build-performance/scripts/run_examples.sh。
适用场景:Compose 或 XML 示例项目的构建缓存、配置缓存、KSP 与急切任务创建审计;在启用性能标志后复查回归;选择 CI 构建优化前对比不同夹具设置。
限制与护栏:不要在单一缓存、插件或依赖模式才是真正瓶颈时建议大范围重写;工具链支持时优先 KSP、配置缓存和惰性任务配置;动态依赖版本、变化模块和急切任务创建视为性能回归;CI 建议需先在示例项目上可复现再推广。范围扩大时可交接给 android-gradle-build-logic 或 android-ci-cd-release-playstore。官方参考包括 Gradle 性能、配置缓存、任务配置规避文档及 Android 构建优化与 KSP 文档。