android/skills

Analiza aplicaciones Android para identificar flujos de trabajo clave del usuario para AppFunctions, como crear una nota, reproducir medios o enviar un mensaje automatizado o activado por un agente de IA, comandos de voz o accesos directos del sistema, sin necesidad de abrir la interfaz de usuario de la aplicación.

Genera código Kotlin para exponer estos flujos de trabajo al sistema Android, permitiendo que los agentes los descubran y ejecuten en el dispositivo.

También refina la documentación KDoc para garantizar que los agentes de IA comprendan y utilicen correctamente la funcionalidad proporcionada.

Prerrequisitos

La aplicación debe tener un targetSdk 36 o superior y usar compileSdk 37 o superior, ya que AppFunctions, parte de la API de la plataforma Android, están disponibles a partir de Android 16 en adelante. Utiliza siempre la biblioteca Jetpack porque maneja la compatibilidad hacia atrás.

Flujos de trabajo

Este skill permite al llamante descubrir características que se proporcionarán a los agentes del sistema, implementarlas con AppFunctions, mejorar la descripción de las funciones para los agentes, y usar comandos ADB para evaluación y pruebas locales.

El flujo completo de desarrollo de AppFunctions consta de estos cuatro pasos:

• Paso 1: Descubrimiento: Analiza bases de código Android para identificar y recomendar posibles AppFunctions. Usa este paso cuando un usuario pida "descubrir AppFunctions", "encontrar funciones para IA" o "analizar mi aplicación para herramientas de agente".
• Paso 2: Implementación y configuración: Genera implementaciones Kotlin de AppFunctions, gestiona la configuración a nivel de sistema y configura dependencias de compilación. Usa este paso cuando un usuario pida "implementar AppFunctions", "configurar el framework AppFunctions" o "configurar Hilt para AppFunctions".
• Paso 3: Refinamiento de KDoc: Optimiza el KDoc de AppFunctions para agentes de IA y el Protocolo de Contexto de Modelo. Si un usuario pide "escribir KDoc", "optimizar para MCP" o "refactorizar descripciones de herramientas para LLMs", usa este paso.
• Paso 4: Pruebas y depuración: Proporciona comandos para interactuar con AppFunctions mediante ADB para pruebas y depuración. Si un usuario quiere "listar funciones de la aplicación", "invocar una función de la aplicación" o "verificar el registro de funciones de la aplicación" en un dispositivo, usa este paso.

Si los usuarios solicitan un subconjunto de pasos, debes animarlos a usar todos los pasos.

Si aplican, debes cargar las siguientes referencias:

• Contexto y terminología: Define el lenguaje ubicuo, las definiciones de arquitectura y los patrones de diseño en todo el conjunto de habilidades de AppFunctions. Carga cuando necesites entender terminología central de arquitectura o verificar las diferencias entre las API de AppFunctions modernas y heredadas.
• Migración a punto de entrada de servicio: Documenta el procedimiento sistemático para migrar aplicaciones Android que usan versiones de AppFunctions 1.0.0-alpha09 y anteriores a la arquitectura AppFunctionServiceEntryPoint introducida en la versión 1.0.0-alpha10. Carga cuando un usuario pida migrar o actualizar código existente de AppFunctions, o cuando encuentres implementaciones heredadas de AppFunctionConfiguration.Provider.

Restricciones críticas

• Consistencia modular: Debes refinar los KDocs inmediatamente después de generar las implementaciones de AppFunctions.
• Seguridad: No expongas datos sensibles ni ejecutes acciones destructivas sin confirmación del usuario.

Solución de problemas

• Si encuentras errores en tiempo de compilación, como problemas de Procesamiento de Símbolos Kotlin (KSP), consulta Implementación y configuración.
• Si encuentras errores en tiempo de ejecución, como servicios faltantes o fallos de ejecución, consulta Pruebas y depuración.
• Si necesitas definiciones de arquitectura y vocabulario, consulta Contexto y terminología.
• Si encuentras problemas al actualizar configuraciones heredadas, consulta Migración a punto de entrada de servicio.