用途:在创建或审查 Kotlin 代码时提供语言层面的规范,覆盖 Kotlin 2.x/K2、null-safety、data 与 sealed 类、扩展函数、基础协程以及 JVM 互操作。Android UI 与异步细节分别由 jetpack-compose、android-development、kotlin-coroutines 等技能处理。
主要能力与约定:工具链方面,新代码使用 Kotlin 2.x/K2,遵循 Gradle/version catalog 中的 kotlin 配置,处理 kotlinc 警告,使 kotlinOptions.jvmTarget 与项目 minSdk/JDK 对齐;若仓库已用 ktlint/detekt 则沿用。组织上按领域分包,模块 API 用 internal,避免巨型 Utils.kt,顶层函数仅用于纯且稳定的辅助。语言上默认 val,data class 表示值、class 表示身份、value class 表示 ID,sealed class/interface 表示 Loading/Ready/Err 等状态并做穷尽 when;扩展函数用于类型不应知晓的 API,不用于隐藏副作用。null-safety 要求显式 T?,除局部不变量(Java 平台类型)外不用 !!,使用 ?.、?:、带消息的 requireNotNull,并在 JNI/SDK 边界标注 Java 的 @Nullable。API 设计优先默认参数而非大量重载,布尔参数用命名参数,错误策略在边界统一为 Result<T> 或 sealed 错误,不混用静默 runCatching 与领域异常。JVM/Android 互操作中,@JvmName/@JvmStatic/@JvmOverloads 仅用于被 Java 调用的 API。
限制与反模式:避免 Any 与级联 !!、可变全局状态的 object 单例、假定 Compose/@Composable、难读的嵌套 apply/also/let、无初始化保证的 lateinit。完成标准为 null-safety 诚实、状态用 sealed、API 默认值与命名参数清晰、无不合理 !!、代码已格式化并在触及核心时补测试。资料未提供安装命令、价格或平台信息。