Que fait Personalisation Memory ?
Transformez les traces d’interaction répétées en préférences durables sans obliger l’agent principal à s’arrêter et à demander à l’utilisateur chaque mise à jour de mémoire. Cette compétence constitue la couche de réécriture qui permet au système de devenir plus personnel au fil du temps.
Structure du répertoire de la compétence
<dossier-compétence-installée>/
├── SKILL.md
├── references/
│ ├── trajectory-scanner.md
│ └── writeback-policy.md
└── templates/
└── preference-ledger.md
Contrat fondamental
- Ne demandez pas à l’utilisateur simplement pour décider si une préférence courante doit être mémorisée.
- Préférez une analyse sidecar à faible coût pour la synthèse à partir des journaux, trajectoires, diffs, sorties sidecar, bundles de revue et mémoire de projet.
- Ne copiez jamais de conversations privées brutes, de journaux bruts, d’identifiants, de chemins locaux uniquement ou de messages de collaborateurs dans la mémoire publique du dépôt.
- Stockez la plus petite leçon réutilisable, pas l’épisode entier.
- Traitez la personnalisation comme une échelle de promotion : observation -> candidat -> préférence -> contrat de projet -> candidate règle de compétence réutilisable.
- Les modifications publiques de compétence nécessitent la même validation normale du dépôt, le même commit, push et réinstallation que les autres modifications de compétence.
Quand l’utiliser
Utilisez cette compétence quand :
- l’utilisateur indique qu’un flux de travail doit être personnalisé, automatique, mémorisé ou appris à partir des trajectoires
- l’agent remarque des préférences répétées telles que « ne me demande pas », « commit/push d’abord », « utilise la compilation Overleaf », « préfère les captures d’écran/paquets de pages », « utilise sidecar pour les analyses à faible risque »
- une autre compétence termine un travail significatif et il y a des leçons réutilisables sur le flux de travail, l’écriture, les figures, LaTeX, Git, la revue ou le calcul
- les journaux de trajectoire de Codex ou Claude Code doivent être scannés pour en faire des préférences candidates
- la mémoire de projet doit séparer les faits utilisateur privés des contrats de projet partagés et des règles de compétence publiques
Associez avec sidecar-task-runner pour l’analyse à faible coût et avec research-project-memory lorsque des conclusions acceptées au niveau projet doivent mettre à jour memory/.
Chargement progressif
- Lisez
references/writeback-policy.mdavant de décider où attribuer une préférence. - Lisez
references/trajectory-scanner.mdavant de lancer une analyse sidecar sur les journaux, trajectoires, artefacts sidecar ou l’historique du dépôt. - Utilisez
templates/preference-ledger.mdlorsqu’un projet ne dispose pas de registre de préférences.
Flux de travail
- Collectez les entrées d’artefacts. Privilégiez les artefacts nettoyés :
memory/,git diffrécent,.agent/sidecars/*/decision.md,.agent/code-reviews/*/fix-log.md,.agent/layout-issues/*/manifest.md, l’état.agent/du document/code, et les préférences explicites de l’utilisateur dans le résumé de la tâche en cours. - Lancez une analyse à faible coût quand c’est utile. Utilisez
sidecar-task-runneravec le préréglagepersonalization-scannerpour les analyses d’historique ou de trajectoire non triviales. Le scanner produit des candidats ; il ne doit pas modifier directement la mémoire. - Classez chaque candidat. Attribuez une portée :
private-user,project,public-skill-candidateoudiscard. Attribuez un type :workflow,writing,layout,figure-style,code-review,git,compute,toolchainoucollaboration. - Appliquez des seuils de confiance. Un seul épisode observé peut devenir une leçon. Des épisodes répétés ou une formulation explicite de l’utilisateur peuvent devenir une préférence. Les contrats de projet nécessitent des preuves propres au projet. Les règles de compétence publiques nécessitent l’intention d’un mainteneur ou des preuves répétées entre projets.
- Écrivez dans la bonne couche. Utilisez le routage de
references/writeback-policy.md. Écrivez des entrées courtes avec la date, l’artefact source, la confiance et la portée cible. - Rapportez uniquement le résumé utile. Indiquez à l’utilisateur ce qui a été mémorisé ou quels candidats ont été différés. Ne demandez pas de confirmation sauf si l’étape suivante publierait une politique privée ou publique.
Cibles par défaut
- Préférences utilisateur privées : zone mémoire privée de l’agent en cours, comme
~/.codex/memories/, en particulier pour les faits de poste de travail, les alias d’outils, les chemins locaux, le style d’interaction préféré et les paramètres par défaut du flux de travail personnel. - Préférences de projet :
memory/,paper/.agent/,code/.agent/ouslides/.agent/, en particulier pour les contrats partagés par tous les agents du projet. - Artefacts d’analyse locaux :
.agent/sidecars/<task-id>/ou.agent/personalization/<run-id>/; gardez-les non suivis sauf s’ils sont nettoyés et intentionnellement commités. - Règles de compétence réutilisables publiques :
skills/<nom-de-compétence>/SKILL.mdouskills/<nom-de-compétence>/references/uniquement lors d’une tâche explicite de maintenance de compétence.
Enregistrement candidat
Utilisez des enregistrements concis :
- Préférence : <un comportement réutilisable>
- Portée : private-user | project | public-skill-candidate | discard
- Type : workflow | writing | layout | figure-style | code-review | git | compute | toolchain | collaboration
- Preuve : <chemin d’artefact ou déclaration utilisateur résumée>
- Confiance : observed | repeated | user-stated | inferred
- Cible : <fichier mémoire ou fichier de compétence>
- Action : write | defer | promote | reject
Règles de sécurité
- Ne stockez pas le texte brut de trajectoire privé lorsqu’une règle dérivée suffit.
- N’intégrez pas de commentaires spécifiques à un collaborateur, de transcriptions vocales, de captures d’écran ou de chemins de fichiers locaux dans les compétences publiques.
- Ne laissez pas un sidecar écrire la mémoire publique finale sans la revue de l’agent principal.
- Si un candidat entre en conflit avec une mémoire existante, marquez-le comme
candidateet laissez une courte note plutôt que d’écraser l’ancienne règle. - Si une préférence modifie le comportement externe (push, tag, release, soumission de travaux, publication de problèmes), enregistrez la préférence mais maintenez la validation humaine existante.