Que fait mre-skill ?
Une compétence d'agent (SKILL.md) pour rédiger des exemples minimalement reproductibles que les mainteneurs peuvent copier et exécuter.
Objectif
Cette compétence aide à créer un exemple minimalement reproductible (MRE) — une version allégée du code qui démontre un bogue ou un problème, sans éléments superflus. L'agent produit un snippet ou un projet prêt à être collé et exécuté par un mainteneur.
Utilisation
- L'agent analyse la description du problème fournie par l'utilisateur.
- Il génère un MRE sous forme de fichier unique ou de structure de projet minimale.
- Il inclut les dépendances nécessaires (imports,
package.json,requirements.txt, etc.). - Il fournit des instructions d'exécution claires (commandes CLI, scripts).
Exemple
# Exemple minimal pour démontrer un bogue avec requests
import requests
response = requests.get('https://httpbin.org/get')
print(response.status_code)
print(response.text)
# Pour exécuter :
pip install requests
python mre.py
Plateformes supportées
- GitHub Issues et Discussions
- GitLab Issues
- Stack Overflow
- Tout environnement où les mainteneurs peuvent coller et exécuter du code
Notes
- Le MRE doit être exécutable dès réception, sans configuration supplémentaire.
- Évitez les chemins absolus, les variables d'environnement non documentées, les fichiers volumineux.
- Privilégiez l'utilisation de bibliothèques standard ou de dépendances minières via un gestionnaire de paquets.