Objetivos
Un objetivo es una meta que Perch persigue turno tras turno por su cuenta, con una comprobación independiente de si de verdad está cumplida, hasta que termina o se le agota el presupuesto.
Un turno normal hace lo que pediste y se detiene. Si el trabajo lleva doce pasos, acabas diciendo "continúa" una y otra vez. Un objetivo elimina eso: declaras la meta una sola vez, y Perch vuelve a llamarse a sí mismo turno tras turno hasta que una comprobación independiente coincide en que el trabajo está hecho.
The short version
/goal <objective> en Perch Terminal o en la CLI. Se ejecuta a lo largo de muchos turnos, sobrevive al cierre y se detiene solo a los 40 turnos o a las 4 horas. /goal a secas muestra cómo va.Cómo fijar uno
/goal make the test suite pass
/goal reconcile every invoice in this folder against the ledger and write up the exceptionsRecurre a un objetivo cuando el trabajo tiene muchos pasos y una meta que podrías describir en voz alta. No lo uses para una sola pregunta: un objetivo que podría haber sido un turno solo agrega un paso de auditoría.
Volver a iniciar /goal con exactamente el mismo texto de objetivo continúa el que ya tienes y conserva su conteo de turnos. Un texto distinto empieza uno nuevo.
Cómo seguirlo y dirigirlo
| Comando | Qué hace |
|---|---|
/goal | Muestra el objetivo: su estado, los turnos usados, por qué se detuvo la última vez y qué dijo la última comprobación de cumplimiento. |
/goal pause | Lo pausa sin perderlo. |
/goal resume | Lo retoma donde se detuvo. |
/goal clear | Lo descarta. stop, off, cancel y reset también funcionan. |
/goal status es lo mismo que /goal a secas, y /goal continue es lo mismo que /goal resume.
Mientras un objetivo se ejecuta, ves cada turno a medida que ocurre, con sus llamadas a herramientas. Esc en la app de escritorio, o Esc con el cuadro vacío o Ctrl-C en la CLI, detiene la ejecución actual.
La comprobación de cumplimiento
Perch no se cree a sí mismo cuando dice que un objetivo está listo. Cuando una ejecución declara cumplida la meta, una comprobación aparte revisa esa afirmación, y puede volver de tres maneras:
- Cumplida. La ejecución termina como completa.
- No cumplida. Perch sigue trabajando con lo que encontró la comprobación. Si la ejecución termina ahí, te dice qué faltaba y puedes retomarla.
- Imposible. La comprobación determinó que la meta no se puede cumplir en absoluto. La ejecución se detiene y explica por qué, así puedes cambiar el objetivo en lugar de quemar turnos en él.
Lo último que dijo la comprobación forma parte del estado de /goal, así que siempre puedes ver qué es lo que le falta.
Dónde se detiene una ejecución
Un objetivo nunca se ejecuta para siempre. Todos los estados finales salvo Complete se pueden retomar con /goal resume.
| Parada | Qué significa |
|---|---|
| Complete | La comprobación de cumplimiento pasó. |
| Budget | Llegó a 40 turnos o a 4 horas de reloj. Lo que tienes es un avance parcial. |
| Incomplete | Un turno no hizo llamadas a herramientas y no pasó la comprobación, así que se detuvo en lugar de dar vueltas. |
| Blocked | Una acción necesita tu aprobación, o la ejecución se topó con algo que no puede hacer sin supervisión. |
| Paused | Lo pausaste tú, o lo pausó un límite de uso. |
| Failed | Un turno dio error. |
| Cancelled | Lo detuviste. |
| Interrupted | El proceso de la ejecución murió, por ejemplo porque la app se cerró a mitad de un turno. |
Un paso que deja de responder también termina la ejecución, en lugar de dejarla colgada.
Aquí importan los modos de permisos
Un objetivo está pensado para ejecutarse sin ti, y el modo de permisos Default se detiene en la primera escritura o comando para preguntar. Por eso un objetivo iniciado en Default se ejecuta en Auto Review durante esa ejecución, y Perch lo dice al empezar: el trabajo reversible se ejecuta solo, y las acciones de mayor riesgo siguen pasando por una comprobación de seguridad. Take the Wheel y Plan se quedan como los dejaste.
Auto Review te sigue consultando para las acciones de mayor riesgo. Cuando eso pasa, el objetivo informa Blocked y espera. Consulta los modos de permisos.
Sobrevive al cierre
Un objetivo se guarda junto con su hilo, así que sobrevive a la sesión. Sal de la CLI, cierra la app de escritorio o recarga la página, luego vuelve a la misma carpeta o al mismo hilo y ejecuta /goal resume. El objetivo y el conteo de turnos siguen ahí.
De que los objetivos sean por hilo se derivan dos cosas. Un objetivo fijado en el hilo de una carpeta no se ve desde otra, porque la CLI asocia el hilo predeterminado a tu directorio de trabajo. Y un límite de uso que pausó un objetivo puede dejar que se reanude solo hasta que tú inicies un turno propio; un objetivo que pausaste tú nunca se reanuda por su cuenta.
Dirigir y poner en cola
Habla con Perch mientras trabaja. Enter agrega tu mensaje a la tarea en curso, Tab lo pone en cola para después y Esc la detiene. Funciona igual cuando la tarea se ejecuta en la nube o en otra de tus computadoras.
Tareas en segundo plano
Los comandos largos y los agentes delegados se ejecutan en segundo plano mientras tú sigues en el chat, y Perch puede retomar el trabajo por su cuenta cuando uno de ellos termina.
