Skill cortex-debug-memory
✓ VérifiéDébuguez et maintenez la qualité de la mémoire en évaluant son utilité, en protégeant les informations critiques, en supprimant les entrées incorrectes et en restaurant des points de contrôle.
- Étoiles GitHub
- 76
- Fichiers
- 1
- Dernier commit
- 12 nov. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill cortex-debug-memory ?
Débuguez et maintenez la qualité de la mémoire en évaluant son utilité, en protégeant les informations critiques, en supprimant les entrées incorrectes et en restaurant des points de contrôle.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill cortex-debug-memory
Maintenir la précision du rappel à long terme d'un agent est ce que cette SKILL permet aux développeurs gérant des systèmes de mémoire complexes. Elle fournit une suite d'outils pour auditer, affiner et réparer les informations stockées lorsqu'un agent renvoie des résultats obsolètes ou incorrects. En utilisant cette SKILL, un agent peut gérer activement sa propre base de connaissances via l'évaluation, la protection et la suppression.
Les utilisateurs peuvent améliorer la qualité de la récupération en évaluant les mémoires comme utiles ou non utiles afin d'entraîner le modèle de confiance de la métamémoire. Pour les informations critiques qui ne doivent jamais se dégrader, l'outil d'ancrage définit un niveau de chaleur permanent pour garantir que les données sont injectées au démarrage de la session. La SKILL inclut également un outil de validation qui vérifie les mémoires par rapport au système de fichiers local pour identifier les références à des fichiers supprimés ou à des modules déplacés.
Lors d'opérations risquées, le système de checkpoint permet de sauvegarder et de restaurer des états. Cela inclut des checkpoints automatiques créés avant la compaction du contexte. Si un agent doit supprimer des données, il peut effectuer une suppression douce pour réduire la chaleur ou une suppression définitive pour un retrait permanent, bien que les mémoires protégées nécessitent un flag de force pour être supprimées.
Ce qu'un agent peut faire avec
- 1Supprimer des informations incorrectesSupprimez une mémoire spécifique qui n'est plus exacte en utilisant une méthode de suppression douce ou définitive.
- 2Améliorer le classement de la récupérationFournissez un feedback sur l'utilité de la mémoire pour ajuster les scores de confiance et améliorer les résultats futurs.
- 3Prévenir la dégradation des donnéesAssurez-vous que les décisions architecturales centrales restent disponibles en les ancrant pour qu'elles ne se dégradent jamais.
- 4Identifier les références obsolètesScannez le répertoire du projet pour trouver les mémoires qui font référence à des fichiers ou des modules qui n'existent plus.
- 5Revenir sur les modifications de mémoireRestaurer l'état de la mémoire à un point précédent si une opération de nettoyage cause des problèmes.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill cortex-debug-memory
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill cortex-debug-memory dans Plugin
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Installer la skill cortex-debug-memory dans Claude Code
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryInstaller la skill cortex-debug-memory dans Claude Code (project)
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryInstaller la skill cortex-debug-memory dans Codex
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryInstaller la skill cortex-debug-memory dans Gemini CLI
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryInstaller la skill cortex-debug-memory dans Claude.ai
npx degit cdeust/Cortex/skills/cortex-debug-memory cortex-debug-memory && zip -r cortex-debug-memory.zip cortex-debug-memory # claude.ai → Customize → Skills → + → Create skill → Upload a skill → cortex-debug-memory.zip
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessiblecdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Réussi
SKILL.md
Voir sur GitHubDebug Memory — Fix, Rate, Protect, and Restore
Keywords
debug, fix, bad memory, wrong, delete, forget, protect, rate, quality, restore, checkpoint, undo, stale, incorrect, mark useful, mark not useful, anchor, unprotect
Overview
Tools for maintaining memory quality — rate memories as useful or not, protect critical ones from decay, forget incorrect ones, validate against the filesystem, and restore from checkpoints when things go wrong.
Use this skill when: Recall returns wrong results, memories are stale, you need to undo changes, or you want to improve retrieval quality through feedback.
Workflow
Fix Bad Memories
Soft delete (sets heat to 0, memory still exists but won't surface):
cortex:forget({
"memory_id": <id>,
"hard": false
})
Hard delete (permanent removal):
cortex:forget({
"memory_id": <id>,
"hard": true
})
Protected memories require "force": true to delete.
Rate Memory Quality
Provide feedback to train the metamemory confidence model:
cortex:rate_memory({
"memory_id": <id>,
"useful": true
})
Or mark as not useful:
cortex:rate_memory({
"memory_id": <id>,
"useful": false,
"reason": "outdated — we no longer use this approach"
})
Ratings adjust the memory's confidence score, which affects future retrieval ranking. Over time, this trains the system to surface better results.
Protect Critical Memories
Anchor a memory (heat=1.0 permanently, injected at session start):
cortex:anchor({
"memory_id": <id>,
"reason": "Core architecture decision — never decay"
})
Validate Against Reality
Check if memories reference things that still exist:
cortex:validate_memory({
"directory": "<project root>"
})
Returns a list of stale memories (referencing deleted files, moved modules, etc.) that should be forgotten or updated.
Checkpoint and Restore
Save a checkpoint before risky operations:
cortex:checkpoint({
"action": "save",
"label": "before-cleanup"
})
Restore if something went wrong:
cortex:checkpoint({
"action": "restore",
"label": "before-cleanup"
})
List available checkpoints:
cortex:checkpoint({
"action": "list"
})
Checkpoints are also created automatically before context compaction (via the compaction hook).
Common Issues
Recall returns irrelevant results:
- Rate the bad results as
useful: false - Rate the good results as
useful: true - Check if there are duplicate/conflicting memories on the same topic
- Run
validate_memoryto find stale content
Too many memories on the same topic:
- Run
cortex:consolidate— CLS will merge similar episodic memories into semantic ones - Manually
forgetduplicates
Memory seems wrong/outdated:
- Forget the old memory
- Remember the corrected version
- The knowledge graph will update automatically
Lost important context after compaction:
- Check
cortex:checkpoint({ "action": "list" })for auto-checkpoints - Restore the most recent pre-compaction checkpoint
- Anchored memories survive compaction automatically
Fichiers de cette skill
1Questions sur la skill cortex-debug-memory
Comment installer la skill cortex-debug-memory dans Claude Code ?
Exécutez npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill cortex-debug-memory ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Comment puis-je empêcher une mémoire de se dégrader ou d'être perdue lors de la compaction ?
Vous pouvez ancrer une mémoire pour fixer sa chaleur à 1.0 de manière permanente, garantissant ainsi son injection au démarrage de la session. Les mémoires ancrées survivent également automatiquement à la compaction.
Quelle est la différence entre une suppression douce (soft delete) et une suppression définitive (hard delete) pour les mémoires ?
Une suppression douce règle la chaleur de la mémoire à 0 pour qu'elle n'apparaisse plus tout en restant existante, tandis qu'une suppression définitive effectue un retrait permanent.
Comment corriger des résultats non pertinents lors du rappel ?
Vous devez évaluer les mauvais résultats comme non utiles, les bons résultats comme utiles, vérifier la présence de mémoires en double ou conflictuelles, et lancer une validation de mémoire pour identifier le contenu obsolète.