android-kotlin-core

Android Kotlin 核心

适用场景

• 在以下请求中使用此技能：Android 应用中的 Kotlin 代码清理、将冗长的 Android Java 风格 Kotlin 转换为简洁写法、使用密封类表示 UI 状态。
• 主要目标：在 Android 应用中安全地使用 Kotlin 惯用写法，包括可空性、数据类、密封类型、扩展函数和集合管道。
• 范围扩展时移交给以下技能：
• android-state-management
• android-testing-unit

工作流

1. 根据当前 Android 技术栈、模块边界和最低支持 API 级别明确请求范围。
2. 检查现有实现中的隐含假设、重复辅助代码和过时模式。
3. 采用最小改动来提升正确性、可读性和长期可维护性。
4. 根据相关示例应用路径和仓库基准验证结果。
5. 只有在核心基础稳定后，才将相邻工作移交给下一个专门技能。

防护措施

• 当官方 Android 和 Kotlin 指南与自定义的本地规范冲突时，优先遵循官方指南。
• 保持公共 API 简洁明确；避免使用会掩盖 Android 生命周期开销的巧妙抽象。
• 除非请求明确要求同时调整，否则不要将架构清理与产品行为变更混在一起。
• 记录可能影响旧模块或生成代码的兼容性限制。

反模式

• 在模块间零散添加辅助代码，却没有明确的归属边界。
• 在纯领域层或数据层中引入特定于框架的代码。
• 只需更改一个契约时，却重构所有相邻文件。
• 只暗示迁移说明，却不将其写明。

示例

顺利路径

• 场景：使用密封接口和不可变数据完善领域模型与 UI 状态模型。
• 命令：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest

边界情况

• 场景：处理跨越 XML Activity 边界的可空平台值。
• 命令：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest

故障恢复

• 场景：将宽泛的辅助对象重构为职责明确的扩展函数，同时不破坏调用点。
• 命令：python3 scripts/eval_triggers.py --skill android-kotlin-core

完成检查清单

• 实现路径明确、精简，并对应正确的 Android 界面。
• 已运行或更新相关示例命令和基准提示词。
• 当请求跨越技能边界时，已记录移交给相邻技能的事项。
• 官方参考资料涵盖所选模式以及主要迁移或故障排查路径。

官方参考资料

• https://developer.android.com/kotlin
• https://developer.android.com/build/kotlin-support
• https://kotlinlang.org/docs/coding-conventions.html
• https://kotlinlang.org/docs/null-safety.html