write-issue

Erstellt den Text einer Issue (Bug, Feature oder Aufgabe) als CommonMark-Datei im issues-Ordner des Projekts, bereit zum Kopieren in das Ticket-System (Redmine, GitHub, GitLab).

Was ist write-issue?

Diese Skill hilft dir dabei, aus Benutzerbeschreibungen vollständige Issue-Texte zu erstellen und in einer strukturierten CommonMark-Datei im issues/-Ordner abzulegen. Sie ist für Entwickler und KI-Agenten gedacht, die Issues für Redmine, GitHub oder GitLab vorbereiten möchten, ohne direkt auf die API schreiben zu müssen. Der Agent analysiert die Anfrage, klassifiziert sie als Bug, Feature oder Task, überprüft die Informationen im Quellcode und schreibt dann eine formatierte Markdown-Datei mit Kontext, Beschreibung, Reproduktionsschritten (nur bei Bugs), erwartetem Verhalten, Akzeptanzkriterien und technischen Notizen. Wichtig: Die Skill erstellt oder verändert keine Issues im Ticket-System – sie erzeugt nur eine lokale Datei, die der Benutzer manuell kopiert. Der Agent hat lediglich Lesezugriff auf das Ticket-System (curl GET, gh issue view/list) und darf niemals Schreiboperationen ausführen.

Funktioniert mit~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 Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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à. Ometto 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.

Verwandte Skills