android-java

android-java 技能概览

android-java 是用来做什么的

android-java 是一个专注于 Android Java 的技能，适合在基于 Java 的 Android 应用代码中工作，尤其是在项目使用 MVVM、ViewBinding 和 Espresso 测试时最有用。当你需要 android-java skill 在不猜测项目 Android 结构的前提下编辑或扩展源文件时，它的价值最高。

适合谁使用

如果你正在修改 Android Java 应用里的页面、ViewModel、repository、Gradle 配置或测试代码，就应该使用这个 android-java skill。它很适合 Android 前端开发场景，尤其是主要任务是把 UI、状态和应用结构正确串起来，而不是从零设计一套新架构。

它的不同之处

它的核心价值在于对 Android 常见分层提供实用指导：data、domain、ui、依赖注入以及测试目录。相比通用的 Android 提示词，android-java guide 更能帮你保留项目约定，同时完成修改。若你的应用是 Kotlin 优先、Compose 优先，或者高度依赖某个框架，这个 skill 的帮助就会明显变小。

如何使用 android-java skill

安装并打开正确的文件

进行 android-java install 时，先通过你的目录工具或 skill 管理器添加这个 skill，然后先打开 SKILL.md。接着再阅读周边最关键的项目上下文：README.md、AGENTS.md、metadata.json，以及如果存在的话，rules/、resources/、references/ 或 scripts/ 目录。在这个仓库里，skill 的主体内容集中在一个文件中，所以 SKILL.md 是最重要的起点。

给 skill 一个具体的 Android 任务

android-java usage 最有效的方式，是在提示词里明确功能、文件范围和约束条件。不要只说“帮我处理 Android”，而要像这样说：“更新 app/src/main/java/.../ui/login/ 里的登录流程以支持错误状态，保持 MVVM，并为失败路径补上 Espresso 覆盖。” 这样 android-java skill 才有足够上下文，去正确判断分层位置、命名方式和测试范围。

编辑前先看仓库路径

先用 skill 里的文件树来定位工作范围：app/src/main/java/.../data 负责本地或远程数据访问，domain 放业务规则，ui 放 activities、fragments 和 ViewModel，androidTest 则用于仪器测试覆盖。如果不确定修改该放哪，先查看最近的 feature 目录，再沿着依赖向外追踪，不要一上来就重写整个应用。

用提示词明确架构和测试意图

高质量的 android-java guide 提示词应该直接写出架构预期和验收标准。比如：“新增一个获取用户详情的 repository 方法，通过 ViewModel 暴露出来，使用 ViewBinding 更新 fragment 界面，并为 repository 增加一个单元测试，再为成功路径补一个 Espresso 测试。” 这比泛泛的功能需求更好，因为它告诉 skill 哪些层必须改、你期待什么样的正确性证明。

android-java skill 常见问题

android-java 只适合前端开发吗？

不是。android-java for Frontend Development 这个侧重点确实存在，但这个 skill 也覆盖数据流、repositories、依赖注入以及会影响 UI 行为的测试。如果你的任务会碰到驱动页面的数据逻辑，它依然能帮上忙。

使用它一定要有现成的 Android Java 项目吗？

是的，这才是它最适合的场景。android-java skill 设计目标就是在已有的 Java Android 代码库中工作，仓库里已经有明确的目录结构和 Gradle 文件。它不是通用的 Java 后端 skill，也不适合拿来处理一个还没有任何结构的空白应用构想。

它和普通提示词有什么区别？

普通提示词往往只会给出泛化的 Android 建议。android-java 更适合在你希望模型尊重 Android 项目布局、把修改放在正确分层，并同时考虑 ViewBinding、MVVM 和 Espresso 时使用。这样可以减少第一版出来后还要大量返工的情况。

什么时候不该用它？

如果你的项目是纯 Kotlin、以 Jetpack Compose 为主，或者主要任务与 Android 源文件无关，就可以跳过 android-java install。如果你更需要的是深度产品设计帮助，而不是实现层面的帮助，它也不是最合适的选择。

如何改进 android-java skill

给它最小但完整的功能说明

最好的输出来自明确写出页面、数据源以及成功/失败行为的输入。比如：“在 FeatureFragment 中展示新 API 响应的 loading、empty 和 error 状态，并保持 ViewModel 是唯一负责格式化 UI state 的地方。” 这比“把页面做得更好”更有效，因为它限制了实现范围，也能避免不必要的重构。

说明会影响实现的约束

如果你的项目使用 Hilt、Retrofit、Room，或者已有的 ViewBinding 模式，请明确说出来。android-java skill 在你补充 minSdk、兼容性要求、测试类型，或是否要避免引入新库这些约束时，通常能产出更合适的代码。这些细节往往决定方案到底能不能真正上线。

要求测试并列出关注的边界情况

想提升 android-java usage 的质量，就要明确你需要哪一层测试，并列出你关心的边界情况。比如：“为 null response 的处理补单元测试，并为网络失败后点击 retry 补一个 Espresso 测试。” 这样可以推动 skill 不只停留在成功路径实现，而是更贴近真实 Android 应用的行为。

先通过文件放置结果来迭代

拿到第一版回答后，先检查修改是否落在正确的目录里，以及依赖是否仍然清晰地从 UI 流向 domain 再到 data。如果结果已经接近但还不够对齐，就用更窄的修改请求继续追问，例如“把解析逻辑移出 fragment”、“把这段逻辑保留在 repository 里”或“只改成 ViewBinding”。