android-native-dev

Visão geral do skill android-native-dev

O skill android-native-dev é um guia focado em desenvolvimento nativo Android para equipes e agentes que trabalham com Kotlin, Jetpack Compose, Material Design 3 e configuração de app em nível de produção. Ele é mais útil quando você precisa de algo além de um prompt genérico: você precisa de uma forma repetível de inicializar, validar e melhorar um app Android, com atenção aos arquivos certos do projeto, restrições de UI, checagens de acessibilidade e estabilidade de build. Se você estiver usando android-native-dev for Frontend Development, o principal valor é transformar uma solicitação crua de UI Android em um plano de implementação que respeita as regras da plataforma, em vez de improvisar um layout no estilo web.

Para que ele é melhor

Use o skill android-native-dev quando o trabalho for iniciar ou corrigir um projeto Android nativo, adicionar telas com Compose ou tornar um app existente mais alinhado às expectativas do Android. Ele é especialmente relevante se você se importa com estrutura de app, gradle.properties, configuração do wrapper, acessibilidade, layouts adaptativos e diagnóstico de build antes de escrever código de funcionalidades.

O que o diferencia

Ao contrário de um prompt vago sobre Android, android-native-dev oferece um fluxo de trabalho ancorado no estado do projeto: diretório vazio, projeto parcial, wrapper existente ou projeto completo do Android Studio. Isso importa porque a adoção costuma falhar na configuração, não no design da UI. O skill também aponta para referências de apoio sobre acessibilidade, telas adaptativas, motion, performance, privacidade e testes, o que o torna mais prático do que um simples prompt para “construir uma tela do app”.

Quando ele é uma boa escolha

Este skill é uma boa escolha se você quer uma saída nativa Android que seja:

• orientada a Compose ou a UI moderna do Android
• compatível com as convenções do Material Design 3
• adequada para configuração de projeto baseada em Gradle
• atenta a acessibilidade e comportamento em telas grandes
• menos propensa a quebrar em fundamentos de build ou configuração

Como usar o skill android-native-dev

Instale e confirme o escopo

Execute o comando android-native-dev install no gerenciador de skills que você usa para o diretório e depois confirme que o skill se aplica a trabalho nativo Android, e não a UI multiplataforma. O input mais importante é o estado do projeto: diga ao modelo se você tem uma pasta vazia, um repositório incompleto, um projeto do Android Studio ou um wrapper Gradle já existente. Isso determina se ele deve inicializar, corrigir ou estender o projeto.

Transforme um objetivo vago em um prompt útil

Um prompt forte de android-native-dev usage deve incluir:

• tipo de app e público-alvo
• estado atual do repositório
• framework de UI desejado, normalmente Compose
• tela ou funcionalidade a ser construída
• restrições, como acessibilidade, suporte a tablets ou ausência de acesso à rede

Por exemplo, em vez de “faça uma tela de login”, use:

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.

Isso dá ao skill contexto suficiente para tomar decisões melhores de arquitetura e UI.

Leia estes arquivos primeiro

Para um trabalho prático com android-native-dev guide, comece por:

• SKILL.md para workflow e avaliação do cenário
• references/functional-requirements.md para restrições orientadas a comportamento
• references/accessibility.md para labels, contraste e alvos de toque
• references/adaptive-screens.md para tablets, foldables e redimensionamento
• references/performance-stability.md para inicialização e restrições de risco de crash

Se a tarefa for visual, leia também references/design-style-guide.md, references/visual-design.md e references/motion-system.md. Se envolver dados sensíveis ou permissões, verifique references/privacy-security.md antes de rascunhar a UI.

Use um fluxo de trabalho em etapas

O skill funciona melhor quando você pede a saída em etapas:

1. confirmar o estado do projeto e os arquivos ausentes
2. definir os requisitos da tela ou funcionalidade
3. gerar ou corrigir o esqueleto do projeto que possa ser compilado
4. adicionar detalhes de UI e validação
5. revisar acessibilidade, performance e comportamento adaptativo

Essa sequência reduz o erro comum de ir direto para o código da UI antes que Gradle, AndroidX ou a estrutura do app estejam prontos.

FAQ do skill android-native-dev

O android-native-dev serve só para projetos novos?

Não. O skill android-native-dev também é útil para repositórios Android incompletos ou que já foram inicializados. Na verdade, muitas vezes ele é ainda mais valioso nesses casos, porque ajuda a identificar arquivos de wrapper ausentes, lacunas de configuração e problemas de estado do projeto antes das mudanças de código.

Preciso usar Compose para aproveitar o skill?

Compose é uma rota principal prevista, mas o skill ainda é útil para planejamento nativo Android mesmo se você estiver comparando Compose com padrões XML mais antigos. Se o seu repositório for fortemente baseado em XML legado, o skill é menos ideal do que em fluxos Compose-first, mas ainda pode orientar configuração, acessibilidade e comportamento adaptativo.

Como isso é diferente de um prompt genérico para Android?

Um prompt genérico normalmente pede funcionalidades. O android-native-dev pergunta primeiro sobre capacidade de build, estado do repositório e restrições específicas do Android. Isso o torna melhor para trabalho de implementação real, porque expõe bloqueios como gradle.properties ausente, configuração do wrapper ou lacunas de acessibilidade antes que você perca tempo com acabamento visual.

Quando eu não deveria usar?

Não use android-native-dev se você estiver fazendo trabalho mobile multiplataforma, serviços Android apenas de backend ou um mockup só de design sem intenção de implementar código Android nativo. Ele também é uma opção mais fraca se você quer estratégia ampla de produto em vez de orientação prática de implementação Android.

Como melhorar o skill android-native-dev

Informe o estado do projeto logo de cara

O maior salto de qualidade vem de dizer se o repositório está vazio, parcial ou já compila. Se você disser apenas “construa meu app”, o skill precisa inferir demais. Se você disser “projeto do Android Studio, sem wrapper, telas Compose já existem”, ele consegue focar na lacuna real e evitar inicializar o projeto além do necessário.

Especifique os não negociáveis

Para melhorar o android-native-dev usage, inclua restrições que afetam decisões de implementação:

• necessidades de acessibilidade, como labels do TalkBack ou contraste
• alvos de tela, como apenas celulares ou suporte a tablet/foldable
• restrições de performance, como inicialização rápida
• restrições de segurança, como minimizar permissões
• restrições visuais, como Material 3 ou um estilo de marca rígido

Esses detalhes importam porque mudam layout, tratamento de estado e escolha de componentes.

Peça validação, não só geração

Um modo comum de falha é receber código que parece bom, mas ignora fundamentos de build ou UX. Peça para o skill validar ./gradlew assembleDebug, identificar os arquivos obrigatórios e checar lacunas de acessibilidade ou de telas adaptativas. Se a primeira saída vier incompleta, itere pedindo primeiro o conjunto de arquivos faltantes, depois a implementação da tela e, por fim, a revisão.

Dê exemplos do que é bom e do que é ruim

Se você já sabe como “bom” deve parecer, diga isso. Por exemplo: “Quero uma tela de configurações compacta, com aparência de produção, não um layout de marketing.” Isso ajuda o android-native-dev skill a evitar UI decorativa e a ficar alinhado com o trabalho real de frontend Android.