Comunidade

Por dentro das habilidades do Android: criado para descontinuação

Leitura de 4 min
Ver o perfil de Jose Alcérreca
Jose Alcérreca Engenheiro de relações com desenvolvedores

Lançamos as habilidades oficiais do Android  em abril, e a resposta superou todas as nossas expectativas. Nesta postagem do blog, vou abordar alguns dos feedbacks que recebemos, explicando a filosofia e a metodologia por trás do projeto. Esperamos que isso também ajude você a entender o que acontece nos bastidores quando você instala e usa habilidades, permitindo que você aproveite melhor os tokens e seu próprio tempo.

Por que há tão poucas habilidades oficiais?

No momento, só consideramos novas habilidades quando há uma lacuna de conhecimento verificável nos modelos de última geração (SOTA, na sigla em inglês). Em outras palavras, você não precisa ensinar ao modelo o que ele já sabe. (Embora haja algumas exceções, continue lendo!)

Até agora, lançamos cerca de 20 habilidades oficiais, que visam intencionalmente áreas altamente específicas e em rápida evolução que os modelos padrão ainda não dominam totalmente, como AGP 9, Navigation 3, APIs de câmera avançadas e Perfetto SQL.

E as habilidades principais, mais gerais? Cada habilidade instalada injeta de 100 a 200 tokens no contexto de referência de cada tarefa que você inicia. Se essa skill for ativada, essa contagem pode chegar rapidamente aos milhares. Na maioria dos casos, acumular habilidades básicas é contraproducente e caro. Antes de instalar uma habilidade para escrever em Kotlin ou Compose básico, considere se o LLM escolhido realmente precisa dela ou se já conhece esses tópicos o suficiente. 

Como avaliar habilidades

Antes do lançamento, cada habilidade é testada em um conjunto abrangente de avaliações que comprovam que ela oferece um valor claro. Essas avaliações precisam ser aprovadas quando a habilidade está ativa e reprovadas quando não está. As avaliações estão para as habilidades assim como os testes de integração estão para o código. 

timeout_s: 1200
repository:
  url: [redacted - internal git repo]
  working_dir: wear_compose_m3_empty_app
category_ids:
  - wear
prompt: |-
  Add a horizontal pager to MainActivity.kt. Have three pages in the pager. Each page should contain
  the text "Page 1", "Page 2", and "Page 3" respectively in the center of the screen.
commands:
  build:
    - ./gradlew assembleDebug
acceptance_criteria:
  project_builds: true
  llm_diff_judge:
    - Must use `HorizontalPagerScaffold`.
    - Each page should use `AnimatedPage` to wrap a `ScreenScaffold`.

Exemplo de avaliação que verifica a implementação correta de um pager horizontal em um app para Wear

No mínimo, testamos a habilidade no Android Studio usando o modelo mais recente do Gemini Flash. Dependendo da habilidade, também garantimos a compatibilidade com outros modelos, como o Gemini Pro, e outros agentes, como o Antigravity, além de sistemas de terceiros.

Todas as avaliações são executadas com acesso à base de conhecimento. Portanto, se as informações estiverem na documentação e os modelos decidirem pesquisá-las, não publicaremos uma habilidade para isso.

Como usar a base de conhecimento do Android (Android Studio ou CLI do Android)

Se você desenvolve apps Android, use sempre a base de conhecimento do Android para ter acesso à documentação oficial. Se você usa o agente no Android Studio, ele já está disponível como uma ferramenta, mas se você usa outro agente, instale a CLI do Android. Entre outras coisas, ele contém o comando docs, que dá ao agente acesso à documentação oficial do Android. Ter uma única ferramenta é muito mais eficiente do que instalar centenas de habilidades.

Se o modelo estiver agindo com excesso de confiança e você quiser que ele consulte a documentação com mais frequência, uma maneira muito comum de motivá-lo é adicionar "Sempre consulte a documentação oficial do Android ao lidar com APIs do Android" ao arquivo AGENTS.md ou equivalente. Claro, você também pode forçar isso pedindo ao agente para verificar a documentação diretamente nos seus comandos.

Por que as solicitações de pull estão desativadas?

Como nosso framework de avaliação depende de uma infraestrutura interna que não pode ser de código aberto, não podemos aceitar solicitações de pull diretas para novas habilidades. Sem essa infraestrutura, não teríamos como reavaliar as mudanças de PR recebidas. No entanto, monitoramos ativamente o feedback da comunidade. Se você quiser informar um bug, sugerir uma otimização ou solicitar uma nova habilidade oficial, registre um problema.

Quando as habilidades básicas ou essenciais fazem sentido?

Embora os modelos SOTA geralmente não precisem de habilidades básicas, há alguns cenários em que ativar habilidades principais ou criadas pela comunidade agrega valor real. Exemplo:

  • Você está usando comandos vagos: as habilidades ampliam sua intenção. Se você der um comando vago, como "adicione animações a esta tela", uma habilidade específica de animação do Compose pode inspirar o modelo, levando-o a APIs modernas ou padrões de teste de captura de tela que ele talvez não tenha considerado.
  • Você quer usar modelos menores e mais baratos: os LLMs de ponta são caros. Se você estiver transferindo tarefas rotineiras para modelos de peso aberto menores, como o Gemma 4, ativar as habilidades básicas preenche as lacunas de conhecimento que os parâmetros menores não cobrem.
  • Você está refatorando ou revisando código legado: os modelos são excelentes para gerar código que funciona, mas, ao editar bases de código antigas, eles geralmente priorizam a consistência com os padrões legados em vez de reescrever as coisas com precisão moderna. Um agente revisor especializado, equipado com habilidades essenciais, pode ajudar a quebrar esse hábito.
  • Você se desvia da norma: os LLMs adoram o "estilo Google" padrão de arquitetura de apps Android. Se a equipe usa uma arquitetura de camada de visualização altamente personalizada, o modelo terá dificuldade para se manter alinhado. Uma habilidade personalizada que descreve explicitamente sua arquitetura é muito útil.

Onde posso encontrar as habilidades principais?

A comunidade do Android está aqui para ajudar. Chris Banes tem uma coleção abrangente de habilidades para o Compose e o Kotlin, Ivan Morgillo publicou uma habilidade que audita projetos do Compose, e Jaewoong Eum criou duas sobre testes e desempenho. 

Sempre baixe habilidades de fontes confiáveis. Eu não confiaria em repositórios com dezenas ou centenas de habilidades do Android, porque provavelmente foram gerados com IA e não foram testados. Eles podem até conter instruções maliciosas ou tendenciosas. Além disso, não instale habilidades gerais de engenharia de software sem pensar. Muitas delas são personalizadas para o desenvolvimento da Web.

Objetivo: descontinuação

Parafraseando Karpathy: as habilidades de hoje estarão nos modelos de amanhã. À medida que os modelos SOTA continuam melhorando, esperamos que as habilidades se tornem obsoletas, especialmente aquelas criadas com base em novas APIs. Para descobrir quando desativá-los, executamos nossas avaliações quando novos modelos são lançados. Se forem aprovados, vamos mantê-los por alguns meses até que a maioria dos usuários tenha feito a transição. 

Escrito por:
Continue lendo