Habilidad AI

En vcr-app-creator es una habilidad de agente de IA que proporciona orientación experta paso a paso para crear e implementar aplicaciones en Vonage Cloud Runtime. Una vez instalada, se activa automáticamente cada vez que le pides a tu asistente de IA que cree una aplicación VCR, escriba una vcr.yml manifestar, configurar secretos, desplegar, depurar localmente o publicar en Code Hub.

Instalación

npx skills add "vonage-technology/vonage-agent-skills" --skill vcr-app-creator

La habilidad está alojada en el vonage-agent-skills repositorio. Es compatible con cualquier asistente de codificación AI que soporte el protocolo de habilidades (Claude Code, GitHub Copilot CLI, Gemini CLI, y otros).

Qué hace la habilidad

Cuando se activa, la habilidad le guía a través de un flujo de trabajo estructurado:

  1. Comprender la aplicación - recopila el nombre del proyecto, el tiempo de ejecución, el ID de la aplicación de Vonage, las capacidades, la región y las funciones opcionales. Si no tienes un ID de aplicación de Vonage, la habilidad ejecuta vcr app create para ti.
  2. Genere vcr.yml - produce un manifiesto válido con sólo las secciones que tu aplicación necesita.
  3. Genere build.sh - produce un script de compilación apropiado para el tiempo de ejecución que instala las dependencias y compila el código sin iniciar la aplicación.
  4. Configurar el chequeo, el entorno y los secretos - añade el punto final de comprobación de salud necesario, explica las variables inyectadas en VCR y muestra cómo referenciar secretos de forma segura.
  5. Revisar y confirmar - presenta todos los archivos generados para su aprobación antes de escribir nada en el disco.
  6. Guía de implantación y depuración - recorre vcr debug para el desarrollo local y vcr deploy para la producción.
  7. Solución de problemas - diagnostica los fallos más comunes (desajuste de la ruta de comprobación, dirección de enlace incorrecta, falta de secretos, tiempo de ejecución no válido) con una rápida lista de comprobación.

La destreza también abarca:

  • Publicar en el VCR Code Hub / Marketplace utilizando la función neru-mcp Servidor MCP.
  • Mejores prácticas del SDK: alcance de la sesión, arquitectura sin estado y uso correcto del proveedor.
  • Migración desde el obsoleto neru-alpha al SDK actual (@vonage/vcr-sdk para Node.js, vonage_cloud_runtime para Python).

Activadores

La habilidad se activa automáticamente para indicaciones como:

  • "Crear una nueva aplicación VCR"
  • "Escribir un vcr.yml para mi aplicación Node.js"
  • "¿Cómo implemento en Vonage Cloud Runtime?".
  • "Configurar depuración vcr para desarrollo local"
  • "Publicar mi aplicación en Code Hub"
  • "Migrar desde neru-alfa"

No se activa para preguntas generales sobre la API de Vonage donde VCR no es la plataforma de alojamiento.