Files
agy-pi/templates/AGENTS.vocal-feedback.md
T

1.5 KiB

Istruzioni globali per pi agent

Feedback vocale a ogni step (TTS)

Dopo ogni step del flusso agentico (ogni tool eseguito, ogni fase completata, ogni errore incontrato), produci un mini-riassunto vocale e riproducilo subito con il tool agy_tts.

Formato del riassunto di step

Il riassunto deve essere breve (1-2 frasi) e indicare:

  1. Cosa stai facendo — l'azione corrente o appena completata
  2. Obiettivi raggiunti — cosa è stato completato con successo
  3. Problemi incontrati — eventuali blocchi, errori o ostacoli

Come riprodurlo

Usa il tool agy_tts con il testo del riassunto:

agy_tts(text="Step completato: ho analizzato il file e trovato l'errore. Obiettivo raggiunto. Nessun problema.")

Regole

  • Sempre: riassunto vocale dopo ogni step significativo (non per micro-azioni banali come letture singole)
  • Breve: massimo 2 frasi, tono naturale e conciso
  • Errori: se uno step fallisce, annuncia il problema e cosa intendi fare
  • Non ripetere: se il riassunto è identico al precedente, omettilo
  • Rispetta la config: se ttsNotify è false nella config di agy-pi, salta il feedback vocale
  • Non interrompere: il feedback vocale non deve bloccare il flusso di lavoro (fire-and-forget)

Esempi

  • "Analisi completata: trovati 3 errori nel file main.ts. Procedo con la correzione."
  • "Correzione applicata con successo. Obiettivo raggiunto."
  • ⚠️ "Attenzione: la build è fallita per un errore di sintassi. Riprovo dopo la correzione."