hqc135/agy-worker

¿Qué hace agy-worker?

Una habilidad de Codex que delega tareas de codificación acotadas a la CLI oficial de Antigravity y verifica el resultado.

Descripción

Esta habilidad permite que un agente de IA (como Codex) subcontrate trabajos de codificación específicos a un trabajador externo gestionado por la CLI de Antigravity. La habilidad maneja la comunicación, la ejecución y la verificación, asegurando que el resultado cumpla con los criterios especificados.

Casos de uso

• Compilación y pruebas: Delegar la compilación de un proyecto o la ejecución de una suite de pruebas a un entorno aislado.
• Despliegue: Ejecutar scripts de despliegue en un entorno controlado.
• Análisis de código: Realizar análisis estáticos o dinámicos utilizando herramientas especializadas.
• Generación de código: Delegar la generación de fragmentos de código o la refactorización a un trabajador externo.

Cómo funciona

1. El agente principal (Codex) invoca la habilidad hqc135/agy-worker con una descripción clara de la tarea a delegar.
2. La habilidad utiliza la CLI de Antigravity para ejecutar la tarea en un entorno controlado.
3. Durante la ejecución, la habilidad monitorea el progreso y captura los logs de salida.
4. Una vez finalizada la tarea, la habilidad verifica los resultados (por ejemplo, comprobando códigos de salida, archivos generados o salida estándar).
5. La habilidad devuelve un resumen estructurado al agente principal, indicando éxito o fracaso, junto con los detalles relevantes (logs, errores, artefactos).

Parámetros de entrada

• task: (obligatorio) Descripción de la tarea a realizar, que debe ser acotada y específica.
• env: (opcional) Variables de entorno a pasar al trabajador.
• timeout: (opcional) Tiempo máximo de ejecución en segundos (por defecto: 300).
• working_dir: (opcional) Directorio de trabajo dentro del entorno del trabajador.

Ejemplo de uso

{
  "task": "Compilar el proyecto en /repo y ejecutar las pruebas unitarias",
  "env": {
    "NODE_ENV": "test"
  },
  "timeout": 600
}

Salida

La habilidad devuelve un objeto JSON con los siguientes campos:

• success: booleano que indica si la tarea se completó con éxito.
• output: texto con la salida estándar (stdout) del trabajador.
• errors: texto con la salida de error (stderr) del trabajador.
• exit_code: código de salida del proceso.
• duration: tiempo total de ejecución en segundos.

Dependencias

• Antigravity CLI: Debe estar instalada y accesible en el sistema.
• Codex: Esta habilidad está diseñada para ser utilizada con el plugin de Codex.

Consideraciones

• La tarea debe ser acotada (no más de 10-15 minutos de ejecución) para evitar tiempos de espera excesivos.
• La habilidad no maneja interacciones complejas con el usuario; se espera que el agente principal proporcione instrucciones claras.
• Los artefactos generados por el trabajador (archivos, imágenes, etc.) deben ser devueltos como parte de la salida o almacenados en una ubicación conocida.

Licencia

MIT