Rédaction d'une issue
Prépare le texte d'une issue à partir de ce que l'utilisateur a décrit
($ARGUMENTS et la conversation). L'utilisateur copiera le texte dans le
gestionnaire, où il créera l'issue et lui attribuera un responsable, une priorité,
une version, etc. Cette compétence ne crée pas l'issue sur le gestionnaire.
Gestionnaire : lecture seule
Sur le gestionnaire (Redmine, GitHub, GitLab), l'agent peut uniquement lire les issues. Il ne doit jamais les modifier, même si l'utilisateur le demande :
- pas de création, modification, fermeture, réouverture ou suppression ;
- pas de commentaires, notes, pièces jointes, temps passé ;
- pas de changement d'état, de responsable, de priorité, de version, d'étiquettes.
Utilise uniquement des requêtes en lecture : curl sans -X ni données (donc GET),
gh issue view, gh issue list. Jamais POST, PUT, PATCH, DELETE, ni de
commandes comme gh issue create, edit, comment, close, reopen,
delete. Si un texte doit être saisi dans le gestionnaire, écris-le dans un fichier
dans issues/ : c'est l'utilisateur qui le copie.
1. Dossier issues
À la racine du projet (racine du dépôt git, si elle existe), le dossier issues/
doit exister avec un .gitignore qui ignore tout le contenu sauf lui-même :
*
!.gitignore
Si le dossier ou le .gitignore manque, crée-les. Si le .gitignore
existe avec un contenu différent, ne le modifie pas : signale-le à l'utilisateur.
2. Collecte et vérification des informations
- Classe la demande : bug, fonctionnalité ou tâche (maintenance, mise à jour, refactoring, documentation…).
- Vérifie ce qui est décrit dans le code du projet : cherche les fichiers, les classes, les routes, les tables et les comportements mentionnés, et contrôle qu'ils existent et fonctionnent comme décrit. Note les fichiers concernés.
- Identifie les informations manquantes ou ambiguës, par exemple :
- bug : étapes pour le reproduire, comportement attendu et actuel, environnement (production, staging, local), messages d'erreur ou logs ;
- fonctionnalité : qui l'utilise, ce qu'elle doit permettre, cas limites, contraintes ;
- pour tous : critères pour considérer l'issue comme résolue.
- Si quelque chose d'essentiel manque, ou si le code ne correspond pas à ce qui est décrit, demande à l'utilisateur avant d'écrire. Pose toutes les questions d'un coup et uniquement sur ce qui est vraiment nécessaire.
Ne propose pas et ne mets pas en œuvre la solution : l'issue décrit le problème et le résultat attendu. Les notes techniques servent uniquement à orienter ceux qui travailleront dessus.
3. Écriture du fichier
Écris le fichier issues/<AAAA-MM-JJ>-<slug>.md, où slug est le titre
en minuscules, avec des mots séparés par - et sans caractères spéciaux
(50 caractères maximum). Si le fichier existe déjà, ajoute un suffixe
-2, -3…
Structure du fichier :
# <Titre court et spécifique>
## Contexte
[Où se situe le problème ou la tâche, et pourquoi il est nécessaire.]
## Description
[Bug : comportement actuel. Fonctionnalité/tâche : ce qui doit être fait.]
## Étapes pour reproduire
1. [...]
## Comportement attendu
[...]
## Critères d'acceptation
- [ ] [Condition vérifiable]
## Notes techniques
- `chemin/vers/fichier` — [pourquoi c'est pertinent]
## Références
- [Lien, issues liées, log, capture d'écran]
Règles :
- Étapes pour reproduire uniquement pour les bugs ; Comportement attendu pour les bugs et les fonctionnalités. Omet Notes techniques et Références si elles sont vides.
- La ligne
# Titreva dans le champ titre du gestionnaire ; le reste, à partir des titres##, va dans la description. - Format CommonMark ; code et logs dans des blocs de code avec le langage.
- Langue : italien. Pas d'emoji.
- Texte concis et compréhensible pour quelqu'un qui n'a pas suivi la conversation : pas de références à "comme dit plus haut" ou à la session.
4. Réponse à l'utilisateur
Indique :
- le chemin du fichier créé ;
- le titre proposé et le type (bug, fonctionnalité, tâche) ;
- qu'après avoir créé l'issue sur le gestionnaire, il convient de renommer le
fichier en incluant le numéro de l'issue (par exemple
issues/123-<slug>.md) : ainsiopen-issue 123le trouvera même sans accès au gestionnaire.