Git

• Attività sul repository: Qualsiasi operazione che coinvolga un repository Git — creazione di branch, staging delle modifiche, commit, push o apertura di pull request.
• Collaborazione in team: Quando la sicurezza della cronologia è importante e hai bisogno di flussi con feature branch, workflow per hotfix o una corretta igiene dei commit pronti per la PR applicata automaticamente.
• Debug della cronologia: Quando devi tracciare regressioni con git bisect, recuperare commit persi tramite git reflog o annullare modifiche in modo sicuro.
• Risoluzione dei conflitti: Quando i merge o i rebase generano conflitti e l'agente ha bisogno di un approccio strutturato e verificato per risolverli.

• Controllo versione non-Git: Se il progetto utilizza Mercurial, SVN o un altro VCS, i comandi di questa skill non saranno applicabili.
• Attività di analisi in sola lettura: Se l'agente deve solo leggere il codice sorgente senza interagire affatto con Git, la skill aggiunge un overhead non necessario.

La skill impone l'uso di --force-with-lease al posto di --force per evitare di sovrascrivere il lavoro dei colleghi, e proibisce il force-push su branch condivisi come main/master. Una checklist di sicurezza integrata deve essere soddisfatta prima di qualsiasi operazione distruttiva come reset --hard o rebase.

Include flussi passo dopo passo per gli scenari di Feature Branch e Hotfix, tra cui quando eseguire lo squash dei commit, come sincronizzarsi con git fetch --all --prune e come taggare le release. Progettato per adattarsi sia ai team basati sul trunk che a quelli in stile gitflow.

Dopo aver modificato i file in conflitto, la skill verifica che non rimangano marcatori di conflitto utilizzando grep, conferma che il codice venga compilato correttamente e offre una via di uscita tramite git merge --abort quando un merge diventa troppo complesso. Il rebasing viene suggerito come alternativa quando i merge diventano disordinati.

Tratta git reflog per il recupero di commit persi (fino a circa 90 giorni), il ripristino di branch eliminati tramite SHA e l'annullamento di commit senza perdere il lavoro con git reset --soft. Include inoltre un flusso di lavoro completo con git bisect per individuare i commit che hanno introdotto regressioni.

La skill impone il formato di messaggio di commit type(scope): description con una prima riga di meno di 72 caratteri, utilizzando tipi standard (feat, fix, docs, refactor, ecc.). Questo mantiene la cronologia leggibile e compatibile con gli strumenti automatizzati per la generazione dei changelog.

Documenta e protegge dalle insidie frequenti di Git: stato di HEAD staccato (detached HEAD), problemi di sensibilità alle maiuscole tra macOS/Windows e CI Linux, errori di clonazione dei sottomoduli, conflitti da stash-pop e commit di file di grandi dimensioni o segreti. Usa git add -p per uno staging parziale granulare.

Un agente crea l'impalcatura di una nuova funzionalità, genera un branch da main, esegue commit incrementali con messaggi convenzionali, effettua il rebase sull'ultimo main prima del push, unifica i commit di correzione con squash e apre un branch pronto per la PR — il tutto senza alcun intervento manuale su Git.

Quando viene rilevato un bug in produzione, l'agente esegue il checkout di un branch hotfix/ da main, applica la correzione, esegue il merge sia su main che su develop, contrassegna la release con un tag e rimuove il branch — seguendo con precisione il flusso di hotfix documentato.

L'agente esegue git bisect per effettuare una ricerca binaria nella cronologia dei commit, contrassegnando i commit come buoni o cattivi in base ai risultati dei test automatizzati, fino a identificare il commit esatto che ha introdotto un bug.

Durante un rebase di una funzionalità a lungo termine, l'agente risolve i conflitti file per file, verifica che non rimangano marcatori <<</>>>, conferma che la build sia completata con successo e continua il rebase — oppure lo interrompe in modo pulito se il conflitto è troppo complesso.