Analisa aplicativos Android para identificar fluxos de trabalho chave do usuário para AppFunctions, como criar uma nota, reproduzir mídia ou enviar uma mensagem automatizada ou acionada por agente de IA, comandos de voz ou atalhos do sistema, sem precisar abrir a interface do aplicativo.
Gera código Kotlin para expor esses fluxos de trabalho ao sistema Android, permitindo que agentes os descubram e executem no dispositivo.
Também refina a documentação KDoc para garantir que 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.
Sempre use a biblioteca Jetpack, pois ela lida com compatibilidade reversa.
Fluxos de trabalho
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: Analisa bases de código Android para identificar e recomendar AppFunctions potenciais. Use esta etapa quando um usuário pedir para "descobrir AppFunctions", "encontrar funcionalidades para IA" ou "analisar meu aplicativo para ferramentas de agente".
- Etapa 2: Implementação e configuração: Gera implementações de AppFunctions em Kotlin, gerencia a configuração em todo o sistema e configura dependências de compilação. Use esta etapa quando um usuário pedir para "implementar AppFunctions", "configurar o framework de AppFunctions" ou "configurar Hilt para AppFunctions".
- Etapa 3: Refinamento de KDoc: Otimiza KDoc de AppFunctions para agentes de IA e Model Context Protocol. 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: Fornece comandos para interagir com AppFunctions via ADB para teste e depuração. Se um usuário quiser "listar funções do aplicativo", "invocar uma função do aplicativo" ou "verificar registro de função do aplicativo" em um dispositivo, use esta etapa.
Se os usuários solicitarem um subconjunto das etapas, você deve incentivá-los a usar todas as etapas.
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 de AppFunctions. Carregue quando precisar entender a terminologia central da arquitetura ou verificar as distinções entre APIs de AppFunctions modernas e legadas.
- Migração para ponto de entrada de serviço: Documenta o procedimento sistemático para migrar aplicativos Android que usam AppFunctions versões 1.0.0-alpha09 e anteriores 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 as implementações de AppFunction.
- Segurança: Não exponha dados confidenciais nem execute ações destrutivas sem confirmação do usuário.
Solução de problemas
- Se você encontrar erros em tempo de compilação, como problemas no Kotlin Symbol Processing (KSP), consulte Implementação e configuração.
- Se você 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.