android-clean-architecture

android-clean-architecture 技能概览

android-clean-architecture 技能帮助你把 Android 和 Kotlin Multiplatform 应用建立在清晰边界之上，而不是靠零散的功能代码堆叠。它最适合需要一个务实架构起点的工程师，用来规划模块、依赖规则、UseCases、Repositories 和 data layer 设计——而不是听一堂泛泛而谈的理论课。

这个技能适合做什么

当你需要判断逻辑该放在哪里、模块之间应该如何依赖，以及如何避免 UI、domain 和 data 关注点混成一层时，就该用 android-clean-architecture。如果你正在统一一个新代码库的结构，或者重构一个不断膨胀的应用，它尤其有用。

最适合哪些人

这个 android-clean-architecture 技能适合正在开发 Android 应用、KMP 共享代码，或基于 Compose 的产品团队，尤其是那些已经明显感到耦合过紧的项目。它也适合你在 feature modules、layered modules 和更简单的单模块清晰边界方案之间做选择时使用。

主要差异点

和那种空泛的架构提示不同，android-clean-architecture 关注的是具体结构：模块布局、允许的依赖关系、repository 放在哪一层，以及 Room、SQLDelight、Ktor、Koin 或 Hilt 集成该落到哪里。所以当你想避免过度设计或不小心让层次互相渗透时，它会更偏向决策支持，而不是抽象讨论。

如何使用 android-clean-architecture 技能

安装并激活它

先通过你的 skills manager 走一遍 android-clean-architecture 的安装流程，然后打开 skill 文件，在规划或编辑架构时让它始终处于上下文中。如果你的环境支持按路径加载，就把它指向 skills/android-clean-architecture/SKILL.md，这样模型在执行任务时就能遵循这些架构规则。

给它一个具体的架构任务

android-clean-architecture 的使用效果最好是在你要求一个明确结果时，比如模块拆分、依赖映射或分层归位。好的输入会明确平台、当前技术栈和约束条件。

示例提示词：

• “为一个带 offline sync 的 Compose + Hilt 应用设计 android-clean-architecture 模块布局。”
• “使用 Android 上的 Room 和共享代码中的 SQLDelight，把这个 KMP 功能重构为 android-clean-architecture 分层。”
• “审查这些 modules，并指出依赖规则违反之处。”

先读对的部分

先看 SKILL.md，然后重点关注定义何时激活、推荐布局和依赖规则的部分。这些内容会直接影响实现选择。如果你的 repo 里只有这一个文件，就把这些部分当作唯一依据，再结合你自己的 package 名称和 build 配置去适配。

提供能提升输出质量的信息

给这个技能一份简短的现状清单：已有的 modules、持久化工具、DI 框架、网络栈，以及应用是仅 Android 还是 KMP。还要说明你希望保留什么，比如现有的功能边界或公开 API。你当前状态描述得越具体，android-clean-architecture 指南就越不容易凭空增加不必要的层次。

android-clean-architecture 技能 FAQ

android-clean-architecture 只适合新项目吗？

不是。android-clean-architecture 技能既适用于 greenfield，也适用于重构工作。它在你需要给一个已经变得混乱的现有应用建立边界时最强，因为它能帮你决定该移动什么，而不是一次性推倒重来。

它和普通提示词有什么不同？

普通提示词也能让模型讨论分层架构，但 android-clean-architecture 提供的是面向 Android 和 KMP 决策的聚焦结构。这意味着它在依赖方向、模块命名，以及 data source 和 repository 代码放置位置上，能给出更具体的指引。

它适合初学者吗？

适合，只要你愿意从一个明确的模块地图开始。它不太适合那些只想要一段高层次 Clean Architecture 解释、却不关心实现细节的人。初学者在用它验证一个简单、明确的结构时，收益最大；如果结构过于庞杂，反而不利于理解。

什么时候不该用它？

如果你的应用很小、团队本来就刻意不采用分层架构，或者你只需要快速完成一个功能实现而不涉及模块化设计，就不要用 android-clean-architecture。那种情况下，这个技能可能会给你加上你根本不需要的结构。

如何改进 android-clean-architecture 技能

明确你需要做出的架构决策

提升 android-clean-architecture 输出最快的方式，是一次只让它回答一个决策：模块边界、依赖图、数据流，或者 DI 连接方式。如果你直接问“最好的架构是什么”，结果通常不如“在这个 KMP repository 方案里，缓存应该放在哪里”这种具体问题有用。

把真实约束告诉它

说明你的技术栈和限制条件：只做 Android 还是 KMP，Compose 还是 XML，Room 还是 SQLDelight，Ktor 还是 Retrofit，Hilt 还是 Koin，以及是否必须 offline-first。这些细节会改变推荐结构，也能避免通用的 android-clean-architecture 指南错误地贴合到不合适的后端或存储模型上。

注意常见失败模式

最常见的错误，是让每个功能都各自拥有一套小型架构，却没有共享规则。另一个常见问题，是因为图快，把业务逻辑塞进 presentation 代码里。要尽早用这个技能检查这些边界，然后结合你真实的 package tree 和 build files 进行修正。

用贴近 repo 的后续问题继续迭代

第一次输出后，可以让它做一次依赖审计，或者按你当前目录树给出逐文件的归位方案。比如：“把这些现有 packages 映射到 android-clean-architecture 布局，并标出哪些应该移动到 domain 或 data。” 这种后续问题能把这个技能从概念指南，真正变成迁移工具。