gzb1128/skill-forge

Compétence à déclenchement manuel. disable-model-invocation: true empêche le modèle d'invoquer ce workflow automatiquement en cours de tâche. Une fois installé depuis ce plugin, invoquez-le délibérément avec /agent-docs:learn à la fin d'une session. N'ajoutez pas de hooks, de tâches d'arrière-plan, de comportement de déclenchement automatique, de stockage d'exécution, de bases de données vectorielles, d'intégration MCP ou de systèmes de mémoire externes.

Passez en revue ce qui s'est passé dans cette session et produisez des propositions de mémoire vérifiées et révisables pour le fichier AGENTS.md approprié. Ne modifiez pas les fichiers tant que l'utilisateur n'a pas vu le diff proposé et ne l'a pas explicitement approuvé.

Principe de Non-Dérivabilité

N'enregistrez que les informations qui NE peuvent PAS être dérivées de la base de code elle-même. Avant de proposer une entrée Hidden Knowledge, demandez :

Le prochain agent ou humain peut-il découvrir cela en lisant le code, en exécutant git log, ou en consultant la documentation existante ?

Si oui, ne l'enregistrez PAS comme connaissance cachée. La barre est haute. La plupart des connaissances appartiennent au code source, aux messages de commit ou à la documentation existante, pas à AGENTS.md.

Étape 1 : Extraire les pistes candidates

Passez en revue la session en cours et listez les pistes candidates. Les pistes proviennent généralement de dépendances cachées, d'échecs trompeurs, de solutions de contournement spécifiques au projet, d'ordres critiques, de découvertes de commandes ou de lacunes documentaires.

N'écrivez rien encore. Classez d'abord chaque piste.

Étape 2 : Classer les pistes

Classification	Destination	Règle
Hidden Knowledge	Le fichier AGENTS.md pertinent le plus proche sous ## Hidden Knowledge	Uniquement pour les dépendances cachées non dérivables, erreurs trompeuses, solutions de contournement, bizarreries ou ordres critiques
Quick Reference	Tableau Quick Reference du AGENTS.md racine	Commandes de build, test, lint, run, codegen, clean ou autres commandes courantes
Rule	Signaler la destination suggérée uniquement	Convention d'équipe ou limite stricte ; ne créez ni modifiez docs/rules/ depuis /agent-docs:learn
Doc	Signaler la destination suggérée uniquement	Note de conception, de dépannage, de runbook ou de bibliothèque plus longue ; ne créez ni modifiez de documentation depuis /agent-docs:learn
Skip	Aucune écriture	Dérivable, ponctuelle, dupliquée, obsolète, générique ou invérifiable

Pistes pour Hidden Knowledge

Seules les pistes qui réussissent le test de non-dérivabilité peuvent devenir des connaissances cachées :

1. Dépendances cachées : Fichiers ou modules qui doivent être modifiés ensemble mais qui ne sont pas visiblement connectés.
2. Erreurs trompeuses : Messages d'erreur qui pointent vers le mauvais emplacement ou la mauvaise cause.
3. Solutions de contournement et bizarreries : Comportement spécifique au projet qui diffère du schéma standard.
4. Ordre critique : Opérations qui doivent se produire dans une séquence spécifique.

Critères de rejet

Rejetez les pistes qui sont :

• Des motifs de code, de l'architecture ou une structure de fichier visible en lisant le code source.
• L'historique Git ou les changements récents que git log ou git blame enregistrent déjà.
• Des solutions de débogage où le correctif est maintenant dans le code et le message de commit est censé porter le contexte.
• Déjà présentes dans AGENTS.md, docs/rules/ ou README.
• Un comportement standard du langage ou du framework.
• Des commandes non évidentes qui appartiennent à la Quick Reference, pas à Hidden Knowledge.
• Des détails éphémères de session, y compris les tentatives qui ont temporairement échoué.
• Des affirmations non vérifiées.

Étape 3 : Vérifier chaque piste retenue

Chaque piste retenue nécessite une preuve explicite avant de pouvoir être proposée :

La piste mentionne	Preuve de vérification
Chemin de fichier	Confirmer que le chemin existe avec ls ou en lisant le fichier
Fonction, type, commande ou symbole	Confirmer son existence avec une recherche ou une consultation adaptée au langage
Comportement ou contrainte	Exécuter la commande la plus petite pertinente, inspecter le code source, ou expliquer pourquoi l'exécution directe est dangereuse
Contenu existant de AGENTS.md	Lire la section cible et vérifier la présence d'entrées obsolètes ou dupliquées

Si la vérification échoue, classez la piste comme Skip et expliquez l'échec du contrôle. Si la vérification ne peut pas être effectuée en toute sécurité, signalez-la comme non vérifiée et ne proposez pas d'écriture.

Étape 4 : Choisir la cible

Choisissez le fichier AGENTS.md le plus proche du périmètre affecté :

Périmètre de la connaissance	Fichier cible
Affecte l'ensemble du projet	AGENTS.md racine
Affecte un package spécifique	<package>/AGENTS.md
Affecte un module complexe	<package>/<module>/AGENTS.md, uniquement si les critères de sous-package sont remplis

Pour Hidden Knowledge, ajoutez à ou créez une section ## Hidden Knowledge près de la fin du fichier AGENTS.md cible. Limitez chaque connaissance à 1-3 lignes.

Pour Quick Reference, proposez une mise à jour de ligne dans le tableau du AGENTS.md racine.

Pour Rule et Doc, signalez uniquement la destination suggérée. Ne créez ni ne modifiez de documentation de règle, de conception, de dépannage, de runbook ou de bibliothèque à partir de cette commande.

Étape 5 : Afficher d'abord les changements proposés

Avant de modifier un fichier, montrez toutes les propositions dans ce format :

## Propositions d'apprentissage

### 1. `<classification>` -> `<fichier cible>`

**Pourquoi :** <raison en une ligne pour laquelle cela aide les futures sessions>

**Vérification :** <preuve de chemin/symbole/commande/comportement>

**Action :** <ajouter/mettre à jour/rejeter/signaler-uniquement>

```diff
- <ligne existante, uniquement lors de la mise à jour d'une entrée existante approuvée>
+ <ajout ou remplacement exact proposé>
```

### Pistes rejetées

1. `<piste>` -> rejetée parce que <raison>

### Suggestions signalées uniquement

1. `<piste>` -> appartient à <destination suggérée>, non traité par `/agent-docs:learn`

Ne sautez pas l'étape du diff et de l'approbation. Même si l'utilisateur demande d'appliquer rapidement, l'utilisateur doit voir les changements exacts proposés et les approuver d'abord.

Étape 6 : Appliquer uniquement les changements approuvés

Après approbation :

1. Appliquez uniquement les propositions que l'utilisateur a approuvées.
2. Préservez la structure existante de AGENTS.md et gardez les ajouts concis.
3. N'effectuez pas de nettoyage général depuis /agent-docs:learn ; utilisez /agent-docs:remember pour les mémoires existantes obsolètes, dupliquées ou mal placées.
4. Signalez ce qui a changé, où cela a changé, et quelles pistes ont été rejetées.

Procédure

1. Passez en revue l'historique de la conversation pour trouver des pistes candidates.
2. Classez chaque piste comme Hidden Knowledge, Quick Reference, Rule, Doc ou Skip.
3. Appliquez le test de non-dérivabilité aux pistes Hidden Knowledge.
4. Vérifiez chaque piste retenue et enregistrez la preuve.
5. Choisissez le fichier AGENTS.md cible correct ou la destination de signalement uniquement.
6. Affichez les diffs proposés et les pistes rejetées.
7. Attendez l'approbation explicite de l'utilisateur.
8. Appliquez uniquement les changements approuvés de AGENTS.md.
9. Signalez les écritures finales, les rejets et les suggestions restantes signalées uniquement.