Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

I flussi di lavoro consentono agli utenti di definire una serie di passaggi per guidare Cascade nello svolgimento di attività ripetitive, come distribuire un servizio o rispondere ai commenti delle PR. Questi flussi di lavoro vengono salvati come file markdown, offrendo agli utenti e ai rispettivi team un modo semplice e ripetibile per eseguire processi chiave. Una volta salvati, i flussi di lavoro possono essere invocati in Cascade tramite un comando slash nel formato /[name-of-workflow].
I flussi di lavoro sono esclusivamente manuali — Cascade non invocherà mai automaticamente un flusso di lavoro. Se vuoi che Cascade segua una procedura autonomamente, usa invece una Skill.

​
Come funziona

Le Regole in genere forniscono ai modelli linguistici di grandi dimensioni indicazioni, mettendo a disposizione un contesto persistente e riutilizzabile a livello di prompt. I flussi di lavoro estendono questo concetto fornendo una sequenza strutturata di passaggi o prompt a livello di traiettoria, guidando il modello attraverso una serie di attività o azioni collegate tra loro.
Per eseguire un flusso di lavoro, gli utenti devono semplicemente invocarlo in Cascade con il comando /[workflow-name].
Puoi invocare altri flussi di lavoro dall’interno di un flusso di lavoro!

Ad esempio, /workflow-1 può includere istruzioni come “Invoca /workflow-2” e “Invoca /workflow-3”.
Una volta invocato, Cascade elabora in sequenza ogni passaggio definito nel flusso di lavoro, eseguendo azioni o generando risposte come specificato.

​
Come creare un flusso di lavoro

Per iniziare a usare i flussi di lavoro, fai clic sull’icona Customizations nel menu laterale a scomparsa in alto a destra in Cascade, quindi vai al pannello Workflows. Qui puoi fare clic sul pulsante + Workflow per creare un nuovo flusso di lavoro. I flussi di lavoro vengono salvati come file Markdown nelle directory .windsurf/workflows/ e contengono un titolo, una descrizione e una serie di passaggi con istruzioni specifiche che Cascade deve seguire.

​
Rilevamento dei flussi di lavoro

Devin Desktop rileva automaticamente i flussi di lavoro da più posizioni per offrire un’organizzazione flessibile:
  • Workspace corrente e sottodirectory: tutte le directory .windsurf/workflows/ all’interno del workspace corrente e delle relative sottodirectory
  • Struttura del repository Git: per i repository Git, Devin Desktop cerca anche fino alla directory radice Git per individuare i flussi di lavoro nelle directory padre
  • Supporto per più workspace: quando nella stessa workspace sono aperte più cartelle, i flussi di lavoro vengono deduplicati e visualizzati con il percorso relativo più breve

​
Percorsi di archiviazione dei flussi di lavoro

AmbitoPercorsoNote
Workspace.windsurf/workflows/*.mdNel workspace corrente, in qualsiasi sottodirectory o directory padre fino alla git root. Versionato con la repo.
Globale~/.codeium/windsurf/global_workflows/*.mdDisponibile in ogni workspace sul tuo computer. Non versionato.
IntegratoGestito da Devin DesktopTemplate inclusi in Devin Desktop (ad es. /plan).
Sistema (Enterprise)Specifico del sistema operativo (ad es. /etc/windsurf/workflows/)Distribuito dall’IT, in sola lettura per gli utenti finali.
Quando crei un nuovo flusso di lavoro tramite la UI, viene salvato nella directory .windsurf/workflows/ del workspace corrente, non necessariamente nella git root. Per creare un flusso di lavoro globale, usa il pulsante + Global nel pannello Workflows oppure crea direttamente il file in ~/.codeium/windsurf/global_workflows/. Ogni file di flusso di lavoro è limitato a 12000 caratteri.

​
Genera un flusso di lavoro con Cascade

Puoi anche chiedere a Cascade di generare flussi di lavoro per te. Questo approccio funziona particolarmente bene per i flussi di lavoro che prevedono una serie di passaggi in uno specifico strumento CLI.

​
Esempi di flussi di lavoro

Esistono moltissimi casi d’uso per i flussi di lavoro, ad esempio:

/address-pr-comments

Questo è un flusso di lavoro che il nostro team usa internamente per gestire i commenti sulle PR:
1. Passa al branch della PR: `gh pr checkout [id]`

2. Recupera i commenti della PR

 bash
 gh api --paginate repos/[owner]/[repo]/pulls/[id]/comments | jq '.[] | {user: .user.login, body, path, line, original_line, created_at, in_reply_to_id, pull_request_review_id, commit_id}'

3. Per OGNI commento, fai quanto segue. Ricorda di gestire un commento alla volta.
 a. Stampa quanto segue: "(index). Da [user] su [file]:[lines] — [body]"
 b. Analizza il file e l'intervallo di righe.
 c. Se non capisci il commento, non apportare modifiche. Chiedimi semplicemente un chiarimento, oppure chiedimi di implementarlo io stesso.
 d. Se ritieni di poter apportare la modifica, fallo PRIMA di passare al commento successivo.

4. Dopo aver elaborato tutti i commenti, riepiloga ciò che hai fatto e indica quali commenti richiedono l'attenzione dell'UTENTE.

/git-workflows

Esegui commit usando formati predefiniti e crea pull request con titoli e descrizioni standardizzati usando i comandi CLI appropriati.

/dependency-management

Automatizza l’installazione o l’aggiornamento delle dipendenze del progetto in base a un file di configurazione (ad es. requirements.txt, package.json).

/code-formatting

Esegui automaticamente formatter del codice (come Prettier, Black) e linter (come ESLint, Flake8) al salvataggio del file o prima del commit per mantenere coerente lo stile del codice e individuare tempestivamente gli errori.

/run-tests-and-fix

Esegui o aggiungi test unitari o end-to-end e correggi automaticamente gli errori per garantire la qualità del codice prima del commit, del merge o della distribuzione.

/deployment

Automatizza i passaggi necessari per distribuire la tua applicazione in vari ambienti (sviluppo, staging, produzione), inclusi eventuali controlli prima della distribuzione o verifiche successive.

/security-scan

Integra e attiva scansioni delle vulnerabilità di sicurezza sul tuo codebase come parte della pipeline CI/CD o su richiesta.

​
Flussi di lavoro di sistema (Enterprise)

Le organizzazioni Enterprise possono distribuire flussi di lavoro di sistema disponibili globalmente in tutti i workspace e non modificabili dagli utenti finali senza autorizzazioni di amministratore. Questa soluzione è ideale per imporre processi di sviluppo a livello di organizzazione, procedure di distribuzione e flussi di lavoro di conformità. I flussi di lavoro di sistema vengono caricati da directory specifiche del sistema operativo: macOS: 
/Library/Application Support/Windsurf/workflows/*.md
Linux/WSL: 
/etc/windsurf/workflows/*.md
Windows: 
C:\ProgramData\Windsurf\workflows\*.md
Colloca i file del flusso di lavoro (in formato .md) nella directory appropriata per il tuo sistema operativo. Il sistema caricherà automaticamente tutti i file .md presenti in queste directory.

​
Precedenza dei flussi di lavoro

Quando esistono flussi di lavoro con lo stesso nome a più livelli, i flussi di lavoro di sistema hanno la precedenza massima:
  1. Sistema (priorità massima) - Flussi di lavoro a livello di organizzazione distribuiti dall’IT
  2. Workspace - Flussi di lavoro specifici del progetto in .windsurf/workflows/
  3. Globale - Flussi di lavoro definiti dall’utente in ~/.codeium/windsurf/global_workflows/
  4. Integrati - Flussi di lavoro predefiniti forniti da Devin Desktop
Ciò significa che, se un’organizzazione distribuisce un flusso di lavoro di sistema con un nome specifico, questo avrà la precedenza su qualsiasi flusso di lavoro del workspace, globale o integrato con lo stesso nome. Nell’interfaccia utente di Devin Desktop, i flussi di lavoro di sistema sono contrassegnati dall’etichetta “Sistema” e non possono essere eliminati dagli utenti finali.
Importante: I flussi di lavoro di sistema devono essere gestiti dal team IT o di sicurezza. Assicurati che i team interni si occupino di distribuzione, aggiornamenti e conformità in base alle policy della tua organizzazione. A questo scopo, puoi usare strumenti e flussi di lavoro standard come Mobile Device Management (MDM) o Configuration Management.