Tutorial 24: Obiettivi Persistenti | Easy Understand Hermes Agent

Questa parte fa parte della serie di tutorial ufficiali di Hermes Agent. Vedi tutti i tutorial

Immagina di stare preparando un pasto complesso e di dire al tuo sous-chef: “Continua a tagliare le verdure finché la postazione di preparazione non è completamente rifornita.” Non stai lì a ripeterti dopo ogni singola carota — ti fidi che continui finché il lavoro non è fatto. Gli Obiettivi Persistenti danno a Hermes lo stesso superpotere di “continua finché non hai finito” per i tuoi compiti di codifica.

Cosa Fa `/goal`?

Normalmente, dai a Hermes un compito, lui risponde e poi si ferma — aspettando la tua prossima istruzione. Con /goal, dai a Hermes un obiettivo permanente che sopravvive tra i turni. Dopo ogni risposta, un modello “giudice” leggero controlla: “L’obiettivo è stato raggiunto?” Se non lo è, Hermes si alimenta automaticamente con un prompt di continuazione e continua a lavorare — senza bisogno che tu lo solleciti. Il ciclo continua finché l’obiettivo non viene raggiunto, tu lo metti in pausa o lo cancelli, o il budget di turni si esaurisce.

Questa funzione è ispirata a una funzionalità simile in Codex CLI, ed è perfetta per quei compiti in cui altrimenti dovresti dire “continua” tre volte.

Passo 1: Sapere Quando Usarlo

Usa /goal quando vuoi che Hermes iteri da solo senza doverlo re-impromptare. Ottimi esempi:

/goal Correggi ogni errore di lint in src/ e verifica che ruff check passi
/goal Porta la funzionalità X dal repo Y, inclusi i test, e fai diventare CI verde
/goal Investiga perché gli ID di sessione a volte deviano durante la compressione a metà esecuzione e scrivi un report
/goal Crea una piccola CLI per rinominare i file in base alle loro date EXIF, poi testala sulla cartella photos/

Se il tuo compito richiede solo un turno, salta /goal. Brilla quando altrimenti saresti bloccato a fare da babysitter.

Passo 2: Capire la Differenza Tra `/goal` e Kanban

Questo è un punto di confusione comune, quindi manteniamolo semplice:

/goal è a sessione singola. Continua a lavorare all’interno di questa singola conversazione finché non ha finito. Non crea mai una card sulla board, non assegna mai lavoro a un altro profilo, non si dirama mai.
Kanban è una board di molti compiti. Ogni card ha il proprio processo worker con la propria sessione. Card, dipendenze, assegnatari e passaggi di consegna vivono sulla board.

La sovrapposizione è piccola ma voluta: una card kanban creata con --goal usa lo stesso motore di continuazione, ma all’interno della sessione di quella singola card — prende in prestito il motore, non la board.

Vuoi	Usa
Continuare a iterare su un singolo compito in questa chat finché non è finito	`/goal <testo>`
Molti compiti indipendenti con dipendenze	`hermes kanban create …`
Una singola card della board che continua a iterare finché i criteri di accettazione non sono soddisfatti	Card Kanban con `--goal`

Ricorda: /goal non tocca mai la board, e mettere in pausa/cancellare un obiettivo non sposta mai una card. Se vuoi lavoro sulla board, mettilo lì tu stesso.

Passo 3: Esegui il Tuo Primo Obiettivo

Ecco l’avvio rapido:

/goal Correggi ogni test fallito in tests/hermes_cli/ e assicurati che scripts/run_tests.sh passi per quella directory

Ecco cosa vedrai accadere:

Obiettivo accettato — Vedrai una conferma come: ⊙ Obiettivo impostato (budget di 20 turni): <il tuo obiettivo>
Il turno 1 viene eseguito — Hermes inizia a lavorare come se avessi inviato l’obiettivo come messaggio normale.
Il giudice viene eseguito — Dopo quel turno, il modello giudice decide fatto o continua.
Il ciclo si attiva se necessario — Se continua, vedrai: ↻ Continuo verso l'obiettivo (1/20): <motivo del giudice> — e Hermes fa automaticamente il passo successivo.
Termina — Alla fine, l’obiettivo viene raggiunto, lo metti in pausa o lo cancelli, o il budget di turni si esaurisce.

Passo 4: Gestire il Ciclo

Hai sempre il controllo. Puoi mettere in pausa un obiettivo per fermare temporaneamente il ciclo, cancellarlo per annullarlo del tutto, o semplicemente lasciarlo girare fino al completamento. Il budget di 20 turni previene i cicli infiniti, quindi non devi preoccuparti che Hermes scappi via per sempre.

Riepilogo

/goal è la tua funzione “continua finché non è fatto”. È perfetta per compiti a sessione singola che richiedono iterazioni multiple — correzioni di lint, porting di funzionalità, indagini o creazione di piccoli strumenti. Non serve per gestire molti compiti contemporaneamente (quello è compito di Kanban). Imposta il tuo obiettivo, lascia che il giudice sorvegli il ciclo e intervieni solo quando vuoi mettere in pausa, cancellare o modificare.

Cosa Fa /goal?