Community生产力与协作github.com

write-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).

write-issue 是什么?

Questa skill prepara il testo di una issue a partire dalla descrizione fornita dall'utente, scrivendola in un file CommonMark nella cartella `issues/` del progetto. È utile per chi lavora con strumenti di tracciamento (Redmine, GitHub, GitLab) e vuole compilare il contenuto in locale prima di copiarlo manualmente. Supporta tre tipi di issue: bug, funzionalità e attività. L'agente può leggere le issue dal gestionale (con GET, `gh issue view`, `gh issue list`) ma non può mai modificarle, nemmeno su richiesta: niente creazione, modifica, chiusura, commenti o allegati. Il flusso inizia con la raccolta e verifica delle informazioni direttamente sul codice del progetto (cerca file, classi, rotte, tabelle) per confermare che corrispondano alla richiesta. Se mancano dati essenziali o il codice non corrisponde, l'agente pone domande mirate all'utente. Il file generato segue una struttura standardizzata: titolo, contesto, descrizione, passi per riprodurre (solo per bug), comportamento atteso, criteri di accettazione, note tecniche e riferimenti. L'agente non propone soluzioni; si limita a descrivere il problema e il risultato atteso. Il nome del file include la data e uno slug derivato dal titolo (massimo 50 caratteri, senza caratteri speciali). Se il file esiste già, viene aggiunto un suffisso numerico. La risposta all'utente include il percorso del file, il titolo proposto e il tipo, suggerendo di rinominare il file con il numero della issue dopo la creazione sul gestionale.

兼容平台~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 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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.

相关技能