scrittura-issue

Scrive il testo di una issue (bug, funzionalità o attività) in un file CommonMark nella cartella issues del progetto, pronto da copiare nel gestionale (Redmine, GitHub, GitLab).

O que é scrittura-issue?

Questa skill prepara il testo di una issue (bug, funzionalità o attività) partendo dalla descrizione fornita dall'utente. L'agente raccoglie e verifica le informazioni consultando il codice del progetto, identifica dati mancanti o ambigui e scrive un file CommonMark ben strutturato nella cartella `issues/` del progetto. Il file può poi essere copiato dall'utente nel gestionale (Redmine, GitHub, GitLab) per creare la issue vera e propria. La skill agisce solo in lettura sui sistemi esterni, non modifica mai le issue esistenti e non le crea direttamente; si limita a produrre il testo pronto all'uso, seguendo una struttura standardizzata con sezioni come contesto, descrizione, passi per riprodurre (solo per bug), comportamento atteso e criteri di accettazione.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gabriele-murara/team-skills/tree/HEAD/plugins/issues/skills/write-issue

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Scrittura di una issue

Prepara il testo di una issue a partire da quanto descritto dall'utente ($ARGUMENTS e la conversazione). L'utente copierà il testo nel gestionale, dove creerà la issue e le darà assegnatario, priorità, versione ecc. Questa skill non crea la issue sul gestionale.

Gestionale: solo lettura

Sul gestionale (Redmine, GitHub, GitLab) l'agente può solo leggere le issue. Non deve mai modificarle, nemmeno se l'utente lo chiede:

  • niente creazione, modifica, chiusura, riapertura o eliminazione;
  • niente commenti, note, allegati, tempo speso;
  • niente cambi di stato, assegnatario, priorità, versione, etichette.

Usa solo richieste di lettura: curl senza -X né dati (quindi GET), gh issue view, gh issue list. Mai POST, PUT, PATCH, DELETE, né comandi come gh issue create, edit, comment, close, reopen, delete. Se serve inserire un testo nel gestionale, scrivilo in un file in issues/: lo copia l'utente.

1. Cartella issues

Nella root del progetto (root del repository git, se esiste) deve esistere la cartella issues/ con un .gitignore che ignora tutto il contenuto tranne se stesso:

*
!.gitignore

Se la cartella o il .gitignore mancano, creali. Se il .gitignore esiste con un contenuto diverso, non modificarlo: segnalalo all'utente.

2. Raccolta e verifica delle informazioni

  1. Classifica la richiesta: bug, funzionalità o attività (manutenzione, aggiornamento, refactoring, documentazione...).
  2. Verifica quanto descritto sul codice del progetto: cerca i file, le classi, le rotte, le tabelle e i comportamenti citati, e controlla che esistano e funzionino come descritto. Annota i file coinvolti.
  3. Individua le informazioni mancanti o ambigue, ad esempio:
    • bug: passi per riprodurlo, comportamento atteso e attuale, ambiente (produzione, staging, locale), messaggi di errore o log;
    • funzionalità: chi la usa, cosa deve poter fare, casi limite, vincoli;
    • per tutte: criteri per considerare la issue risolta.
  4. Se manca qualcosa di necessario, o se il codice non corrisponde a quanto descritto, chiedi all'utente prima di scrivere. Fai le domande tutte insieme e solo su ciò che serve davvero.

Non proporre e non implementare la soluzione: la issue descrive il problema e il risultato atteso. Le note tecniche servono solo a orientare chi ci lavorerà.

3. Scrittura del file

Scrivi il file issues/<AAAA-MM-GG>-<slug>.md, dove slug è il titolo in minuscolo, con parole separate da - e senza caratteri speciali (massimo 50 caratteri). Se il file esiste già, aggiungi un suffisso -2, -3...

Struttura del file:

# <Titolo breve e specifico>

## Contesto

[Dove si colloca il problema o l'attività, e perché è necessario.]

## Descrizione

[Bug: comportamento attuale. Funzionalità/attività: cosa va fatto.]

## Passi per riprodurre

1. [...]

## Comportamento atteso

[...]

## Criteri di accettazione

- [ ] [Condizione verificabile]

## Note tecniche

- `percorso/del/file` — [perché è rilevante]

## Riferimenti

- [Link, issue collegate, log, screenshot]

Regole:

  • Passi per riprodurre solo per i bug; Comportamento atteso per bug e funzionalità. Ometti Note tecniche e Riferimenti se vuote.
  • La riga # Titolo va nel campo titolo del gestionale; il resto, dai titoli ## in giù, va nella descrizione.
  • Formato CommonMark; codice e log in code block con il linguaggio.
  • Lingua: italiano. Niente emoji.
  • Testo conciso e comprensibile a chi non ha seguito la conversazione: niente riferimenti a "come detto sopra" o alla sessione.

4. Risposta all'utente

Indica:

  • il percorso del file creato;
  • il titolo proposto e il tipo (bug, funzionalità, attività);
  • che, dopo aver creato la issue sul gestionale, conviene rinominare il file includendo il numero della issue (ad esempio issues/123-<slug>.md): così open-issue 123 lo trova anche senza accesso al gestionale.

Habilidades Relacionadas