Adingo001/staffer

agy staffer

El perfil de propósito general: un punto de entrada limpio para tareas que no encajan en ninguno de los especialistas. Su plantilla de prompt es deliberadamente mínima — el texto de la tarea, el entorno (directorio actual, rama, fecha), las reglas de trabajo compartidas y las salvaguardas de seguridad, nada más. Sin encuadre de rol ni formato fijo de cuerpo: la tarea define su propio entregable, y ningún contexto de plantilla específico del dominio puede desviar la ejecución.

Prefiere un especialista cuando uno encaje: researcher para estudios y análisis profundos, reviewer para segundas opiniones sobre código o planes, implementer para ediciones en el árbol de trabajo, ask para una pregunta rápida de un solo uso.

staffer también es la ruta a las herramientas nativas de agy que ningún especialista cubre — notablemente generación de imágenes: agy incluye una herramienta generate_image (verificada en v1.1.15; un PNG de 1024×1024 en ~30s). Indica la ruta de salida en la tarea, p.ej. staffer --prompt "genera un robot mascota en pixel art, guárdalo como assets/mascot.png".

Localizando el companion

Este archivo de skill reside en <raíz-del-plugin>/skills/staffer/SKILL.md; resuelve la ruta del companion relativa a este directorio de skill:

node "<directorio-skill>/../../companion/agy-companion.mjs" staffer [flags] --prompt "tarea"

Pasa el texto de la tarea del usuario textualmente mediante --prompt; usa --prompt-file <ruta> o --stdin para texto largo.

[!IMPORTANT] Ejecuta este comando sin sandbox — agy necesita un puerto localhost y su archivo de token OAuth, que los sandboxes del entorno ocultan. En Codex, solicita permisos elevados para el comando. Detalles: ../jobs/references/troubleshooting.md.

Recogiendo el resultado

El comando devuelve un ID de trabajo. Lee ../jobs/SKILL.md para la recogida del resultado y la recuperación: enviar, esperar el resultado final y luego validar según sea necesario. No observes proactivamente el progreso, leas registros ni inspecciones artefactos intermedios mientras se ejecuta. Observa solo cuando el usuario lo pida explícitamente; diagnostica un fallo o un resultado que requiera intervención bajo el protocolo de trabajos.

Banderas (todas opcionales)

• --prompt <texto> / --prompt-file <ruta> / --stdin — la tarea, de exactamente una de estas tres fuentes. Usa archivo/stdin para prompts largos en lugar de comillas de shell.
• --model <id> o --effort bajo|medio|alto — el modelo por defecto es gemini-3.8-flash-medium.
• --restricted / --unrestricted — perfil de permisos; staffer por defecto es unrestricted como los demás perfiles que usan herramientas, --restricted es la ruta de endurecimiento opcional.
• --continue (o --conversation <id>), --timeout <dur> (por defecto 60m, máximo 120m de límite de ejecución).

Reglas

• Pasa la tarea del usuario textualmente. Debido a que la plantilla no impone un formato de salida, indica el formato deseado en el texto de la tarea cuando el solicitante necesite uno específico.
• Pasa las autorizaciones explícitas del usuario textualmente. La plantilla deniega por defecto los efectos secundarios costosos o irreversibles (commits/pushes, borrar archivos fuera del espacio de trabajo, llamadas de red con efectos secundarios, comandos con cuota de pago); esa denegación solo se abre cuando la tarea misma solicita la operación.
• Una tarea general puede legítimamente editar archivos. El companion informa de cualquier cambio en el árbol de trabajo junto con el resultado — inspecciónalo (git diff) y confirma que es lo que la tarea pedía antes de continuar.
• Para errores y recuperación, sigue ../jobs/SKILL.md.

Para una conversación existente, --continue / --conversation <id> heredan su modelo registrado y perfil de permisos a menos que se sobrescriban explícitamente. Los valores por defecto sin restricciones anteriores se aplican a tareas nuevas.