Analisa aplicativos Android para identificar workflows de usuário para AppFunctions, como criar uma nota, reproduzir mídia ou enviar uma mensagem automatizada acionada por agente de IA, comandos de voz ou atalhos do sistema, sem precisar abrir a UI do app.
Gera código Kotlin para expor esses workflows ao sistema Android, permitindo que agentes os descubram e executem no dispositivo.
Também refina a documentação KDoc para garantir que os agentes de IA entendam e usem corretamente a funcionalidade fornecida.
Pré-requisitos
O aplicativo deve ter targetSdk 36 ou mais recente e usar compileSdk 37 ou mais recente, pois as AppFunctions, parte da API da plataforma Android, estão disponíveis a partir do Android 16. Use sempre a biblioteca Jetpack, pois ela lida com compatibilidade reversa.
Workflows
Esta skill permite que o chamador descubra funcionalidades que serão fornecidas a agentes do sistema, implemente-as com AppFunctions, melhore a descrição das funções para agentes e use comandos ADB para avaliação e teste locais.
O fluxo completo de desenvolvimento de AppFunctions consiste nestas quatro etapas:
- Etapa 1: Descoberta: Analise bases de código Android para identificar e recomendar possíveis AppFunctions. Use esta etapa quando um usuário pedir para "descobrir AppFunctions", "encontrar funcionalidades para IA" ou "analisar meu app para ferramentas de agente".
- Etapa 2: Implementação e configuração: Gere implementações Kotlin de AppFunctions, gerencie a configuração em todo o sistema e configure dependências de build. Use esta etapa quando um usuário pedir para "implementar AppFunctions", "configurar o framework AppFunctions" ou "configurar Hilt para AppFunctions".
- Etapa 3: Refinamento de KDoc: Otimize o KDoc de AppFunctions para agentes de IA e Protocolo de Contexto de Modelo (MCP). Se um usuário pedir para "escrever KDoc", "otimizar para MCP" ou "refatorar descrições de ferramentas para LLMs", use esta etapa.
- Etapa 4: Teste e depuração: Forneça comandos para interagir com AppFunctions usando ADB para teste e depuração. Se um usuário quiser "listar funções do app", "invocar uma função do app" ou "verificar registro de função do app" em um dispositivo, use esta etapa.
Se os usuários solicitarem um subconjunto de etapas, você deve incentivá-los a usar todas elas.
Se aplicável, você deve carregar as seguintes referências:
- Contexto e terminologia: Define a linguagem ubíqua, definições de arquitetura e padrões de design em todo o conjunto de skills AppFunctions. Carregue quando precisar entender a terminologia central da arquitetura ou verificar as distinções entre as APIs AppFunctions modernas e legadas.
- Migração para ponto de entrada de serviço: Documenta o procedimento sistemático para migrar aplicativos Android que usam versões 1.0.0-alpha09 e anteriores do AppFunctions para a arquitetura
AppFunctionServiceEntryPointintroduzida na versão 1.0.0-alpha10. Carregue quando um usuário pedir para migrar ou atualizar código AppFunctions existente, ou quando encontrar implementações legadas deAppFunctionConfiguration.Provider.
Restrições críticas
- Consistência modular: Você deve refinar os KDocs imediatamente após gerar implementações de AppFunctions.
- Segurança: Não exponha dados confidenciais nem execute ações destrutivas sem confirmação do usuário.
Solução de problemas
- Se encontrar erros em tempo de compilação, como problemas com o Processamento de Símbolos Kotlin (KSP), consulte Implementação e configuração.
- Se encontrar erros em tempo de execução, como serviços ausentes ou falhas de execução, consulte Teste e depuração.
- Se precisar de definições de arquitetura e vocabulário, consulte Contexto e terminologia.
- Se encontrar problemas ao atualizar configurações legadas, consulte Migração para ponto de entrada de serviço.