lessan/jobs

Trabajos

Utiliza runjob para entregar trabajo acotado a una CLI de modelo sin cabeza instalada y para mantener un libro de contabilidad de ejecución a nivel de máquina. Confirma que runjob esté en PATH; si no lo está, indica al usuario los pasos de instalación del repositorio en lugar de improvisar una instalación a nivel de máquina.

Lanzar un trabajo puede consumir cuota o generar cargos del proveedor. Trata una solicitud explícita de despachar o entregar trabajo como autorización para ese lanzamiento. Una solicitud para explicar, inspeccionar, redactar o planificar no es autorización de lanzamiento.

Elige la forma de ejecución

• Usa runjob run para un trabajo acotado. Se ejecuta en el directorio de trabajo seleccionado y no crea una rama ni un worktree. Para trabajo que pueda editar o hacer commits, utiliza un worktree de Git desechable o el modo flota.
• Usa runjob fleet run para varios trabajos, ordenamiento por dependencias, worktrees aislados automáticos, sesiones reanudables o límites de concurrencia por motor. Lee references/fleet.md antes de crear archivos de flota.
• Usa runjob log, runjob report y runjob dash para inspeccionar trabajo ya en vuelo. Son de solo lectura; runjob repair es una mutación explícita del libro mayor.

No sustituyas esta habilidad por un subagente dentro de la sesión cuando el usuario haya solicitado delegación dentro de la conversación actual.

Trabajos de una sola ejecución

Utiliza un archivo de prompt para instrucciones sustanciales, de modo que el despacho sea revisable:

runjob run --engine codex --effort high \
  --cwd /ruta/absoluta/al/worktree --file /ruta/absoluta/al/prompt.md

Omite --model o --effort cuando el usuario no los haya seleccionado y el motor tenga un valor predeterminado por CLI sensato. No inventes nombres de modelos actuales. Lee references/engines.md cuando importen las banderas específicas del motor, la autenticación o el comportamiento del sandbox.

runjob run regresa después del lanzamiento a menos que se suministre --wait. Conserva el uid impreso. Inspecciónalo con:

runjob log --uid UID
runjob log --active
runjob report UID --json
runjob dash

Los registros y prompts pueden contener código fuente o instrucciones sensibles. Residen bajo ${DEV_JOBS_HOME:-~/.config/dev-jobs}; no los publiques ni los adjuntes sin una revisión separada.

Finalización y entrega

Informa el uid, el motor/modelo realmente solicitado, el directorio de trabajo y si el trabajo está meramente lanzado o ha finalizado. No describas un lanzamiento de proceso como un resultado exitoso. Al esperar, verifica el estado del libro mayor terminal y resume la salida real del trabajo, incluyendo fallos o trabajo residual.

Para finalizaciones legibles por máquina, utiliza el protocolo exacto en references/report-trailer.md. Trata sus campos como las afirmaciones del trabajo; verifica de forma independiente commits, pruebas y rutas modificadas antes de fusionar o publicar cualquier cosa.