Claude Code può ora scrivere istantaneamente il proprio harness, su misura per il compito da svolgere. Questa capacità si chiama workflow dinamico: scrive dinamicamente script di orchestrazione, esegue decine o centinaia di subagenti paralleli in una singola sessione e si controlla automaticamente prima di presentarti qualsiasi risultato.
L'harness predefinito di Claude Code è ottimo per scrivere codice, ma per attività più specializzate come ricerche, analisi di sicurezza, team di agenti e revisioni del codice, in precedenza era necessario costruire un harness personalizzato basato su Claude Code per ottenere prestazioni ottimali.
I workflow ti consentono di creare dinamicamente questi harness personalizzati, che sono riutilizzabili, condivisibili e permettono a Claude di risolvere i problemi in modo più nativo rispetto all'approccio predefinito.
In questo articolo, condividerò le mie prime esperienze e intuizioni sull'uso dei workflow. Tieni presente che i workflow consumano più token e sono più adatti per attività complesse e di alto valore.
0. Introduzione
La sezione introduttiva contiene appunti di Fratello Practice.
Una lettura eccellente; i workflow potrebbero essere la migliore invenzione dopo le skill. Sono una versione potenziata degli obiettivi e vale davvero la pena impararli. Questo articolo spiega in modo semplice vari scenari applicativi per i workflow.
L'autore originale è Thariq @trq212, un dipendente chiave di Anthropic che condivide spesso consigli su Claude Code.
Il contenuto è lungo; sentiti libero di saltare alle sezioni di tuo interesse. Per avere un'idea diretta di cosa può fare, vedi la Sezione 1;
Per capire perché è necessario, vedi le Sezioni da 3 a 5
; per copiare direttamente le soluzioni implementative, salta alla Sezione 6.
1. Prompt di Esempio
Questi esempi mostrano cosa possono fare i workflow. Puoi chiedere direttamente a Claude richieste simili:
- Far competere più teorie contrastanti per riprodurre test instabili.
- Estrarre correzioni ricorrenti dalle sessioni passate.
- Individuare le cause profonde nei canali incident di Slack.
- Ottenere più prospettive critiche per un business plan.
- Classificare i curriculum e validarli.
- Usare una selezione a torneo per nominare uno strumento CLI.
- Eseguire un refactor su tutto il codebase.
- Verificare le affermazioni tecniche in una bozza di blog confrontandole con il codice reale.
2. Come Funzionano i Workflow
I workflow eseguono file JavaScript contenenti funzioni speciali per generare e coordinare subagenti. È possibile utilizzare strumenti JavaScript standard come JSON, Math e Array per elaborare i dati. I workflow possono scegliere quale modello usano i subagenti e decidere se devono essere eseguiti in un worktree isolato. Se interrotto, il workflow può riprendere da dove era stato lasciato.
3. Perché i Workflow Sono Necessari
L'harness predefinito completa pianificazione ed esecuzione all'interno di una singola finestra di contesto. Funziona bene per le attività di codifica, ma fallisce per attività a lungo termine, massivamente parallele, altamente strutturate o avversariali. Nello specifico, mostra tre modalità di fallimento:
- Pigrizia dell'Agente: Di fronte a compiti complessi e multi-parte, Claude si ferma prematuramente, completando solo una parte (ad esempio, elaborando 35 delle 50 revisioni di sicurezza).
- Bias di Autopreferenza: Quando gli viene chiesto di validare o giudicare i risultati rispetto a una rubrica, Claude tende a favorire le proprie conclusioni.
- Deriva dell'Obiettivo: La fedeltà viene persa nel corso di interazioni multiple; ogni riepilogo perde dettagli, inclusi requisiti e vincoli di casi limite.
I workflow contrastano tutto ciò orchestrando subagenti indipendenti, ciascuno con la propria finestra di contesto, obiettivo mirato e isolamento.
4. Workflow Dinamici vs. Statici
In precedenza, i workflow statici creati con Claude Agent SDK o claude -p coordinavano più istanze di Claude Code in modo generico, richiedendo di coprire tutti i casi limite. Con Claude Opus 4.8 e i workflow dinamici, Claude ora può scrivere harness su misura per scenari specifici.
5. Schemi Pratici per l'Uso dei Workflow
Puoi attivare un workflow richiedendolo direttamente o usando ultracode nel tuo prompt per assicurarti che Claude Code ne crei uno. Gli schemi comuni includono:
- Classifica ed Esegui: Un agente classificatore determina il tipo di attività e la instrada verso diversi agenti o comportamenti; può anche classificare l'output al completamento.
- Espansione e Sintesi: Suddividi un'attività in molti passaggi più piccoli, esegui un agente per ciascuno e sintetizza i risultati. Utile quando molti passaggi beneficiano di finestre di contesto pulite e non interferenti. La sintesi agisce come una barriera, attendendo che tutti gli agenti finiscano prima di unire l'output strutturato.
- Validazione Avversariale: Per ogni agente generato, esegui un agente avversariale separato per validare l'output rispetto a una rubrica o a criteri.
- Genera e Filtra: Genera più idee su un argomento, filtralle per rubrica o validazione e mantieni solo i risultati verificati di altissima qualità dopo la deduplicazione.
- Torneo: Fai competere N agenti sullo stesso compito utilizzando metodi diversi. Agenti di giudizio a coppie determinano i vincitori fino a quando ne rimane solo uno.
- Ciclo fino al Completamento: Per attività con carichi di lavoro sconosciuti, genera continuamente agenti finché non viene soddisfatta una condizione di arresto (ad esempio, nessuna nuova scoperta, nessun altro errore nei log).
6. Scenari Applicativi
- Migrazione e Refactoring: Bun ha utilizzato i workflow per riscrivere da Zig a Rust. Suddivide le attività in passaggi seriali (siti di chiamata, test falliti, moduli), genera subagenti per ogni correzione in un worktree, esegue revisioni avversariali e unisce. Evita comandi ad alta intensità di risorse per massimizzare il parallelismo.
- Ricerca Approfondita: La skill
/deep-researchdi Claude Code utilizza i workflow per espandere le ricerche web, raschiare le fonti, verificare in modo avversariale le affermazioni e sintetizzare un rapporto citato. Questo si applica anche a ricerche non web, come la compilazione di report sullo stato di Slack o l'esplorazione delle funzionalità del codebase. - Validazione Approfondita: Per report che richiedono citazioni per ogni fatto, un workflow può identificare le affermazioni, far controllare ciascuna di esse dai subagenti e utilizzare un agente verificatore per garantire la qualità della fonte.
- Ordinamento: Per elenchi di grandi dimensioni che necessitano di una misurazione qualitativa (ad esempio, classificare i ticket per gravità), classificare oltre 1000 righe in un unico prompt riduce la qualità e fa esplodere il contesto. Utilizza tornei, pipeline a coppie o classificazione parallela a bucket; ogni confronto è un agente a sé stante.
- Memoria e Rispetto delle Regole: Quando Claude ignora le regole anche in
CLAUDE.md, crea un workflow con un verificatore di regole per ogni regola. Usa una personalità scettica per rivedere le regole e prevenire falsi positivi. Viceversa, estrai le correzioni ricorrenti dalle sessioni recenti, raggruppale con agenti paralleli e valida in modo avversariale se la regola avrebbe impedito l'errore prima di perfezionareCLAUDE.md.
- Triage su Larga Scala: Un workflow di triage classifica gli elementi, li deduplica rispetto ai record esistenti e intraprende azioni. Uno schema di 'quarantena' impedisce agli agenti che leggono contenuti non attendibili di eseguire azioni ad alta priorità, delegandole ad agenti di elaborazione. Usalo con
/loopper un funzionamento continuo.
- Esplorazione e Gusto: Utile per decisioni di design o denominazione che si basano sul "gusto" e traggono vantaggio dalle rubriche. Claude esplora le soluzioni mentre un agente di revisione le giudica rispetto a una rubrica. Le soluzioni possono essere classificate o selezionate tramite torneo.
- Valutazione: Esegui valutazioni leggere generando agenti indipendenti in un worktree e un agente di confronto per valutare gli output rispetto a una rubrica.
- Modello e Routing Intelligente: Crea un agente classificatore adattato all'attività per decidere quale modello utilizzare. Ad esempio, spiegare un modulo di autenticazione dipende dal conteggio dei file; un classificatore ricerca prima questo aspetto, poi instrada verso Sonnet o Opus in base alla complessità.
7. Quando NON Usare i Workflow
I workflow sono nuovi e non sono necessari per ogni attività; consumano significativamente più token. Usali in modo creativo per attività che vanno oltre l'uso convenzionale. Per la codifica di routine, considera se sia necessario un carico computazionale extra; la maggior parte della codifica non ha bisogno di cinque revisori.
8. Suggerimenti per Creare Workflow
- Prompting: I prompt dettagliati funzionano meglio. I workflow non sono solo per grandi attività; puoi richiedere un workflow rapido per una veloce revisione avversariale di un'ipotesi.
- Combina con /goal e /loop: Per workflow ripetibili come triage o ricerca, usa
/loopper intervalli e/goalper requisiti di completamento rigorosi. - Budget di Token: Imposta un budget di token chiaro (ad esempio, 10k token) nel prompt per limitare l'uso.
- Salvataggio e Condivisione: Premi 's' nel menu del workflow per salvare. Archiviali in
~/.claude/workflowso distribuiscili tramite skill. Fai riferimento ai file JavaScript del workflow inSKILL.md. Per flessibilità, chiedi a Claude di trattare i workflow delle skill come modelli piuttosto che come script letterali.
9. Un Nuovo Punto di Partenza
I workflow forniscono un potente nuovo modo per estendere Claude Code. Consideralo un punto di partenza per esplorare nuovi metodi per completare le attività con Claude. C'è molto altro da scoprire su come utilizzarlo al meglio.
