1
Scrivi una skill per la documentazione
Inizia creando una skill per l’attività che vuoi standardizzare. In questo esempio, creeremo una skill che genera la documentazione API ogni volta che un membro del team aggiunge un’etichetta a un ticket.Vai su Personalizza > Competenze e fai clic su + (New skill). Chiamala
add-docs.Scrivi istruzioni specifiche, passo dopo passo. Fai riferimento a percorsi di file e convenzioni reali, in modo che Devin rispetti gli standard del tuo team:Più la tua skill è specifica, migliore sarà il risultato. Fai riferimento ai template di documentazione, alle guide di stile e agli strumenti effettivamente usati dal tuo team. Per maggiori informazioni, consulta Scrivere una buona skill.2
Sincronizza la skill con Linear
Se non l’hai ancora fatto, connetti l’integrazione con Linear: vai su Settings > Connections > Linear e fai clic su Connect. Seleziona i team a cui Devin deve avere accesso.Dopo aver effettuato la connessione, scorri fino a Skills e fai clic su Add skill. Seleziona
add-docs dal menu a discesa. In questo modo viene creata in Linear l’etichetta della skill, all’interno del gruppo di etichette Devin Skills; l’elenco delle skill mostra l’etichetta da usare (@skills:add-docs, se nessun’altra skill sincronizzata ha lo stesso nome) insieme a un pulsante per copiarla.Da questo momento, quando qualcuno aggiunge quell’etichetta a un ticket, Devin avvia una sessione che usa la tua skill.Affinché le etichette delle skill vengano sincronizzate automaticamente con Linear, nel tuo workspace Linear l’opzione Manage workspace labels deve essere impostata su All members (la trovi in Settings > Security di Linear). Se non è abilitata, dovrai creare le etichette manualmente in Linear.
3
Etichetta i ticket e genera la documentazione
Quando un membro del team aggiunge l’etichetta
@skills:add-docs a un ticket come questo:ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.Devin avvia automaticamente una sessione e segue la tua skill per la documentazione:
- Legge il ticket: recupera la descrizione dell’endpoint, i parametri ed eventuali PR collegate
- Trova il codice sorgente: individua il route handler, lo schema di convalida della richiesta e i tipi di risposta
- Genera la documentazione: crea una nuova pagina in
docs/api/seguendo il formato esistente - Apre una PR: include la nuova pagina di documentazione e la barra laterale aggiornata
@skills:add-docs per generare in parallelo la documentazione di più endpoint.4
Crea altre skill per il tuo team
Lo stesso schema funziona per qualsiasi attività ricorrente. Crea una skill, sincronizzala come etichetta e il tuo team potrà attivarla da qualsiasi ticket. Ecco alcune idee:
@skills:write-tests— Aggiungi copertura dei test per la funzionalità descritta in un ticket@skills:refactor— Esegui il refactor del codice secondo le convenzioni del tuo team@skills:security-audit— Analizza il codice alla ricerca di vulnerabilità di sicurezza e apri una PR con le correzioni@skills:migrate— Esegui una migrazione standardizzata (aggiornamento di una dipendenza, passaggio a una nuova versione dell’API)

