lerchenflo/claudeskills

Analyse les applications Android pour identifier les workflows utilisateur clés pour AppFunctions (créer une note, lire un média, envoyer un message automatisé ou déclenché par un agent IA, commandes vocales ou raccourcis système) sans ouvrir l'interface utilisateur. 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. Améliore également la documentation KDoc pour garantir que les agents IA comprennent et utilisent correctement les fonctionnalités fournies.

Qu'est-ce que claudeskills ?

Cette compétence permet d'analyser des applications Android pour identifier des workflows utilisateur pouvant être exposés sous forme d'AppFunctions, telles que la création d'une note, la lecture de médias, l'envoi de messages automatisés ou déclenchés par un agent IA, les commandes vocales et les raccourcis système. Elle génère automatiquement le code Kotlin nécessaire pour intégrer ces fonctionnalités au système Android, éliminant le besoin d'ouvrir l'interface utilisateur de l'application. De plus, elle affine la documentation KDoc pour garantir que les agents IA comprennent et utilisent correctement les fonctionnalités exposées. La compétence prend en charge les applications ciblant `targetSdk 36` ou plus récent et `compileSdk 37` ou plus récent, et propose des workflows en quatre étapes : découverte, implémentation et configuration, raffinement KDoc, ainsi que test et débogage via ADB. Elle inclut également des références pour la terminologie et la migration vers l'architecture `AppFunctionServiceEntryPoint`.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Antigravity

npx skills add https://github.com/lerchenflo/claudeskills/tree/HEAD/android/appfunctions

Documentation

Analyse les applications Android pour identifier les workflows utilisateur clés pour AppFunctions tels que la création d'une note, la lecture de médias, l'envoi d'un message automatisé ou déclenché par un agent IA, les commandes vocales ou les raccourcis système, sans avoir besoin d'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.

Améliore également la documentation KDoc pour garantir que les agents IA comprennent et utilisent correctement les fonctionnalités fournies.

Prérequis

L'application doit utiliser targetSdk 36 ou plus récent et compileSdk 37 ou plus récent, 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 compétence permet à l'appelant de découvrir les fonctionnalités qui seront fournies aux agents système, de les implémenter avec des AppFunctions, d'améliorer la description des fonctions pour les agents, et d'utiliser les commandes ADB pour l'évaluation et les tests locaux.

Le flux de développement complet des AppFunctions 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 système et configure les dépendances de build. Utilisez cette étape lorsqu'un utilisateur demande d'« implémenter des AppFunctions », « configurer le framework AppFunctions » ou « configurer Hilt pour AppFunctions ».
Étape 3 : Raffinement KDoc : Optimise la KDoc des AppFunctions pour les agents IA et le Model Context Protocol. Si un utilisateur demande d'« écrire KDoc », « optimiser pour MCP » ou « refactoriser les descriptions d'outils pour LLMs », 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 demandent un sous-ensemble d'étapes, vous devez les encourager à utiliser toutes les étapes.

Si applicable, 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 compétences AppFunctions. Chargez lorsque vous avez besoin de comprendre la terminologie de l'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 antérieures d'AppFunctions vers l'architecture AppFunctionServiceEntryPoint introduite dans la version 1.0.0-alpha10. Chargez lorsqu'un utilisateur demande de migrer ou de mettre à niveau du code AppFunctions existant, ou lorsque vous rencontrez des implémentations héritées de AppFunctionConfiguration.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.