Ogni attività in AITM inizia come Task. Questa pagina descrive ogni campo della finestra New Task e come scrivere prompt che producano un buon risultato al primo tentativo.
Creare un Task
La finestra New Task
Selezionare un progetto e fare clic su + New Task (oppure su + Task nella scheda del progetto). La finestra ha tre tab — Task (il modulo vero e proprio), AI Models e Translate — e un pulsante Save. Una volta salvato, il Task compare come scheda nella coda con stato pending e parte automaticamente non appena si libera uno slot. Anche Ctrl+Enter salva il Task.
Tab Task
- Title — un nome breve per il Task. Obbligatorio. È ciò che compare negli elenchi e nelle notifiche, quindi conviene renderlo specifico.
- Prompt — ciò che l'AI deve fare. Obbligatorio. Descrivere l'obiettivo, eventuali vincoli e come si presenta il lavoro "finito". Sopra il campo si trovano il pulsante
Optimize e un selettore della lingua di scrittura (Auto per impostazione predefinita) con un badge che indica la lingua in uso. - Solution e Project — la tab (solution) e il progetto a cui appartiene la modifica. Entrambi sono obbligatori per un nuovo Task.
- Execution Mode — Pipeline (l'intera Pipeline step per step) oppure Agent (un singolo Agent autonomo). In modalità Agent compare un Agent Test Gate con due caselle: Run unit tests e Run E2E tests.
- Skill — accanto all'interruttore della modalità ci sono due piccoli pulsanti per l'uso automatico o manuale delle Skills; in modalità automatica le Skills vengono associate in base al testo del prompt. L'elenco Skill (optional) permette di scegliere una Skill che viene sempre inclusa.
- Priority — Low, Medium (predefinita) o High. I Task con priorità più alta vengono prelevati per primi dalla coda.
- Intent — Bug, Feature, Enhancement o Other. Obbligatorio; Save rifiuta il modulo se manca.
- Use Worktree, Use Pipeline, Auto-merge → dev — lasciarli attivi, salvo motivi precisi. Il Worktree isola il Task dagli altri lavori in corso; Auto-merge unisce automaticamente il branch completato in
dev. - Lite mode — salta lo step di pianificazione Architect quando il modello di coding è abbastanza forte da pianificare da solo; con modelli più deboli viene comunque usata la Pipeline completa.
- Pipeline Steps — interruttori per singolo Task per Architect, Review + Fix, Unit Tests ed E2E Tests. Docs è sempre attivo e non può essere saltato.
- Dependencies — altri Task che devono essere completati prima dell'avvio di questo.
Tab AI Models
Qui è possibile sovrascrivere provider e modello per ogni step AI (architect, code, compliance-check, review, fix, test, e2e, docs) per questo solo Task, insieme ai relativi limiti di turni e di tempo di esecuzione. Compliance-check salta i Task più semplici. Tutto ciò che resta vuoto viene ereditato dalle impostazioni del progetto o globali. Apply provider to all steps compila l'intera colonna in una volta.
Tab Translate
Mostra la traduzione del prompt, che può essere modificata.
Optimize — migliorare il prompt
Optimize chiede a un'AI di riscrivere un prompt approssimativo in uno preciso. In seguito è possibile passare da Original prompt a Optimized prompt, aprire Changes per vedere cosa è stato modificato, mentre l'originale resta visibile sotto il modulo come Original prompt (before optimization). La finestra di dettaglio del Task mostra poi entrambe le versioni, l'originale sopra l'ottimizzata.
Modificare un Task
L'icona Edit (matita) sulla scheda di un Task — disponibile finché il Task non è in esecuzione — apre la stessa finestra, intitolata Edit Task, compilata con i valori attuali del Task. Modificare ciò che serve e fare clic su Save.
Catene di Task dipendenti
Se il lavoro di un Task deve avvenire prima che un altro possa iniziare (ad esempio "aggiungere la colonna al database" prima di "usare la colonna nell'API"), elencare il primo Task in Dependencies. Il Task dipendente attende che il predecessore sia stato unito in dev prima di cominciare, così parte sempre da una codebase che contiene già la modifica precedente.
Scorciatoie durante la digitazione (IntelliSense)
Il campo del prompt (così come i campi di messaggio di Chat e Brainstorm) offre il completamento automatico quando si digita uno di questi caratteri:
| Digitare | Per inserire |
|---|---|
@keyword | una keyword |
@@keyword | una keyword con tutto il suo contenuto |
#task | un riferimento a un altro Task |
##bug | un riferimento a un bug |
$skill | una Skill |
_variable | un codice variabile — il nome esatto di una parte dell'applicazione |
~hint | una voce del Hint Dictionary |
Iniziando a digitare il carattere di attivazione compare un menu a tendina con i suggerimenti corrispondenti — sceglierne uno per inserirlo nel prompt.
Suggerimenti
- Usare riferimenti
_variableinvece di descrivere in prosa la posizione del codice — è più rapido e privo di ambiguità per l'AI. - Suddividere una modifica in Task dipendenti invece di scrivere un unico prompt gigantesco quando si divide naturalmente in step ordinati.
- Non dimenticare l'Intent — senza di esso il Task non viene salvato.
- Un Task
failedconserva l'intero output della console e il motivo del fallimento; leggerli, correggere il prompt e riprovare.