Agentes paralelos económicos para Codex
Invocación: esta skill se ejecuta solo cuando el usuario la invoca por nombre; nunca se aplica automáticamente. Ninguna skill de orquestación invoca a la otra, y los trabajadores no invocan a ninguna. Cuando el usuario invoca tanto escalating-subagents como esta skill para una misma tarea, pregunte cuál corresponde antes de despachar.
Coordinador asumido: el modelo padre según lo seleccionó el usuario, típicamente GPT-6.1 Sol; high es una recomendación de esfuerzo inicial para evaluar, no una configuración que esta skill cambie. Un padre en ultra puede delegar de manera proactiva: divulgue esto en la primera línea de progreso, recomiende high, delegue solo a través de los despachos de esta skill y contabilice cualquier asignación adicional bajo "Pinning". Registre el modelo padre real y el esfuerzo en el encabezado del libro de registro. El coordinador orquesta: clasifique el nivel, escriba los criterios de "Hecho significa", descomponga en elementos, fije interfaces y decisiones, instruya a los trabajadores, despache lotes, capture instantáneas, inspeccione cada registro de aceptación, triage e informe. Nunca edita código de producto ni lee transcripciones de trabajadores. Lee extractos de evidencia según lo requiera la aceptación, y el parche integrado para la aceptación del nivel D, validación disputada y violaciones de alcance.
Los trabajadores se ejecutan en un solo modelo económico y ejecutan cada uno un elemento asignado. Nunca delegan, nunca invocan esta skill ni ninguna otra de orquestación, y nunca ejecutan el ayudante de instantáneas. Respete los permisos del host y el modo de colaboración; el modo Plan no permite implementación ni descubrimiento que produzca mutaciones.
Cada criterio lleva un ID y un tipo de evidencia requerido: behavioral (prueba ejecutada, compilación o ejecución que ejercite el cambio), static (verificación de tipos o lint), parse (verificación de sintaxis o análisis), format (verificación de formato) o inspection (diff revisado). La evidencia más débil que el tipo del criterio nunca lo satisface; una verificación de análisis satisface un criterio parse y nada más.
Niveles y matriz de asignación
Nombre el nivel en la primera línea de progreso. Cualquier etapa puede promocionarlo; nunca lo degrade. La promoción mantiene los contadores, adopta el presupuesto más alto y revisa los criterios para los trabajadores afectados. Dimensione los elementos según la matriz: un trabajador puede poseer varios archivos, por lo tanto fusione elementos en lugar de descartar trabajo. La validación se ejecuta una vez por ciclo, después de que el ciclo de implementación completo esté congelado, nunca por lote; los lotes intermedios obtienen un post-N capturado y verificado antes de que comience el siguiente lote, y solo registros de trabajadores provisionales.
| Nivel | Trabajo | Mapa (solo lectura) | Implementar | Validar por ciclo (V) | Presupuesto |
|---|---|---|---|---|---|
| A | Edición trivial, completamente especificada, de bajo riesgo con una verificación concreta | 0 | 1 en low | 0; verificación posterior a la captura por el coordinador | 3 |
| B | Cambio claro | 0 | ≤ 4 en medium | 1 en medium | 7 |
| C | Error poco claro o funcionalidad sustancial; predeterminado | ≤ 3 en low/medium | ≤ 4 en medium | 1 en medium | 10 |
| D | Autenticación, aislamiento de inquilinos, migraciones, cola/sincronización, cambios en datos de producción | ≤ 3 en medium | ≤ 4 en medium | 2 en medium con instrucciones distintas (pruebas + criterios; especificación + regresiones); el coordinador lee el parche | 12 |
Cada nueva asignación, reintento o continuación cuesta una llamada; los trabajadores paralelos cuentan individualmente; los mensajes de estado y las esperas no cuestan nada. Sea M los fragmentos en el lote de mapa que se está admitiendo (0 para un lote de implementación), U los elementos de implementación requeridos aún no despachados, incluidos los de este lote (antes del mapeo, el número planificado, al menos 1), y V los validadores por ciclo; la reserva es una reparación con su revalidación, 1 + V. Admisión de cualquier lote requiere restante ≥ M + U + V + (1 + V); si falla, reduzca el ancho, fusione elementos, o ambas cosas. Serializar cambios es concurrencia, no recuento de llamadas: la admisión cuenta cada elemento requerido restante. Los reintentos de validador (PASS no admitido, INCONCLUSIVE) gastan llamadas de reserva. Después de un FALLO en r elementos: cuando restante ≥ r + V, ejecute las r reparaciones y el conjunto de validación completo fresco sin más reserva, y otro FALLO termina la ejecución con el informe; cuando 1 + V ≤ restante < r + V, repare restante − V elementos, valide e informe el resto como no resuelto; cuando restante < 1 + V, pare e informe los elementos fallidos como no resueltos sin revalidar un parche sin cambios. Ejemplos prácticos: nivel B, cuatro elementos con ancho 4: 7 → 3 después de implementadores → 2 después de validación → un FALLO en dos elementos admite una reparación más un validador → 0, un elemento no resuelto. Nivel B con un PASS no admitido: 7 → 3 → 2 → nuevo validador → 1 → FALLO → 1 < 2, detener. Nivel C, un lote de mapa de 3 con 4 elementos planificados: 3 + 4 + 1 + 2 = 10 admite → 7 → implementar 4 → 3 → validar → 2 → FALLO en un elemento → reparar y validar → 0. Nivel D: 3 + 4 + 2 + 3 = 12 → 9 → 5 → 3 → FALLO en un elemento → 0. La escalera está disponible solo mientras el presupuesto lo admita; en el ancho máximo, la reserva admite una reparación, no cada peldaño, y el coordinador lo dice cuando elige el ancho. La descomposición nunca agrega presupuesto.
Escalera de esfuerzo
El modelo de trabajador nunca cambia; el esfuerzo sí. medium es el predeterminado y el lugar para quedarse.
| Peldaño | Modelo | reasoning_effort | Uso |
|---|---|---|---|
| 0 | gpt-6-luna | low | Trabajo mecánico: fragmentos de mapa de solo lectura, renombrados, movimientos, formato, ejecución de un comando nombrado e informe; sin decisiones de criterio |
| 1 | gpt-6-luna | medium | Predeterminado para cada elemento de Descubrimiento, Implementación y Validación |
| 2 | gpt-6-luna | medium | Trabajador nuevo con una corrección concreta y la ruta del registro anterior; el único reintento por omisión |
| 3 | gpt-6-luna | max | Solo después de un fallo de razonamiento confirmado en el peldaño 1 o 2, o un segundo PARCIAL sin progreso |
Niveles omitidos: high se omite porque su ganancia observada sobre medium en evaluaciones de codificación independientes no justificó un peldaño, y xhigh porque la escalera mantiene un peldaño de escalamiento y max compró más puntuación por dólar. No llene el vacío.
Las instrucciones del peldaño 0 dicen: sin decisiones de criterio; devuelva BLOQUEADO cuando se necesite una. Los validadores comienzan en medium en cada nivel. Un FALLO correcto nunca escala un validador. Los fallos ambientales nunca avanzan peldaños. No hay escalamiento de modelo: cuando la escalera se agota, el coordinador se detiene e informa.
| Hallazgo | Acción | Cuenta |
|---|---|---|
| Trabajador del peldaño 0 devuelve BLOQUEADO porque se requiere juicio | Tome la decisión de antemano cuando sea posible; redespache el elemento en el peldaño 1 | llamada; peldaño → 1, no un fallo |
| Trabajador del peldaño 1 omite un requisito o lee mal las instrucciones | Peldaño 2: trabajador nuevo con la corrección y la ruta del registro anterior | llamada |
| Fallo de razonamiento confirmado en el peldaño 1 o 2, o segundo PARCIAL sin progreso | Peldaño 3 | llamada + peldaño |
| PARCIAL con enfoque sólido y progreso | Continúe en el mismo peldaño | llamada |
| Validador devuelve PASS no admitido (tipo de evidencia demasiado débil, instantánea obsoleta o una verificación que no se ejecutó) | Rechace; nuevo validador en el peldaño 2 con requisitos de evidencia explícitos; segunda ocurrencia → peldaño 3; Implementar intacto | llamada cada una |
| Validador devuelve un FALLO correcto | Validación exitosa; ingrese al ciclo de reparación: los elementos fallidos escalan según su propia escalera, luego el conjunto de validación completo fresco | llamadas r + V |
| FALLO del validador refutado por el coordinador con evidencia registrada | Registre la corrección; ningún cambio en Implementar; revalide solo si el parche cambia | ninguna |
| Validador INCONCLUSIVE o BLOQUEADO por razones ambientales | Solucione dentro de la autorización, reintente una vez en el mismo peldaño; las verificaciones no resueltas se trasladan al informe como bloqueadas | llamada; sin cambio de peldaño |
| Peldaño 3 falla en un elemento | Una vez por elemento: reduzca el elemento (alcance más pequeño, decisiones predefinidas) y reintente en el peldaño 1 si la admisión lo permite; el elemento reducido hereda el historial y el presupuesto | llamada |
| Fallo en el ciclo de reparación final | Deténgase; informe los elementos no resueltos, la evidencia y el siguiente paso; no más despachos | ninguna |
| Ambigüedad bloqueante cambia "hecho" o riesgo del nivel D | Pregunte al usuario; nombre el bloqueador | ninguna |
Lotes paralelos
Un elemento se une a un lote solo cuando se cumplen tres condiciones: propiedad disjunta (archivos o globs); dependencias satisfechas (interfaces fijadas en las instrucciones, ningún elemento consume la salida inacabada de otro); sin efectos secundarios conflictivos (archivos generados, esquema o migraciones, bases de datos, puertos, cachés, accesorios de prueba, configuración de CI). De lo contrario, serialice o fusione. Los límites predeterminados, ajustables por el usuario, son 4 escritores y 3 fragmentos de solo lectura por lote; son heurísticas de investigación de delegación asíncrona, no límites. La capacidad proviene del tiempo de ejecución: use las ranuras anunciadas del host y su semántica de conteo, y despache min(cap, ranuras disponibles). Despache un lote completo en un mensaje. En un despacho parcial, mantenga los trabajadores generados, regístrelos por nombre y despache el resto cuando las ranuras estén libres; nunca regenerar un elemento ya en ejecución.
Cada instrucción lleva la lista de decisiones del coordinador (nombres, interfaces, convenciones elegidas hasta ahora) porque las acciones incorporan decisiones y los trabajadores paralelos de otro modo divergen. La ejecución en espacio de trabajo compartido sin árboles de trabajo es una compensación deliberada: la propiedad más las verificaciones de alcance de instantáneas reemplazan el aislamiento físico.
Ciclo de vida de la evidencia y congelación
Los lotes se numeran a lo largo de la ejecución, tanto los lotes de mapa, implementación y reparación. Capture base una vez y pre-N inmediatamente antes del lote N; ponga el nombre de la instantánea y el ID del árbol en cada instrucción de ese lote. Los trabajadores de mapa informan contra pre-N. Las verificaciones de los implementadores son provisionales hasta la validación; sus registros lo dicen y nombran pre-N. Después de que cada escritor y comando de fondo del lote N se haya detenido, capture post-N y verifique names0 pre-N post-N contra la propiedad de ese lote (vacío para un lote de mapa) antes de despachar cualquier otra cosa; names0 post-N pre-N+1 también debe estar vacío, y cualquier cambio allí es una edición fuera de alcance. Un ciclo se congela cuando su último lote de implementación pasa esta verificación: los validadores nuevos reciben ese post-N del lote y producen registros de aceptación contra ese estado congelado, el coordinador también verifica la unión del ciclo desde su primer pre hasta ese post, y no se producen escrituras durante la validación. Barrera: los validadores de un ciclo se despachan juntos y se esperan juntos, y ninguna reparación comienza hasta que cada uno de ellos haya regresado, o haya sido interrumpido y confirmado como terminado. Una reparación es un lote propio: capture su post-N, verifíquelo y ejecute el conjunto de validación completo fresco. Antes de la aceptación, capture final; names0 entre la instantánea validada y final debe estar vacío. El ayudante detecta...
[truncado para traducción]