Analyse les applications Android pour identifier les workflows utilisateur clés destinés aux AppFunctions, tels que la création d'une note, la lecture de médias ou l'envoi d'un message automatisé ou déclenché par un agent IA, des commandes vocales ou des raccourcis système, sans avoir à ouvrir l'interface utilisateur de l'application.
Génère du code Kotlin pour exposer ces workflows au système Android, permettant aux agents de les découvrir et de les exécuter sur l'appareil.
Affine également la documentation KDoc pour garantir que les agents IA comprennent et utilisent correctement les fonctionnalités fournies.
Prérequis
L'application doit avoir targetSdk 36 ou une version ultérieure et utiliser compileSdk 37 ou une version ultérieure, car les AppFunctions, faisant partie de l'API de la plateforme Android, sont disponibles à partir d'Android 16.
Utilisez toujours la bibliothèque Jetpack car elle gère la rétrocompatibilité.
Workflows
Cette skill permet à l'appelant de découvrir les fonctionnalités qui seront fournies aux agents système, de les implémenter avec AppFunctions, d'améliorer la description des fonctions pour les agents, et d'utiliser des commandes ADB pour l'évaluation et les tests locaux.
Le cycle de développement complet d'une AppFunction se compose de ces quatre étapes :
- Étape 1 : Découverte : Analyse les bases de code Android pour identifier et recommander des AppFunctions potentielles. Utilisez cette étape lorsqu'un utilisateur demande de « découvrir des AppFunctions », « trouver des fonctionnalités pour l'IA » ou « analyser mon application pour des outils agentiques ».
- Étape 2 : Implémentation et configuration : Génère des implémentations Kotlin d'AppFunctions, gère la configuration à l'échelle du système et configure les dépendances de build. Utilisez cette étape lorsqu'un utilisateur demande de « implémenter des AppFunctions », « configurer le framework AppFunctions » ou « configurer Hilt pour AppFunctions ».
- Étape 3 : Raffinement des KDoc : Optimise les KDoc des AppFunctions pour les agents IA et le Model Context Protocol. Si un utilisateur demande de « écrire un KDoc », « optimiser pour MCP » ou « refactoriser les descriptions d'outils pour les LLM », utilisez cette étape.
- Étape 4 : Test et débogage : Fournit des commandes pour interagir avec les AppFunctions via ADB pour les tests et le débogage. Si un utilisateur souhaite « lister les fonctions de l'application », « invoquer une fonction de l'application » ou « vérifier l'enregistrement des fonctions de l'application » sur un appareil, utilisez cette étape.
Si les utilisateurs ne demandent qu'un sous-ensemble des étapes, vous devez les encourager à utiliser toutes les étapes.
Si elles s'appliquent, vous devez charger les références suivantes :
- Contexte et terminologie : Définit le langage omniprésent, les définitions d'architecture et les modèles de conception de la suite de skills AppFunctions. À charger lorsque vous avez besoin de comprendre la terminologie d'architecture de base ou de vérifier les distinctions entre les API AppFunctions modernes et héritées.
- Migration vers le point d'entrée de service : Documente la procédure systématique de migration des applications Android utilisant les versions 1.0.0-alpha09 et inférieures des AppFunctions vers l'architecture
AppFunctionServiceEntryPointintroduite dans la version 1.0.0-alpha10. À charger lorsqu'un utilisateur demande de migrer ou de mettre à niveau du code AppFunctions existant, ou lorsque vous rencontrez des implémentations héritées deAppFunctionConfiguration.Provider.
Contraintes critiques
- Cohérence modulaire : Vous devez raffiner les KDoc immédiatement après avoir généré les implémentations AppFunction.
- Sécurité : N'exposez pas de données sensibles et n'exécutez pas d'actions destructrices sans confirmation de l'utilisateur.
Dépannage
- Si vous rencontrez des erreurs de compilation, telles que des problèmes de traitement symbolique Kotlin (KSP), consultez Implémentation et configuration.
- Si vous rencontrez des erreurs d'exécution, telles que des services manquants ou des échecs d'exécution, consultez Test et débogage.
- Si vous avez besoin de définitions d'architecture et de vocabulaire, consultez Contexte et terminologie.
- Si vous rencontrez des problèmes lors de la mise à niveau de configurations héritées, consultez Migration vers le point d'entrée de service.