android-native-dev
作者 MiniMax-AIandroid-native-dev 是一项聚焦 Android 原生开发的技能，覆盖 Kotlin、Jetpack Compose、Material Design 3、项目初始化、无障碍和构建排障。它帮助团队评估仓库状态、初始化或修复 Android 项目，并以更少的猜测交付可构建的 UI。
该技能得分为 84/100，说明它很适合作为面向 Android 原生应用开发者的目录收录项。仓库提供了足够的工作流指引、约束和参考资料，能让代理在执行时比通用提示更少依赖猜测；不过，它更适合用作标准与流程指南，而不是一个高度可直接执行的自动化技能。
- Android 原生指导范围清晰，描述中的触发场景也很明确：Kotlin/Compose、Material Design 3、项目配置、无障碍和构建排障。
- SKILL.md 中包含了较完整的工作流内容和约束，包括项目状态评估、必查文件以及优先构建的原则，能帮助代理更快判断下一步动作。
- 9 份配套参考文档覆盖无障碍、响应式屏幕、性能、隐私、动效和测试，为实现决策提供了很强的可复用支撑。
- 没有提供安装命令或脚本，因此采用方式更依赖阅读文档，而不是运行一套专用工作流。
- 仓库以文档为主，遇到具体实现细节和项目特有边界情况时，代理仍可能需要人工判断。
android-native-dev 技能概览
android-native-dev 是一套聚焦的 Android 原生开发指南，面向使用 Kotlin、Jetpack Compose、Material Design 3 以及生产级应用搭建的团队和智能体。它最适合的场景，不是一个笼统的提示词就能解决的问题：你需要一套可重复的方法，去初始化、验证并改进 Android 应用，同时考虑正确的项目文件、UI 约束、无障碍检查和构建稳定性。如果你在做 android-native-dev for Frontend Development，它的核心价值在于把一个粗略的 Android UI 需求，转化为尊重平台规则的实现方案，而不是随意套用 Web 风格布局。
它最适合什么场景
当任务是启动或修复原生 Android 项目、用 Compose 添加页面，或者让现有应用更符合 Android 规范时，使用 android-native-dev 技能最合适。它尤其适用于你在写功能代码之前，就需要关注应用结构、gradle.properties、wrapper 配置、无障碍、响应式布局以及构建排障的情况。
它的区别在哪里
和含糊的 Android 提示词不同，android-native-dev 提供的是一套以项目状态为锚点的工作流：空目录、半成品项目、已有 wrapper，或完整的 Android Studio 项目。之所以重要，是因为很多落地失败并不是卡在 UI 设计，而是卡在初始化和配置。这个技能还会指向无障碍、适配大屏、动效、性能、隐私和测试等配套参考，比简单的“做一个应用页面”提示更实用。
什么时候它最合适
如果你希望产出的是符合以下特征的原生 Android 内容，这个技能很合适：
- 以 Compose 为先，或面向现代 Android UI
- 符合 Material Design 3 约定
- 可与基于 Gradle 的项目结构配合
- 重视无障碍和大屏行为
- 更不容易在构建或基础配置上出错
如何使用 android-native-dev 技能
安装并确认适用范围
在你使用的 skills manager 里运行 android-native-dev install 命令，然后确认这个技能适用于 Android 原生工作，而不是跨平台 UI。最关键的输入是你的项目状态：告诉模型你现在是空文件夹、未完成的 repo、Android Studio 项目，还是已经有 Gradle wrapper。这个信息决定它是应该初始化、修复，还是继续扩展。
把粗略目标转成有用的提示词
一条高质量的 android-native-dev usage 提示词应该包含：
- 应用类型和目标用户
- 当前 repo 状态
- 目标 UI 框架，通常是 Compose
- 要构建的页面或功能
- 任何约束，例如无障碍、平板支持或不能联网
例如，不要只说“做一个登录页”，可以改成：
Using android-native-dev, create a Jetpack Compose login flow for a finance app. The repo already has a Gradle wrapper. Prioritize Material 3, accessible labels, error states, and a compact phone layout. Start by listing the files that must exist before implementation.
这样技能就有足够上下文，去做更好的架构和 UI 决策。
先读这些文件
在做 android-native-dev guide 的实际工作时，先看这些内容：
SKILL.md：工作流和场景判断references/functional-requirements.md：基于行为的约束references/accessibility.md：标签、对比度和触控目标references/adaptive-screens.md：平板、折叠屏和尺寸变化references/performance-stability.md：启动和崩溃风险约束
如果任务偏视觉设计，还要阅读 references/design-style-guide.md、references/visual-design.md 和 references/motion-system.md。如果涉及敏感数据或权限，起草 UI 之前先检查 references/privacy-security.md。
采用分阶段工作流
当你按阶段要求输出时，这个技能效果最好：
- 确认项目状态和缺失文件
- 明确页面或功能需求
- 生成或修复可构建的项目骨架
- 补充 UI 和校验细节
- 复查无障碍、性能和适配行为
这个顺序能减少一种常见失败模式：在 Gradle、AndroidX 或应用结构还没准备好之前，就直接进入 UI 编码。
android-native-dev 技能 FAQ
android-native-dev 只适合新项目吗？
不是。android-native-dev 技能同样适用于不完整的 Android repo，或者已经完成基础引导的项目。事实上，在这些场景里它往往更有价值，因为它可以在你改代码之前，先识别缺失的 wrapper 文件、配置空缺和项目状态问题。
使用它一定要用 Compose 吗？
Compose 是它的重要预期路径，但即使你是在比较 Compose 和更老的 XML 模式，这个技能对原生 Android 规划依然有用。如果你的 repo 还是以传统 XML 为主，它就不如 Compose-first 场景那么理想，但依然可以指导初始化、无障碍和适配行为。
它和普通的 Android 提示词有什么不同？
普通提示词通常直接要功能。android-native-dev 则先关注可构建性、仓库状态和 Android 特有约束。这样更适合真实实现工作，因为它会先暴露缺少 gradle.properties、wrapper 配置或无障碍缺口这类阻塞点，避免你把时间浪费在表面打磨上。
什么时候不该用它？
如果你在做跨平台移动开发、只做后端 Android 服务，或者只是做一个不打算落地为原生 Android 代码的设计稿，就不该优先用 android-native-dev。如果你的目标是宏观产品策略，而不是手把手的 Android 实现指导，它也不是最合适的选择。
如何改进 android-native-dev 技能
先把项目状态说清楚
质量提升最大的一步，是先说明 repo 是空的、半成品，还是已经可以构建。如果你只说“帮我做应用”，技能就必须猜太多。若你说的是“Android Studio 项目，缺少 wrapper，但 Compose 页面已经存在”，它就能直接聚焦真实缺口，避免过度初始化项目。
明确不可妥协项
为了更好的 android-native-dev usage，请写清会影响实现决策的约束：
- 无障碍需求，比如 TalkBack 标签或对比度
- 屏幕目标，比如只支持手机，还是要兼顾平板/折叠屏
- 性能约束，比如启动要快
- 安全约束，比如尽量减少权限
- 视觉约束，比如 Material 3 或严格的品牌风格
这些细节很重要，因为它们会直接改变布局、状态处理和组件选择。
要求验证，不只要求生成
一个常见失败模式，是拿到一份看起来不错、但构建或 UX 基础不完整的代码。可以要求技能验证 ./gradlew assembleDebug、列出必需文件，并检查无障碍或适配大屏的缺口。如果第一次输出不完整，就按缺失文件集、页面实现、复查这三个阶段继续迭代。
给出好输出和差输出的示例
如果你已经知道“好”的标准，就直接说出来。比如：I want a compact, production-style settings screen, not a marketing layout. 这能帮助 android-native-dev skill 避免走向装饰性 UI，并始终贴合真正的 Android 前端开发工作。