Come Smettere di Indovinare e Iniziare a Capire il Tuo Partner AI

Recentemente mi sono reso conto di passare più tempo con GitHub Copilot e Cursor che con i miei colleghi di team. Scambiamo costantemente prompt, lui scrive codice per me, io lo correggo. Ma se qualcuno mi chiedesse quanto efficacemente lo sto usando, non saprei dare una risposta chiara. "Beh, sembra aiutare" — non proprio una metrica solida per un ingegnere.

Si scopre che Microsoft si è posta la stessa domanda. Un gruppo di dipendenti ha reso open-source AI Engineering Coach. È uno strumento che analizza i tuoi log di interazione con l'AI localmente e li trasforma in una dashboard di analytics. Nessun dato inviato al cloud, solo analisi post-mortem locale.

Cos'è in sostanza

Il progetto è un'estensione VS Code (o canvas per l'app GitHub Copilot) che analizza le tue sessioni. Non si limita a contare il numero di richieste — cerca di valutare la qualità della tua interazione con la rete neurale.

Lo strumento è utile per chi si sente bloccato al livello di "scrivimi una funzione per la validazione email" e vuole ottenere il massimo dagli agenti AI. Evidenzia anti-pattern, trova competenze ricorrenti e costruisce persino una mappa del contesto del tuo progetto.

Cinque aspetti che mi hanno colpito

Rilevatore di anti-pattern

Il repository contiene circa 45 regole integrate che verificano l'igiene delle tue sessioni. Per esempio, se stai sommergendo l'AI con prompt troppo lunghi e confusi o dimentichi di pulire il contesto, il "coach" se ne accorgerà. Mostrerà una scheda con la descrizione del problema e, cosa più importante, suggerirà azioni specifiche per risolverlo.

Scopritore di competenze nascoste

Spesso scriviamo le stesse istruzioni in chat diverse. Skill Finder analizza queste ripetizioni e suggerisce di trasformarle in competenze riutilizzabili. Questo aiuta a formalizzare il tuo stile personale di codifica.

Analisi del contesto

Questa è probabilmente la parte più utile per lavorare con progetti complessi. Lo strumento valuta Context Health — quanto bene l'AI comprende la struttura del tuo workspace. Verifica i file di istruzioni e la preparazione del progetto per lavorare con gli agenti.

Visualizzazione dell'attività

All'interno ci sono timeline in stile Gantt. Puoi vedere a che ora del giorno ti rivolgi più spesso all'assistente e su quali progetti lavori più intensamente. C'è persino una mappa di calore dell'attività 24/7.

Gamificazione dell'apprendimento

Gli sviluppatori hanno aggiunto un sistema di achievement e livelli (dal bronzo al diamante). C'è persino una sezione Learning Center che genera quiz basati sul tuo codice reale e sui log. Sembra un modo per trasformare la routine in un leveling up del personaggio.

Come eseguirlo

C'è un problema qui: l'estensione non è sul marketplace ufficiale. Microsoft la posiziona come un esperimento della community, quindi dovrai compilare il file da solo.

Se hai Node.js installato, il processo è questo:

git clone https://github.com/microsoft/ai-engineering-coach.git
cd ai-engineering-coach
npm ci
npm run package

Dopo di che, un file di estensione apparirà nella cartella. Puoi installarlo tramite console:

code --install-extension ai-engineer-coach-*.vsix

Oppure trascinalo direttamente nella finestra di VS Code. Dopo l'installazione, richiama il command palette (Ctrl+Shift+P) e cerca AI Engineer Coach: Open Dashboard.

Perché vale la pena provarlo

Il vantaggio principale è la privacy. Tutta l'analisi avviene localmente sulla tua macchina. L'estensione funziona in modalità sola lettura e non invia nulla "a casa". Utilizza le API del modello integrate di VS Code solo quando premi tu stesso il pulsante "analizza".

Lo strumento è specifico. Non scriverà codice per te, ma ti farà riflettere: "Sto dando troppa spazzatura al modello?" Per chi vuole passare da una semplice chat a un SDLC Agentic consapevole, questo è un ottimo punto di partenza.

Consiglio particolarmente di controllare la sezione Coding Moments. È una galleria di screenshot delle tue sessioni che ti permette di scorrere letteralmente la tua storia di sviluppo e capire in quale momento qualcosa è andato storto.

A chi è rivolto

Il progetto piacerà sicuramente a chi ama i numeri e vuole ottimizzare i propri flussi di lavoro. Se senti che Copilot a volte si blocca, forse il problema non è nel modello ma in come gli assegni i compiti. Questo "coach" aiuta a trovare questi colli di bottiglia.

L'unico svantaggio è la necessità di una compilazione manuale, ma per uno sviluppatore questo difficilmente sarà un ostacolo. Inoltre, all'interno troverai un Rule Editor dove puoi scrivere le tue regole di analisi in Markdown e testarle direttamente sui tuoi dati. Un costruttore per chi ama personalizzare gli strumenti per sé stesso.