Una pipeline di esportazione degli asset è il percorso che porta da un file di design ai file utilizzabili da una build: esportazione, ridimensionamento, ottimizzazione, rinomina e posizionamento. È esattamente il tipo di lavoro ripetitivo e basato su file che un coding agent sa svolgere al meglio, ed è esattamente il tipo di lavoro che si blocca perché il designer deve chiedere a uno sviluppatore di eseguirlo. Un agente associato alla cartella degli asset, raggiungibile in una stanza, elimina questo passaggio.
La richiesta
“@assets esporta il set di icone dal file di design a 1x, 2x e 3x, ottimizzale e mettile in /public/icons. Pubblica un provino a contatto.”
Cosa fa l'agente
- Chiama l'API del tool di design per recuperare i componenti correnti delle icone.
- Esporta nelle tre scale all'interno di una cartella temporanea.
- Esegue l'ottimizzatore già installato sulla macchina.
- Rinomina i file secondo la convenzione del progetto, specificata nel file
README.mddella cartella. - Sposta i file in
/public/icons, sostituendo il set precedente. - Genera un'immagine con il provino a contatto e la pubblica nella stanza indicando il conteggio.
Il designer vede ogni passaggio nella timeline e il provino a contatto alla fine. Tempo totale: circa un minuto.
Cosa va in pausa
Il passaggio 1 legge il token API del tool di design. Trattandosi di un'azione che coinvolge una credenziale, la prima volta viene messa in pausa in attesa del proprietario, mostrando una scheda con chi ha fatto la richiesta e cosa l'agente vuole leggere. Il proprietario concede l'approvazione; il token non lascia mai la macchina e il designer non lo vede mai. Consulta quattro azioni per cui un agente dovrebbe sempre chiedere prima di procedere.
Se l'agente volesse anche effettuare il commit e il push delle nuove icone su main, anche questo andrebbe in pausa. La maggior parte dei team consente invece di fare il commit su un branch e aprire una pull request, operazione che non richiede pause.
Come configurarlo
- Un agente, una cartella. Associa
assetsalla directory degli asset grafici del repository del sito, oppure a una cartella dedicata alle esportazioni se preferisci tenere l'agente fuori dal codice sorgente. - Metti le convenzioni per iscritto. Un
README.mdcon la convenzione di denominazione, dimensioni, formati e percorsi di destinazione. L'agente lo rilegge ogni volta. - Modalità di autorizzazione
acceptEdits. Scrivere file è il suo compito; l'esecuzione dei comandi richiede comunque conferma. Consulta la spiegazione delle modalità di autorizzazione. - Autorizzazione permanente per i designer. Una sola approvazione per ciascuno, poi possono effettuare richieste liberamente.
- Conserva il token sulla macchina, nella consueta posizione di configurazione del tool. Non incollarlo nella richiesta o nel README.
Variazioni
Perché una stanza e non uno script
Uno script esegue l'esportazione. Una stanza consente alla persona che nota la modifica di avviarla, seguirne l'avanzamento e ottenere il risultato senza usare un terminale, aprire un ticket o coinvolgere uno sviluppatore per i casi di routine, mentre le operazioni non di routine (credenziali, eliminazioni, push) continuano a richiedere l'intervento del proprietario. Inoltre, lascia traccia di chi ha esportato cosa e quando. Consulta i coding agent sanno fare molto più che scrivere codice.
Domande frequenti
Il designer ha bisogno dell'accesso API al tool di design? No. Il token si trova sulla macchina del proprietario e l'agente lo usa lì. Il designer fa la richiesta; il proprietario approva la lettura della credenziale.
L'agente può aprire una pull request? Sì, se la directory dell'agente si trova all'interno del repository e ha accesso a git sulla macchina. L'apertura di una PR su un branch non va in pausa; il push su un branch condiviso sì.
Cosa succede se il designer vuole modificare lo schema di denominazione? Basta modificare il README nella cartella o chiedere all'agente di farlo. Rilegge le convenzioni da zero a ogni richiesta.
L'esportazione richiede un minuto di lavoro. Era l'attesa il vero problema. Assegna una stanza al tuo agente per gli asset.
Pubblicato il