android-architecture-clean

Android 架构整洁化

适用场景

• 当请求涉及以下内容时使用此技能：Android 中的整洁架构、拆分用例和存储库、理清表示层与数据层。
• 主要目标：在 Android 项目中应用整洁架构边界、用例、存储库和感知生命周期的表示模型。
• 当范围扩大时，转交给以下技能：
• android-modularization
• android-state-management

工作流

1. 将请求对应到当前 Android 技术栈、模块边界和最低支持 API 级别。
2. 检查现有实现中的隐含假设、重复辅助工具和过时模式。
3. 进行最小幅度的更改，以提升正确性、可读性和长期可维护性。
4. 对照相关示例应用路径和仓库基准验证结果。
5. 仅在核心基础稳定后，才将相关工作转交给下一个专门技能。

守护原则

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

反模式

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

示例

顺利路径

• 场景：拆分 OrbitTasks 功能状态、用例和存储库契约。
• 命令：cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest

边缘情况

• 场景：保持 XML activity 操作精简，同时保留已保存状态行为。
• 命令：cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest

故障恢复

• 场景：针对模块化和状态管理请求，捕捉触发条件混淆问题。
• 命令：python3 scripts/eval_triggers.py --skill android-architecture-clean

完成检查清单

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

官方参考资料

• https://developer.android.com/topic/architecture
• https://developer.android.com/topic/architecture/recommendations
• https://developer.android.com/jetpack/guide
• https://developer.android.com/topic/libraries/architecture/viewmodel