Ir al contenido
Hagicode Docs
Blog

Instalar HagiTask

Edita esta página

A quién va dirigida: personas que quieren instalar tareas de la comunidad para usarlas en HagiCode.

Requisitos previos:

  • Puedes acceder a la aplicación HagiCode que utilizas y a su servicio backend.
  • Tu versión de la aplicación admite la gestión de tareas comunitarias HagiTask y la Community Gallery.
  • Ya están preparados los agentes, skills o dependencias de CLI que requiere la tarea; puedes consultar estos requisitos en sus detalles.

El procedimiento admitido actualmente consiste en obtener los detalles y el ZIP de la tarea en la Community Gallery de HagiTask Site y utilizar la función de instalación de tareas comunitarias de la aplicación:

  1. Busca tareas en la Gallery por nombre, categoría o etiquetas.
  2. Abre los detalles de la tarea y comprueba la versión, el editor, la compatibilidad y el tamaño de la instalación.
  3. Selecciona la opción de instalar. La aplicación obtiene el ZIP mediante packageUrl y verifica el ID de la tarea, la versión y la suma SHA-256.
  4. Tras verificarlo, la aplicación escribe el paquete en el directorio local de datos HagiTask y actualiza el catálogo de tareas.

Los puntos de acceso al catálogo, a los detalles y a los archivos son, respectivamente, /index.json, /tasks/<taskId>.json y /packages/<taskId>.zip. La instalación utiliza el archivo: no necesita analizar el contenido de las páginas del sitio.

Instalar desde un archivo

Si ya has obtenido un ZIP mediante un procedimiento admitido de la Gallery, puedes seleccionar la instalación desde un archivo local en la interfaz de gestión de tareas comunitarias. El archivo debe incluir el directorio completo del paquete; su ID, versión y resumen del contenido deben coincidir con la solicitud de instalación.

Subir una carpeta local desde el navegador no forma parte actualmente del proceso de instalación de la Community Gallery. La configuración de fuentes basadas en directorios del servidor tiene otra finalidad; consulta Usar HagiTask.

Comprobar la instalación

Después de instalar, comprueba en la interfaz de gestión de tareas comunitarias que:

  • La tarea muestra el taskId, la versión y el editor correctos.
  • La tarea está activada o se puede activar manualmente.
  • Los avisos de dependencias y compatibilidad no indican requisitos pendientes.
  • La tarea sigue apareciendo tras actualizar el catálogo y se puede abrir su panel.

El registro de instalación guarda el origen, la versión, el resumen del archivo y el estado de activación. Las tareas integradas se muestran en modo de solo lectura y no se pueden desinstalar como paquetes comunitarios.

Problemas habituales

Comprueba que la dirección de la Gallery configurada en la aplicación está disponible y utiliza HTTPS. Revisa también la red, los tiempos de espera y el estado del sitio. Si falla la primera descarga del catálogo, la aplicación no inventa un catálogo vacío; si existe una caché válida, puede mostrar temporalmente un catálogo anterior.

No se encuentra la tarea o sus detalles no son válidos

Utiliza el taskId canónico de los detalles, no un nombre alternativo. agentsmd y portytail son solo alias habituales de claude-md-update y ponytail, no ID de tareas instalables.

Falla la comprobación de integridad o versión

Vuelve a obtener el archivo desde la Gallery. No modifiques manualmente el ZIP ni los archivos de catálogo generados. Si el problema persiste, pide a los responsables del paquete que revisen los datos fuente y el número de versión en Community Packages.

La tarea no está disponible tras instalarla

Comprueba los requisitos de agentes, skills y CLI en los detalles de la tarea. Asegúrate de que está activada en la aplicación y actualiza el catálogo. Si el contenido del paquete no es válido, consulta la guía para contribuir a la comunidad para conocer el esquema y el proceso de validación.

Siguiente paso: Usar HagiTask.