Навык cortex-debug-memory
✓ ПровереноОтладка и поддержание качества памяти через оценку полезности, защиту критически важной информации, удаление неверных записей и восстановление из контрольных точек.
- Звёзды на GitHub
- 76
- Файлы
- 1
- Последний коммит
- 12 нояб. 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык cortex-debug-memory?
Отладка и поддержание качества памяти через оценку полезности, защиту критически важной информации, удаление неверных записей и восстановление из контрольных точек.
Сводка сгенерирована из SKILL.md навыка.
О skill cortex-debug-memory
Этот SKILL позволяет разработчикам, управляющим сложными системами памяти, поддерживать точность долгосрочного воспроизведения данных агентом. Он предоставляет набор инструментов для аудита, уточнения и исправления сохраненной информации, если агент выдает устаревшие или неверные результаты. Используя этот навык, агент может активно управлять собственной базой знаний с помощью оценки, защиты и удаления данных.
Пользователи могут повысить качество поиска, помечая записи как полезные или бесполезные, что позволяет обучать модель уверенности метапамяти. Для критически важной информации, которая не должна устаревать, инструмент anchor устанавливает постоянный уровень актуальности, гарантируя внедрение данных в начале каждой сессии. Навык также включает инструмент валидации, который сверяет память с локальной файловой системой, чтобы выявить ссылки на удаленные файлы или перемещенные модули.
В случае рискованных операций система контрольных точек позволяет сохранять и восстанавливать состояния. Сюда входят автоматические контрольные точки, создаваемые перед уплотнением контекста. Если агенту необходимо удалить данные, он может выполнить мягкое удаление для снижения актуальности или жесткое удаление для окончательного удаления, хотя для удаления защищенных записей требуется флаг force.
Что агент может делать с ним
- 1Удаление неверной информацииУдаление конкретной записи, которая более не является точной, с помощью методов мягкого или жесткого удаления.
- 2Улучшение ранжирования при поискеПредоставление обратной связи о полезности памяти для корректировки показателей уверенности и улучшения будущих результатов.
- 3Предотвращение деградации данныхОбеспечение доступности ключевых архитектурных решений путем их закрепления (anchoring), чтобы они никогда не устаревали.
- 4Поиск устаревших ссылокСканирование директории проекта для поиска записей, ссылающихся на несуществующие файлы или модули.
- 5Откат изменений памятиВосстановление состояния памяти к предыдущему моменту, если операция очистки привела к проблемам.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык cortex-debug-memory
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка cortex-debug-memory в Плагин
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Установка навыка cortex-debug-memory в Claude Code
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryУстановка навыка cortex-debug-memory в Claude Code (project)
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryУстановка навыка cortex-debug-memory в Codex
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryУстановка навыка cortex-debug-memory в Gemini CLI
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryУстановка навыка cortex-debug-memory в 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
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийcdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Пройдено
- В скриптах нет загрузки с запуском и кражи учётных данныхNo scripts in the skill folderПройдено
- В SKILL.md нет скрытых инструкцийNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Пройдено
- Заранее разрешённые инструменты ограниченыNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Пройдено
- SKILL.md соответствует формату Agent SkillsValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Пройдено
SKILL.md
Открыть на 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
Файлы в этом навыке
1Вопросы о навыке cortex-debug-memory
Как установить навык cortex-debug-memory в Claude Code?
Выполните npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык cortex-debug-memory?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
Как предотвратить устаревание или потерю памяти при уплотнении (compaction)?
Вы можете закрепить (anchor) память, чтобы навсегда установить её уровень актуальности (heat) на 1.0; это гарантирует её внедрение в начале сессии. Закрепленные записи также автоматически сохраняются при уплотнении.
В чем разница между мягким (soft delete) и жестким (hard delete) удалением памяти?
Мягкое удаление устанавливает уровень актуальности памяти на 0, из-за чего она перестает всплывать, но всё еще существует, в то время как жесткое удаление выполняет полное и безвозвратное удаление.
Как исправить нерелевантные результаты при извлечении данных?
Вам следует оценивать плохие результаты как бесполезные, хорошие — как полезные, проверять наличие дубликатов или конфликтующих записей, а также запускать валидацию памяти для поиска устаревшего контента.