claude-dev-skill

Cos'è claude-dev-skill?

claude-dev-skill è una custom skill per Claude Code che trasforma Claude in un processo “tech lead” per lo sviluppo software con più agenti AI worker. La skill fornisce un workflow strutturato multifase che coordina il lavoro parallelo dei worker in worktree isolati, riducendo la perdita di contesto e i conflitti di merge instradando le modifiche tramite PR e review.

Il suo scopo principale è superare la generazione di codice single-threaded: guida l'allineamento dei requisiti (PRD), le decisioni architetturali, la scomposizione dei task, l'implementazione parallela, i controlli QA statici e un passo strutturato di review/merge PR.

Caratteristiche Principali

• Workflow comando /dev (SOP multifase): Inizia con la classificazione della richiesta e procede con allineamento PRD, architettura e creazione issue, implementazione worker, verifica QA e coordinamento merge PR.
• Regola di routing tech-lead: La conversazione principale agisce da coordinatore; “non scrive mai codice direttamente”, richiedendo che le modifiche passino per Worker Agent → PR → processo di review.
• Worker Agents paralleli via worktree: Genera più agenti worker che sviluppano in parallelo in worktree isolati per supportare parti diverse della feature (es. auth, API, frontend).
• Scan conflitti pre-coding: Prima dell'inizio del lavoro, gli agenti worker scansionano altre Issue aperte per sovrapposizioni di file, intercettando conflitti probabili in anticipo.
• Coordinamento PR post-merge: Dopo i merge, scansiona le PR aperte e notifica i branch che necessitano di rebase.
• Gate di sicurezza prima della review: Impone l'esecuzione di tool di sicurezza (es. bandit più pip-audit per Python, o npm audit per Node) come passo obbligatorio prima della fase di review.
• Checklist review PR strutturata con condizioni di veto: La code review usa una checklist di 7 item con condizioni di veto obbligatorie.
• Self-check counterexample per copertura test: Include un self-check a sei categorie per assicurare che i worker considerino scenari Null/Empty/Boundary/External failure/Concurrency/Malicious input.

Come Usare claude-dev-skill

1. Installa i file della skill nella directory comandi di Claude Code (installazione script-based per macOS/Linux/Windows, o copia manuale preservando la struttura delle directory).
2. Assicurati di avere Claude Code (CLI ufficiale Anthropic) loggato.
3. Usa la GitHub CLI (gh) con sessione autenticata (esegui prima gh auth login).
4. In Claude Code, esegui /dev [descrizione opzionale]. La skill classificherà la richiesta (es. nuovo progetto, nuova feature, bug fix, hotfix, cambiamento architetturale, refactoring) e avvierà il flow appropriato.

Una tipica esecuzione segue le fasi mostrate nel repository: allineamento PRD (due round), architettura e scomposizione task con GitHub Issues, esecuzione worker in worktree paralleli, verifica QA statica e review/merge PR guidato da checklist.

Casi d'Uso

• Costruzione di una feature backend web small-to-medium con PRD esistente: Usa /dev per tradurre un product requirement document esistente in decisioni architetturali, GitHub Issues e implementazioni worker parallele.
• Implementazione di più moduli contemporaneamente minimizzando conflitti merge: Assegna agenti worker separati a componenti diversi (es. authentication vs. task CRUD API vs. componenti frontend) e affidati a scan conflitti pre-coding e coordinamento rebase post-merge.
• Lavoro coordinato di bug fixing o hotfix: Per bug fix o hotfix d'emergenza, il flow classifica il tipo di richiesta e lo instrada tramite review architetturale, modifiche worker, verifica QA e merge PR strutturato.
• Refactoring sistematico con review strutturata: Durante il refactoring, il self-check counterexample della SOP e il gate di sicurezza pre-merge aiutano a garantire che i worker considerino edge case ed eseguano i tool di audit richiesti prima della review.
• Lavoro di cambiamento architetturale che richiede allineamento prima del coding: Usa la Phase 1 per allineamento PRD e Phase 2 per decisioni architetturali per chiarire il piano del team prima che i worker inizino l'implementazione.

FAQ

• Cosa significa “tech lead” nel workflow di questa skill? La conversazione principale funge da coordinatore: allinea sul PRD, decide la direzione architetturale, genera agenti worker e impone che le modifiche al codice passino attraverso PR degli Worker Agent e review, anziché modifiche dirette in chat.

• claude-dev-skill scrive codice direttamente dalla conversazione principale? No. Il workflow include una “regola ferrea” per cui la conversazione principale non scrive mai codice direttamente; le modifiche devono passare attraverso un Worker Agent e poi una PR per la review.

• Come vengono gestiti i conflitti durante lo sviluppo parallelo? La skill include una scansione pre-coding dei conflitti (gli agenti worker verificano Issues aperte per sovrapposizioni di file prima di iniziare) e un passo post-merge che scansiona le PR aperte per identificare branch da ribasare.

• Quali controlli di sicurezza sono imposti? Prima della fase di review, impone l’esecuzione di tool di sicurezza come bandit più pip-audit per Python, o npm audit per Node, secondo la descrizione del Security gate del repository.

• È pensata per lavoro di deployment in produzione? Le note di scope del repository indicano che non è adatta a progetti che richiedono deployment in produzione, poiché non fornisce capability DevOps/deployment.

Alternative

• Assistenti codice single-agent (stile autocomplete/chat): Si concentrano sulla scrittura diretta di codice da prompt, ma tipicamente non offrono un workflow multi-agente da PRD a PR con gate di review imposti.
• Prompt multi-step convenzionali + workflow PR manuali: Puoi promptare Claude manualmente per decomporre task e far girare worker, ma perdi la struttura SOP integrata (classificazione, scansione conflitti, coordinazione QA e checklist review).
• Workflow team standard basati su GitHub (Issues/PR senza AI SOP): I team possono replicare parti del flusso con GitHub Issues e review PR, ma la parallelizzazione “worker agent” e il routing automatico delle fasi non sono forniti allo stesso modo.
• Altre custom skill Claude Code focalizzate su planning o testing: Invece di coordinare agenti worker paralleli end-to-end, alcune skill mirano a una sola parte del workflow (es. generazione test), lasciando integrazione e coordinazione merge all’utente.