Creare e gestire le Issue
Guida passo passo per creare issue manualmente, impostare le priorità, modificare i dettagli di una issue e gestire le issue in blocco.
Anche se le issue session possono scoprire problemi automaticamente, puoi anche creare e gestire le issue manualmente. Questo è utile quando sai già cosa deve essere corretto, vuoi aggiungere contesto a issue scoperte dall’IA, oppure devi organizzare elementi di lavoro che non richiedono la scansione della codebase.
Creare una issue manualmente
Per creare una issue dalla pagina Issue, clicca sul pulsante Nuova Issue. Si apre la finestra di dialogo per la creazione manuale con i seguenti campi:
- Titolo(obbligatorio) - Un riepilogo breve e descrittivo del problema o del task. Mantienilo conciso ma abbastanza specifico da identificare la issue a colpo d’occhio.
- Descrizione (obbligatoria) - Una spiegazione dettagliata della issue. Includi il contesto su dove si verifica il problema, quale dovrebbe essere il comportamento atteso, e qualsiasi messaggio di errore o sintomo rilevante.
- Priorità (obbligatoria) - Il livello di importanza della issue. Il valore predefinito è
mediumse non specificato. - Prompt suggerito(opzionale) - Istruzioni specifiche per un agente IA per risolvere la issue. Se fornito, questo prompt viene usato al posto della descrizione quando si avvia un workflow run. Scrivilo come un’istruzione diretta (ad esempio, "Correggi il memory leak in src/ws/handler.ts ripulendo gli event listener alla disconnessione").
Scrivere buoni prompt suggeriti
Livelli di priorità
Ogni issue ha un livello di priorità che ti aiuta a organizzare e smistare il lavoro:
| Priorità | Quando usarla |
|---|---|
critical | Bug che bloccano la produzione, vulnerabilità di sicurezza o scenari di perdita di dati che richiedono attenzione immediata. |
high | Bug o issue significativi che influenzano funzionalità principali ma hanno soluzioni temporanee. Dovrebbero essere affrontati nello sprint corrente. |
medium | Miglioramenti non critici, bug minori o task da fare ma non urgenti. Questa è la priorità predefinita. |
low | Miglioramenti piacevoli ma non essenziali, pulizia del codice o piccoli problemi estetici che possono aspettare. |
Modificare le issue
Puoi aggiornare qualsiasi campo di una issue dopo la creazione. Dalla vista dettagliata della issue, modifica:
- Titolo - Affina il riepilogo man mano che scopri di più sul problema
- Descrizione - Aggiungi contesto supplementare o note di indagine
- Priorità - Modificala in base a cambiamenti di impatto o urgenza
- Prompt suggerito - Aggiorna le istruzioni di correzione in base a nuove scoperte
Issue in esecuzione
running non dovrebbero essere modificate, poiché le modifiche non influenzeranno il workflow run attivo. Attendi che il run si completi o fallisca prima di apportare modifiche e riprovare.Eliminare le issue
Le issue supportano l’eliminazione soft - le issue eliminate vengono spostate nel cestino e possono essere recuperate se necessario. Per eliminare le issue:
- Eliminazione singola- Clicca sull’azione di eliminazione su una singola card di issue o dalla vista dettagliata della issue.
- Eliminazione in blocco- Seleziona più issue usando le checkbox nell’elenco delle issue, poi clicca sull’azione di eliminazione in blocco. Utile per ripulire grandi lotti di issue scoperte dall’IA non rilevanti.
Scoprire le issue con l’IA
Per la scoperta automatica delle issue, CodeCourier offre le issue session - run di scansione basati su IA che analizzano la tua codebase ed estraggono automaticamente le issue. Una issue session provisiona una sandbox cloud, esegue un agente IA con il tuo prompt di scoperta e produce un elenco strutturato di issue completo di titoli, descrizioni, priorità e prompt di correzione suggeriti.