OpenGHz/enregistrer-problèmes-utilisation

Que fait enregistrer-problèmes-utilisation ?

Une compétence agent opt-in qui enregistre les frictions et bugs rencontrés par les utilisateurs lors de l'utilisation de votre projet dans un journal AGENT_ISSUES.md prêt pour le triage.

Vue d'ensemble

Cette compétence transforme l'agent en un enregistreur passif mais proactif des problèmes utilisateur. L'agent surveille les interactions et, lorsqu'il détecte une friction (erreur, confusion, comportement inattendu), il consigne l'incident dans AGENT_ISSUES.md. Chaque entrée inclut une description, contexte, cause probable, sévérité et priorité, permettant aux développeurs de trier rapidement les problèmes.

Fonctionnement

1. Opt-in : Activé uniquement si le projet contient une configuration appropriée (ex. agent-config.json avec recordUsageIssues: true).
2. Détection : L'agent analyse les conversations et logs utilisateur pour détecter des schémas de friction.
3. Enregistrement : Pour chaque incident, il ajoute une entrée formatée dans AGENT_ISSUES.md avec horodatage, description, cause racine possible, sévérité (faible/moyenne/haute) et priorité (P1-P4).
4. Gestion : Les entrées sont regroupées par version ; les doublons sont fusionnés si la cause est similaire. Le fichier peut être commité dans le dépôt pour suivi.

Configuration

Ajoutez ceci à votre agent-config.json :

{
  "recordUsageIssues": {
    "enabled": true,
    "severityThreshold": "low"
  }
}

• severityThreshold : définit le niveau minimum de sévérité à enregistrer (par défaut : low).

Exemple de sortie

Un extrait de AGENT_ISSUES.md :

# Projets de l'Agent

## Version 1.0.0

### P2 - L'utilisateur reçoit une erreur 500 lors de la connexion

- **Date** : 2024-01-15 14:35 UTC
- **Contexte** : L'utilisateur a saisi des identifiants valides mais a reçu une erreur serveur.
- **Cause probable** : Le service d'authentification a renvoyé une exception non gérée.
- **Sévérité** : Haute
- **Priorité** : P2
- **Solution suggérée** : Vérifier les logs du service d'authentification et ajouter une gestion d'erreur.

## Version 0.9.0

### P3 - La documentation sur l'API est obsolète

- **Date** : 2024-01-10 09:12 UTC
- **Contexte** : L'utilisateur a suivi un exemple dans la doc qui ne fonctionne plus.
- **Cause probable** : L'API a changé mais la documentation n'a pas été mise à jour.
- **Sévérité** : Moyenne
- **Priorité** : P3
- **Solution suggérée** : Mettre à jour la documentation avec les nouveaux endpoints.

Plateformes supportées

• Claude Code
• Cursor (avec configuration adaptée)
• Tout agent supportant les compétences personnalisées

Remarques

• La compétence ne modifie pas le code utilisateur ; elle écrit uniquement dans le fichier de logs.
• Pour désactiver, retirez simplement la configuration ou mettez enabled: false.
• Les problèmes sont enregistrés une seule fois par session pour éviter les doublons.