cortex-debug-memory skill
✓ DoğrulandıFaydalılığı puanlayarak, kritik bilgileri koruyarak, hatalı girişleri silerek ve checkpoint'lerden geri yükleme yaparak bellek kalitesini hata ayıklayın ve sürdürün.
- GitHub yıldızları
- 76
- Dosyalar
- 1
- Son commit
- 12 Kas 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
cortex-debug-memory skill ne işe yarar?
Faydalılığı puanlayarak, kritik bilgileri koruyarak, hatalı girişleri silerek ve checkpoint'lerden geri yükleme yaparak bellek kalitesini hata ayıklayın ve sürdürün.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
cortex-debug-memory skilli hakkında
Bu SKILL, karmaşık bellek sistemlerini yöneten geliştiricilerin bir ajanın uzun vadeli geri çağırma doğruluğunu korumasını sağlar. Bir ajan güncelliğini yitirmiş veya hatalı sonuçlar döndürdüğünde, saklanan bilgileri denetlemek, iyileştirmek ve onarmak için bir araç seti sunar. Bu SKILL sayesinde bir ajan; puanlama, koruma ve silme işlemleri aracılığıyla kendi bilgi tabanını aktif olarak yönetebilir.
Kullanıcılar, metamemory güven modelini eğitmek için bellekleri kullanışlı veya kullanışsız olarak puanlayarak geri çağırma kalitesini artırabilirler. Asla bozulmaması gereken kritik bilgiler için anchor aracı, verinin oturum başında enjekte edilmesini sağlamak amacıyla kalıcı bir ısı seviyesi belirler. SKILL ayrıca, silinen dosyalara veya taşınan modüllere yapılan referansları tespit etmek için bellekleri yerel dosya sistemiyle karşılaştıran bir doğrulama aracı içerir.
Riskli işlemler gerçekleştiğinde, checkpoint sistemi durumların kaydedilmesine ve geri yüklenmesine olanak tanır. Buna, bağlam sıkıştırmasından (context compaction) önce oluşturulan otomatik checkpoint'ler de dahildir. Bir ajanın veri silmesi gerekiyorsa, ısıyı düşürmek için soft delete veya kalıcı silme için hard delete uygulayabilir; ancak korunan belleklerin silinmesi için bir force flag gereklidir.
Bir agent bununla neler yapabilir
- 1Hatalı bilgileri kaldırınArtık doğru olmayan belirli bir belleği soft veya hard delete yöntemlerinden birini kullanarak silin.
- 2Geri çağırma sıralamasını iyileştirinGüven skorlarını ayarlamak ve gelecekteki sonuçları iyileştirmek için bellek faydalılığı hakkında geri bildirim sağlayın.
- 3Veri bozulmasını önleyinTemel mimari kararları sabitleyerek (anchor) asla bozulmamalarını ve erişilebilir kalmalarını sağlayın.
- 4Güncelliğini yitirmiş referansları belirleyinArtık var olmayan dosyalara veya modüllere referans veren bellekleri bulmak için proje dizinini tarayın.
- 5Bellek değişikliklerini geri alınBir temizlik işlemi sorunlara yol açarsa bellek durumunu önceki bir noktaya geri yükleyin.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
cortex-debug-memory skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.cortex-debug-memory skill'ini Eklenti uygulamasına kur
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
cortex-debug-memory skill'ini Claude Code uygulamasına kur
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memorycortex-debug-memory skill'ini Claude Code (project) uygulamasına kur
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memorycortex-debug-memory skill'ini Codex uygulamasına kur
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memorycortex-debug-memory skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memorycortex-debug-memory skill'ini Claude.ai uygulamasına kur
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
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilircdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-11-12github.com/cdeust/cortex/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗Geçti
SKILL.md
GitHub'da görüntüleDebug 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
Bu becerideki dosyalar
1cortex-debug-memory skill soruları
cortex-debug-memory skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
cortex-debug-memory skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
Sıkıştırma (compaction) sırasında bir belleğin bozulmasını veya kaybolmasını nasıl önleyebilirim?
Bir belleği sabitleyerek (anchor) ısı değerini kalıcı olarak 1.0 yapabilir ve oturum başında enjekte edilmesini sağlayabilirsiniz. Sabitlenmiş bellekler sıkıştırma işleminden de otomatik olarak etkilenmezler.
Bellekler için soft delete ve hard delete arasındaki fark nedir?
Soft delete, belleğin ısı değerini 0 yaparak görünürlüğünü azaltır ancak bellek hala mevcuttur; hard delete ise kalıcı olarak silme işlemi gerçekleştirir.
Geri çağırma (recall) sırasında alakasız sonuçları nasıl düzeltebilirim?
Kötü sonuçları kullanışsız, iyi sonuçları ise kullanışlı olarak puanlamalı; yinelenen veya çelişen bellekleri kontrol etmeli ve güncelliğini yitirmiş içerikleri bulmak için bellek doğrulama (memory validation) çalıştırmalısınız.