🔌 Interfacce e Punto di Ingresso

::: info GitHub Copilot in VS Code offre diversi livelli di interazione. Saper switchare tra Ghost Text, Inline Chat e Copilot Edits è la competenza chiave per evitare il “debito tecnico assistito” e mantenere il controllo totale sulla codebase. :::

1. Ghost Text (Autocompletamento Predittivo)

È il livello più basso e immediato. Funge da “estensione del pensiero” durante la digitazione.

Scope: Locale (la riga corrente o la funzione in scrittura).
Workflow: Inizia a scrivere o scrivi un commento (# o //). Copilot suggerisce il codice in grigio.
Best Practice: Usa TAB per accettare, ma usa Alt + [ o ] per ciclare tra suggerimenti alternativi. Spesso la prima proposta è la più ovvia, ma non la più efficiente.

2. Inline Chat (`Ctrl + I`)

L’interfaccia chirurgica. Serve per modificare blocchi di codice esistenti senza staccare gli occhi dall’editor.

Scope: Singolo file (porzione selezionata).
Uso ideale:
- Refactoring rapido di una funzione.
- Aggiunta di gestione delle eccezioni (try-except).
- Documentazione istantanea (Docstrings/Doxygen).
Tecnica Senior: Seleziona il codice e digita /fix per correggere bug evidenti o /optimize per migliorare le performance algoritmiche.

3. Chat Sidebar (`Ctrl + Alt + I`)

L’interfaccia analitica. È il tuo consulente architettonico.

Scope: Intero Workspace (usando l’agente @workspace).
Uso ideale:
- Domande sulla logica globale (es: “Dove viene gestita l’autenticazione in questo progetto?”).
- Spiegazione di codice legacy complesso.
- Generazione di Unit Test per file esistenti.
Limiti: La Chat suggerisce il codice, ma non modifica i file. Devi copiare e incollare manualmente.

4. Copilot Edits (`Ctrl + Shift + I`) 🏆

L’interfaccia orchestrale. Trasforma l’IA in un Agente di Sviluppo. È qui che i modelli come Claude 3.5/3.7 Sonnet danno il meglio.

Scope: Multi-file (Working Set).
Caratteristica Unica: Può creare, eliminare e modificare più file in un’unica sessione, mostrando una vista “Diff” (confronto) prima di applicare le modifiche.

Workflow Avanzato in Edits:

Apertura: Ctrl + Shift + I.
Definizione del Working Set: Clicca su Add Files o usa Alt + Enter per aggiungere i file coinvolti nel cambiamento (es: models.py, schemas.py, api_routes.py).
Prompt Strategico: “Implementa il sistema di permessi basato su ruoli: aggiungi la colonna al DB, aggiorna il modello Pydantic e proteggi le rotte API interessate.”
Review: Copilot applicherà le modifiche in “Ghost Mode”. Tu vedrai le righe rosse/verdi. Clicca su Accept solo dopo la review tecnica.

📉 Matrice Decisionale (Mermaid)

graph TD
    A[Cosa devi fare?] --> B{Dimensione del task?}
    B -->|Micro: 1-2 righe| C[Ghost Text: TAB]
    B -->|Chirurgico: 1 funzione| D[Inline Chat: Ctrl+I]
    B -->|Analitico: Domanda/Test| E[Sidebar Chat: Ctrl+Alt+I]
    B -->|Strategico: Multi-file| F[Copilot Edits: Ctrl+Shift+I]
    
    style F fill:#f96,stroke:#333,stroke-width:2px

💡 Note dell’Architetto (Critical Thinking)

Il rischio della Sidebar: Non usare la Sidebar Chat per fare modifiche pesanti; il copia-incolla manuale introduce errori di indentazione o import mancanti. Per le modifiche, passa sempre a Edits.
Claude 3.7 & Reasoning: Quando usi Copilot Edits per bug logici profondi, assicurati di aver selezionato Claude 3.7. Se vedi che l’IA “pensa” (Reasoning), lasciala finire: sta analizzando i grafi di dipendenza che tu potresti aver dimenticato.
Undo di Edits: Una delle funzioni più potenti di Edits è l’Undo globale. Se una generazione non ti soddisfa, puoi annullare le modifiche su 10 file contemporaneamente con un solo clic.

Tags: #Copilot #VSCode #Workflow #Claude35 #SoftwareEngineering*