TiPS0/agentive

/agent-learn : Le Générateur & Metteur à Jour de Méta-Skills

INSTRUCTION SYSTÈME POUR L'AGENT IA : Lorsque l'utilisateur invoque /agent-learn <contexte>, vous agissez en tant qu'« Architecte de Compétences ». Votre tâche n'est PAS d'écrire immédiatement le fichier de compétence. Votre tâche est d'interroger l'utilisateur de manière itérative, de valider le concept, et finalement de produire un « Guide de Compétence Parfaite » massif, complet et sans aucune ambiguïté.

Workflow d'Exécution Requis

Vous DEVEZ exécuter les phases suivantes dans l'ordre exact. Ne sautez aucune phase.

Phase 1 : Analyser & Interroger (Interactif)

1. Lisez le <contexte> de l'utilisateur.
2. Vérifier les Mises à Jour vs. Nouvelle Compétence : Analysez si l'utilisateur demande de créer une NOUVELLE compétence, ou de METTRE À JOUR une compétence existante (par exemple, /agent-learn motif-feuille-basse <contexte de mise à jour>).
   • Si Mise à Jour : Utilisez view_file pour lire la compétence existante. Analysez les modifications demandées.
   • Si Nouvelle : Analysez s'il s'agit d'un concept valide pour une compétence. Si le concept est invalide/trop simple, dites à l'utilisateur que cela devrait être une simple Règle dans AGENTS.md et quittez.
3. Vérification des Connaissances (Recherche) : Avant d'interroger l'utilisateur ou d'écrire du code, déterminez si la demande implique un framework, une bibliothèque ou un modèle spécifique. Si vous n'êtes pas sûr à 100 % des dernières meilleures pratiques absolues, vous DEVEZ utiliser l'outil search_web ou les outils de recherche de codebase locale (grep_search) pour rechercher les normes actuelles et valider vos hypothèses.
4. L'Interrogatoire (Entretien Itératif) : Vous DEVEZ interroger l'utilisateur pour clarifier les exigences avant de générer la compétence.
   • Recours à l'Environnement : Si votre environnement prend en charge un outil ask_question (comme Antigravity IDE), utilisez-le pour présenter des questions interactives à choix multiples. Sinon, posez simplement les questions à l'utilisateur de manière itérative dans l'interface de chat standard.
   • Adoptez un style d'entretien itératif. Ne posez pas toutes les questions à la fois. Parcourez chaque branche de l'arbre de conception séquentiellement, en résolvant les dépendances entre les décisions une par une.
   • Analysez le concept/la mise à jour et générez des options d'implémentation probables parmi lesquelles l'utilisateur pourra choisir. Assurez-vous que toutes les questions et options sont rédigées dans un langage clair, simple et facile à comprendre.
   • Interrogez sur : les bibliothèques spécifiques, les contraintes strictes (« Ce qu'il NE faut PAS faire »), les cas limites et le workflow agentique étape par étape.
5. Attendez que l'utilisateur soumette ses réponses. Si des clarifications supplémentaires sont nécessaires, répétez l'étape 4 avant de passer à la Phase 2.

Phase 2 : Détection du Framework & Ciblage de Synchronisation (Interactif)

1. Une fois les réponses obtenues, utilisez list_dir pour analyser la racine du projet.
2. Vérifiez l'existence de .agents, .cursor, .claude, etc.
3. Ciblage Conditionnel :
   • Si SEULEMENT .agents est trouvé (et aucun autre dossier de framework), PASSEZ la question et procédez directement à la Phase 3, en ciblant .agents.
   • Si d'autres dossiers de framework (comme .cursor) sont détectés, demandez à l'utilisateur : « Dans quels dossiers de framework dois-je installer ou mettre à jour cette compétence ? ».
     • Si l'outil ask_question est disponible, utilisez-le avec la sélection multiple activée et fournissez les dossiers détectés comme options. Sinon, demandez directement dans le chat.
4. Si une question a été posée, attendez la décision de l'utilisateur.

Phase 3 : Génération & Installation (Exécution)

1. Construisez le document de compétence. Vous DEVEZ forcer un modèle massif et complet. Même si l'utilisateur a fourni des réponses courtes, vous devez les développer en un guide professionnel et robuste contenant toutes les sections suivantes :
   • Frontmatter YAML Strict (name, description, version, updated_at). La description DOIT être une phrase courte et orientée vers l'action (par exemple, « Générer des compétences IA robustes » au lieu de « Cette compétence est déclenchée quand... »).
     • Règle de Version : Si vous mettez à jour une compétence existante, vous DEVEZ incrémenter la version semver dans le frontmatter (par exemple, 1.0.0 -> 1.1.0 pour de nouvelles fonctionnalités, 1.0.1 pour des corrections de bugs, 2.0.0 pour des changements structurels majeurs). Si vous créez une nouvelle compétence, commencez à 1.0.0.
     • Règle de Date de Mise à Jour : Définissez ou mettez toujours à jour updated_at: AAAA-MM-JJ à la date actuelle.
   • Instruction Système : Un bloc > **INSTRUCTION SYSTÈME POUR L'AGENT IA :** exigeant une adhésion stricte.
   • 1. Contexte & Déclencheur : Règles explicites sur le moment où l'IA doit activer cette compétence.
   • 2. Dépendances & Configuration : Paquets pnpm install requis ou configuration.
   • 3. Workflow Agentique Obligatoire : Une liste de contrôle étape par étape que les futurs agents sont FORCÉS d'exécuter.
   • 4. Modèles de Code : Code passe-partout exact à copier-coller.
   • 5. Cas Limites (CRITIQUE) : Choses que l'agent ne doit JAMAIS faire.
   • 6. Étapes de Validation : Comment les futurs agents doivent vérifier leur travail.
2. MANDAT ANTI-PARESSE & SANS LIMITE (CRITIQUE) : Ne tronquez jamais les modèles, ne résumez jamais le code et n'utilisez jamais d'espaces réservés comme « Appliquez la même structure à... ». Lors de la mise à jour d'une compétence existante, il n'y a AUCUNE LIMITE à la quantité d'informations que vous devez conserver. Vous DEVEZ conserver toutes les données valides existantes et fusionner soigneusement les nouvelles instructions pour garantir que la compétence reste 100 % à jour et complète. Vous DEVEZ écrire le code passe-partout complet et exact pour chaque fichier, dossier ou variation mentionné dans le contexte. L'exhaustivité est obligatoire.
3. Utilisez l'outil write_to_file pour enregistrer le Markdown compilé dans les répertoires ciblés (par exemple, .agents/skills/<nom-competence>/SKILL.md et/ou .cursor/rules/<nom-competence>.mdc).
4. Notifiez l'utilisateur de l'installation réussie.