Ruolo: Sei un ingegnere senior {LANGUAGE} che costruisce {COMPONENT_TYPE}.
Obiettivo: Implementare {FUNCTION_NAME} che {FUNCTION_PURPOSE}.
Vincoli:
- Seguire {STYLE_GUIDE} (naming, documentazione, gestione degli errori).
- Obiettivo di complessità temporale: {BIG_O}. Vincoli di memoria: {LIMITS}.
- Includere docstring e commenti in linea per la logica non ovvia.
- Evitare dipendenze esterne a meno che non siano giustificate; se aggiunte, spiegarle.
Input:
- Interfacce/Tipi: {TYPES}
- Casi limite: {EDGE_CASES}
- Esempi di input/output: {EXAMPLES}
Deliverables:
1) Solo il blocco di codice finale.
2) Breve motivazione (puntata) dopo il codice.

Ruolo: Sei un ingegnere Python senior che costruisce un'utilità di pulizia dei dati.
Obiettivo: Implementare `normalize_names` che standardizza i nomi utente.
Vincoli:
- Seguire PEP8; sollevare ValueError su tipi non validi.
- Tempo O(n); gestire spazi bianchi e accenti; mantenere la memoria lineare.
- Docstring + commenti.
Input:
- Tipi: List[str] o Iterable[str]
- Casi limite: null, spazi multipli, segni di accento, cognomi con trattino
- Esempi: [" José Álvarez ", "ANNA-lou "] → ["jose alvarez", "anna-lou"]
Deliverables:
1) Solo il blocco di codice finale.
2) Breve motivazione.

Ruolo: Esperto senior di refactoring {LANGUAGE}.
Compito: Rifattorizzare il codice fornito per {GOAL}: {READABILITY|PERFORMANCE|SAFETY}.
Regole:
- Preservare l'API pubblica e il comportamento.
- Aggiungere suggerimenti di tipo e docstring dove mancanti.
- Estrarre funzioni pure per la testabilità.
- Sostituire i numeri magici; applicare {STYLE_GUIDE}.
- Fornire note sulla complessità prima/dopo.
Codice di input:
```{LANGUAGE}
{SOURCE}

### 3) Modello di generazione di test (Test unitari + di proprietà)
**Quando usarlo**: Aumentare rapidamente la copertura.

### 4) Modello di revisione del codice (Modalità revisore automatizzato)
**Quando usarlo**: Revisioni rapide e coerenti prima dell'approvazione umana.

{UNIFIED_DIFF}

### 5) Modello di debug (Riproduzione minima → Causa principale)
**Quando usarlo**: Trovare e correggere bug, creare riproduzioni.

---
## Esempio: Dal ticket alla PR con Grok 4 Fast
Analizziamo uno scenario realistico: un ticket di prodotto richiede "ricerca durante la digitazione con chiamate API debounced e UI ottimistica".
1) **Redigere l'hook**

2) **Chiedere i test**

3) **Eseguire un passaggio di revisione**

4) **Raffinare**

Risultato: avrai codice pronto per la produzione più test e l'IA avrà documentato il suo ragionamento in modo che un compagno di squadra possa seguirlo.
---
## Modelli di prompt che migliorano la qualità dell'output
- **Ruolo + Obiettivo + Vincoli + Input + Deliverables**: Questa struttura offre a Grok 4 Fast tutto ciò di cui ha bisogno per rimanere sui binari.
- **Enumerazione dei casi limite**: Elenca sempre i casi difficili. Il modello li integrerà in test e protezioni.
- **Obiettivi di complessità**: Chiedere O(n) o limiti di memoria spinge ad algoritmi migliori.
- **Contratti API**: Incolla i tipi/interfacce in anticipo; il modello si allineerà a essi.
- **Contratti di output**: Richiedi prima il codice finale, quindi la motivazione. Questo mantiene le risposte pulite per il copia/incolla.
---
## Guide di stile e coerenza: rendilo pronto per il team
Se desideri un output coerente in tutto il team, standardizza:
- **Guide di stile del linguaggio**: PEP8, Effective Go, Airbnb JS, Rust API Guidelines.
- **Convenzioni sugli errori**: return vs throw, codici di errore, semantica di riprova.
- **Norme di test**: naming, directory di fixture, soglie di copertura.
- **Impostazioni predefinite di sicurezza**: convalida dell'input, escaping, gestione dei segreti.
Includi questi come costanti nei tuoi modelli in modo che Grok 4 Fast li interiorizzi ogni volta.
---
## Prompt di sicurezza prima di tutto per codice sicuro
Aggiungi queste clausole di sicurezza ai tuoi modelli:
- **Convalida dell'input**: "Convalidare e sanificare tutti gli input non attendibili."
- **Igiene dei segreti**: "Nessun segreto nel codice. Leggere dall'ambiente e documentare le variabili richieste."
- **Esame delle dipendenze**: "Spiegare e giustificare qualsiasi nuova dipendenza; preferire la libreria standard."
- **Sicurezza della serializzazione**: "Utilizzare parser sicuri; evitare eval/Function/deserializzazione non sicura."
- **Controlli AuthZ**: "Applicare l'autorizzazione su percorsi sensibili; aggiungere test per i tentativi di bypass."
---
## Prompt di prestazioni: evita le solite trappole
- "Ridurre al minimo le allocazioni; riutilizzare i buffer quando i payload sono grandi."
- "Evitare le query N+1; batch o prefetch."
- "Utilizzare streaming/iteratori per i big data."
- "Memoizzare le funzioni pure; profilare gli hotspot."
- "Aggiungere benchmark e spiegare i compromessi."
---
## Checklist di revisione che puoi incollare nelle PR
Includi una breve checklist in modo che ogni revisione sia coerente:
- Compatibilità API confermata
- Gestione di null/undefined e raccolte vuote
- Pulizia delle risorse (file, socket, sottoscrizioni)
- Protezioni di concorrenza (lock, atomiche, idempotenza)
- Livelli di logging appropriati; nessun dato sensibile
- Test aggiornati; migrazioni documentate
---
## Flusso di lavoro del team: rendi i modelli di prompt una risorsa condivisa
- **Centralizzare i modelli** nel tuo repository (ad es., directory `/.prompts`).
- **Parametrizzare** le variabili come `{LANGUAGE}`, `{STYLE_GUIDE}`, `{BIG_O}` utilizzando snippet o macro dell'editor.
- **Versionare** i tuoi modelli di prompt e rivederli come codice.
- **Creare playbook** per la stesura di funzionalità, il refactoring, la scrittura di test e i controlli di rilascio.
A proposito, se il tuo team preferisce un copilota di codifica affiancato che vive nel browser e all'interno dei documenti, vale la pena notare che [Sider.ai](https://sider.ai/) può aiutarti a memorizzare e riutilizzare i modelli di prompt, eseguire revisioni del codice sulle diff e mantenere il contesto tra le schede. È un modo conveniente per rendere operativi questi prompt di Grok 4 Fast nella tua organizzazione senza l'affaticamento del copia/incolla.
---
## Libreria copia-incolla: Prompt pronti all'uso
### Handler API TypeScript (Node/Express)

### Passaggio della pipeline di dati Python

### Guardia di concorrenza Go

### Componente accessibile React

---
## Come Iterare Velocemente con Grok 4 (Ciclo di Feedback Stretto)
1) **Inizia in piccolo**: Chiedi una sola funzione, non l'intero servizio.
2) **Limita gli output**: "Un blocco di codice, poi elenchi puntati."
3) **Richiedi test**: Ogni funzionalità deve avere dei test nello stesso passaggio.
4) **Definisci le decisioni**: "Spiega i compromessi. Se incerto, poni domande chiarificatrici."
5) **Miglioramento incrementale**: Migliora a strati: prima la correttezza, poi le prestazioni, poi la leggibilità.
---
## Misurare il Successo: I Template Hanno Aiutato?
Traccia metriche semplici:
- Tempo del ciclo di PR (creata → unita)
- Tasso di rilavorazione della revisione (modifiche richieste per PR)
- Delta di copertura dei test per funzionalità
- Incidenti di produzione legati al codice revisionato dall'AI
Se i numeri tendono nella direzione giusta, raddoppia. In caso contrario, ottimizza i tuoi template e includi più contesto ({tipi}, {log}, {diff}).
---
## Errori Comuni da Evitare
- Prompt troppo ampi come "costruisci il backend". Dividi in unità.
- Dimenticare i casi limite. Elencali sempre.
- Consentire l'eccessiva proliferazione di librerie. Chiedi una giustificazione.
- Saltare i test "per dopo". Includili nel prompt.
- Accettare revisioni vaghe. Richiedi checklist e livelli di gravità.
---
## Checklist di Avvio Rapido
- Crea una cartella `/prompts` nel tuo repository.
- Salva i template di bozza, revisione e test.
- Parametrizza i campi comuni con variabili snippet.
- Prova su una funzionalità questa settimana; misura i risultati.
- Itera in base al feedback dei revisori e agli incidenti.
---
## Considerazioni Finali
Grok 4 Fast è eccellente nel produrre codice rapidamente, ma il vero potere deriva da template di prompt ben strutturati che codificano i tuoi standard. Considera i prompt come infrastruttura. Versiona. Rivedili. E lascia che Grok 4 Fast gestisca il boilerplate in modo che il tuo team possa concentrarsi sull'architettura e sul prodotto.
Passo successivo: scegli un template qui sopra, incollalo nel tuo editor, sostituisci il tuo contesto e invia una PR oggi stesso.
### FAQ
D1: Come posso usare Grok 4 Fast per la stesura di codice con uno stile coerente?
Utilizza un template di prompt strutturato che definisca ruolo, obiettivo, vincoli e guida di stile. Includi obiettivi di complessità, casi limite e deliverable in modo che Grok 4 Fast produca codice coerente e pronto per la produzione.
D2: Grok 4 Fast può eseguire revisioni del codice affidabili con i template di prompt?
Sì. Fornisci una diff, gli standard del tuo team e una checklist per la sicurezza, le prestazioni e la compatibilità delle API. Richiedi risultati classificati per gravità e suggerimenti minimi per le patch.
D3: Qual è il modo migliore per generare test utilizzando Grok 4 Fast?
Utilizza un template di generazione di test che specifichi framework, obiettivi di copertura e casi limite. Richiedi sia test unitari che test basati sulle proprietà, oltre a un breve piano di copertura.
D4: Come posso impedire che il codice non sicuro provenga dagli output dell'AI?
Aggiungi clausole di sicurezza ai tuoi prompt: convalida dell'input, igiene dei segreti, giustificazione delle dipendenze e serializzazione sicura. Richiedi note esplicite sui compromessi di sicurezza.
D5: In che modo i template di prompt velocizzano i cicli di PR con Grok 4 Fast?
I template riducono l'ambiguità, standardizzano gli output e anticipano i test e le revisioni. Ciò riduce i tempi di andata e ritorno, diminuisce la rilavorazione e ti aiuta a unire più velocemente.