Prompt di Sistema Personalizzati

May 17, 2026 · View on GitHub

Questa guida ti aiuterà a creare prompt di sistema personalizzati per uvx gac che generano messaggi di commit secondo il tuo stile preferito.

Un prompt di sistema è un'istruzione che dice al modello linguistico come comportarsi quando genera messaggi di commit. uvx gac usa prompt di sistema per guidare l'AI a produrre messaggi di commit che seguono stili specifici, formati o convenzioni.

Come Funziona

uvx gac analizza le tue modifiche git (diff)
Costruisce un contesto che include il diff e altre informazioni rilevanti
Usa il prompt di sistema per istruire l'AI su come formattare il messaggio di commit
L'AI genera un messaggio di commit seguendo le tue linee guida

Creare un Prompt Personalizzato

Struttura di Base

Un prompt di sistema personalizzato dovrebbe includere:

Istruzioni chiare su come formattare i messaggi di commit
Esempi del formato desiderato
Regole specifiche per il tuo stile preferito
Considerazioni sulla lingua (se necessario)

Variabili Disponibili

Il prompt può usare queste variabili che saranno sostituite con valori reali:

{{diff}} - Il diff git effettivo delle modifiche
{{context}} - Informazioni contestuali sul repository
{{language}} - La lingua di output desiderata
{{format}} - Il formato di output (one-liner, standard, verbose)

Esempi di Prompt Personalizzati

Esempio Base

Genera un messaggio di commit per le seguenti modifiche git in {{language}}.

Diff:
{{diff}}

Segui queste linee guida:
- Usa il formato conventional commit
- Sii conciso ma chiaro
- Spiega il "perché" dietro le modifiche
- Mantieni la prima riga sotto 72 caratteri

Esempio:
feat(auth): aggiungi supporto OAuth2

Implementa l'autenticazione OAuth2 per permettere l'accesso tramite provider terzi.

Esempio Avanzato

Sei un esperto sviluppatore che scrive messaggi di commit professionali in {{language}}.

Analizza le seguenti modifiche:
{{diff}}

Requisiti:
1. Formato conventional commit con scope appropriato
2. Prima riga: tipo(scope): descrizione (massimo 72 caratteri)
3. Corpo: spiega cosa è cambiato e perché
4. Usa forma imperativa ("aggiungi" non "aggiunto")
5. Priorità: chiarezza > brevità

Tipi consentiti:
- feat: nuove funzionalità
- fix: correzioni di bug
- docs: documentazione
- style: formattazione (senza logica)
- refactor: refactoring
- test: test
- chore: manutenzione

{{#if verbose}}
Includi anche:
- Motivazione della modifica
- Impatto su altre parti del codebase
{{/if}}

Template di Prompt Popolari

1. Stile Minimalista

Crea un messaggio di commit conciso in {{language}} per questo diff:
{{diff}}

Requisiti:
- Massimo 50 caratteri nella prima riga
- Usa formato conventional commit
- Nessun corpo del messaggio

2. Stile Tecnico Dettagliato

Genera un messaggio di commit tecnico dettagliato in {{language}}.

Contesto del repository:
{{context}}

Modifiche:
{{diff}}

Formato richiesto:
```text

tipo(scope): descrizione breve

Dettagli tecnici:

- Spiega l'approccio tecnico usato
- Menziona algoritmi o pattern importanti
- Nota implicazioni di performance
- Elenca file chiave modificati

Sii specifico sui dettagli di implementazione.


### 3. Stile Agile/Scrum

```text
Crea un messaggio di commit in stile agile in {{language}}.

Analizza questo diff:
{{diff}}

Focus su:
- Valore per l'utente finale
- Funzionalità completata
- User story correlata (se applicabile)

Formato:
feat(story-ID): descrizione valore utente

Spiega come questa modifica contribuisce agli obiettivi sprint.

4. Stile Convenzionale con Scope

Genera un conventional commit in {{language}} con scope automatico.

Diff:
{{diff}}

Regole:
1. Determina lo scope basato sui file modificati
2. Usa tipi standard: feat, fix, docs, style, refactor, test, chore
3. Formato: tipo(scope): descrizione
4. Scope comuni: auth, ui, api, db, config, utils

Esempi:
- auth: file di autenticazione
- ui: componenti interfaccia
- api: endpoint API
- db: schema database
- config: configurazione
- utils: funzioni utility

5. Stile Descrittivo

Scrivi un messaggio di commit descrittivo in {{language}} che racconti una storia.

Modifiche:
{{diff}}

Crea una narrazione che:
1. Spiega il problema risolto
2. Descrive la soluzione implementata
3. Menziona il beneficio ottenuto

Usa linguaggio naturale ma professionale.

Best Practices

✅ Fai Così

Sii specifico: Istruzioni chiare producono risultati migliori
Fornisci esempi: Mostra il formato desiderato
Considera il contesto: Adatta il prompt al tuo tipo di progetto
Testa e itera: Prova diversi prompt per trovare quello migliore
Mantieni semplice: Prompt troppo complessi possono confondere l'AI

❌ Evita Questo

Istruzioni contraddittorie: Non dare direttive opposte
Prompt troppo lunghi: Mantieni sotto 2000 caratteri
Formato ambiguo: Sii chiaro sulla struttura desiderata
Ignorare la lingua: Specifica sempre la lingua di output

Risoluzione Problemi

Prompt Non Funziona

Controlla la sintassi: Assicurati che le variabili {{...}} siano corrette
Verifica il percorso: Il file deve essere nel percorso corretto
Testa con un prompt semplice: Inizia con qualcosa di base e complessifica gradualmente

Output Troppo Lungo/Corto

Aggiungi limiti di caratteri: Specifica "massimo X caratteri"
Sii più specifico: Dettaglia meglio il formato desiderato
Usa esempi: Mostra esempi della lunghezza desiderata

Lingua Non Corretta

Verifica la variabile language: Assicurati che {{language}} sia inclusa
Specifica la lingua: Aggiungi "scrivi in italiano" o simile
Testa con diverse lingue: Prova con lingue diverse per isolare il problema

Esempi Reali dalla Comunità

Esempio 1: Progetto React

Genera un commit per un progetto React in {{language}}.

{{diff}}

Focus su:
- Componenti React modificati
- Cambiamenti di stato o props
- Hook personalizzati
- Modifiche al routing

Formato:
feat(component): descrizione

Usa scope specifici come:
- component: componenti React
- hook: hook personalizzati
- state: gestione stato
- routing: configurazione routing

Esempio 2: API Backend

Crea un commit per API backend in {{language}}.

{{diff}}

Enfasi su:
- Endpoint API modificati
- Schema database
- Logica di business
- Validazione dati

Formato:
tipo(api): descrizione endpoint

Scope consigliati:
- api: endpoint API
- db: schema/migrazioni database
- auth: autenticazione/autorizzazione
- validation: validazione dati

Esempio 3: Progetto Python

Genera commit per progetto Python in {{language}}.

{{diff}}

Considera:
- Moduli Python modificati
- Dipendenze (requirements.txt, pyproject.toml)
- Test unitari
- Configurazione

Formato standard PEP 8 con scope.

Scope comuni:
- core: logica principale
- utils: funzioni utility
- tests: test
- deps: dipendenze
- config: configurazione

Prossimi Passi

Scegli un template di base da questa guida
Personalizzalo per le tue esigenze specifiche
Testalo su alcuni commit reali
Affinalo basandoti sui risultati
Condividilo con il team se funziona bene

Per più esempi e ispirazione, controlla la directory examples/ nel repository gac.