Agent Skills
返回列表
💻

Android Kotlin 工程化技能

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/alinaqi-maggy-android-kotlin。

技能介绍

解决什么

现代 Android 项目用 Kotlin 开发时有一些拿不起来就一定踩坑的细节:ViewModel 在主线程被 runBlocking 阻塞、用 GlobalScope 触发结构化并发失效、在 init 里直接 collect 一个 Flow 导致泄漏、把 MutableStateFlow 直接暴露给 UI,或者 Compose 里出现副作用与不稳定参数引发不必要重组。问题零散,且多数属于编译通过但上线后崩溃的类型。

技能如何工作

先给出按职责分层的项目结构,再补上 build.gradle.kts 的 Gradle Kotlin DSL 配置,保证模块边界与依赖声明可维护。核心链路是:Repository 用 Flow 承载数据流;ViewModel 通过 StateFlow 向 UI 暴露不可变状态,并用 viewModelScope 做结构化并发;Screen 用 LaunchedEffect 或 collectAsStateWithLifecycle 收集流,避免在 init 中收集。

状态表达统一走 sealed class,如 Result wrapper 覆盖 Success/Error/Loading 等有限集合,让类型系统替你在分支里兜住缺漏。测试层用 MockK 打桩,Turbine 断言 Flow 时序;ViewModel 测试覆盖发射序列。工程侧再补 GitHub Actions CI 与 detekt.yml,把反模式和静态检查接进流水线。

适用边界与注意点

  • 反模式清单是取舍参考,不是教条:GlobalScope 之所以禁止,是因为它脱离生命周期;换成 viewModelScope 或 lifecycleScope 的前提是作用域定义正确。
  • repeatOnLifecycle 与 collectAsStateWithLifecycle 本身拿来对齐生命周期,但如果收集条件不成立,它们不会替你修复业务逻辑错误。
  • catch 只能吞掉你明确要吞的异常;忘了在 Flow 链条里处理时,它并不会自动兜底。
  • Compose 参数不稳定时,@Stable 是为了让编译器相信它可预测,而不是在运行期改变类型;把它当作修性能的入口,不要当作跳过重组的开关。
  • 这个技能适合中大型或需要可测试、可回归的 Android 项目;Demo 或原型里过度套用分层,会让简单需求跑得比手写还重。

使用场景

  • 接手新 Android 项目,需要按职责分层搭建模块结构并用 Kotlin DSL 写 build.gradle.kts
  • 写 ViewModel 时用 StateFlow 暴露不可变态,并用 viewModelScope 管理协程作用域
  • 用 sealed class 封装 Result 状态,配合 MockK 与 Turbine 给 ViewModel 补全用例
  • 给仓库层加 Flow 数据流,并在 Compose 中用 collectAsStateWithLifecycle 收集

适合人员

  • 初级 Android 工程师,想按现代规范搭起协程、Flow 和 Compose 的代码骨架
  • 需要重构老项目协程用法的技术负责人,要替换 GlobalScope 并统一状态暴露方式
  • 负责 CI 的工程师,想用 GitHub Actions 跑通构建、detekt 检查与测试门禁
  • 正在学状态管理与测试的开发者,需要一份可直接对照的 ViewModel 测试样板