Skip to main content
Non vuoi configurarlo manualmente? Incolla il collegamento a questa pagina in una sessione Devin e chiedigli di configurare tutto al posto tuo.
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
Questo approccio funziona bene anche per le operazioni in blocco: seleziona più ticket con Cmd+A, fai clic con il tasto destro e aggiungi l’etichetta @skills:add-docs per generare in parallelo la documentazione di più endpoint.
Con l’integrazione con Linear installata, Devin ha accesso nativo agli strumenti di Linear, quindi la tua skill può indicare a Devin di aggiornare le etichette o lo stato del ticket in base all’esito. Poiché le etichette possono attivare altre automazioni, puoi concatenare più flussi di lavoro: ad es., dopo la generazione della documentazione, un’etichetta Docs Ready potrebbe avvisare il technical writer per la revisione.
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)
Puoi anche configurare delle automazioni in modo che Devin inizi a lavorare senza che nessuno debba applicare un’etichetta. Vai su Settings > Connections > Linear, scorri fino a Automations, fai clic su Add automation e configura un’automazione che si attivi quando i ticket passano a uno stato specifico o ricevono una determinata etichetta.