cortex-debug-memory skill
✓ 인증됨유용성 평가, 중요 정보 보호, 잘못된 항목 삭제 및 체크포인트 복원을 통해 메모리 품질을 디버깅하고 유지 관리합니다.
- GitHub 스타
- 76
- 파일
- 1
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- MIT
- 허용된 도구
- —
cortex-debug-memory skill은 무엇을 하나요?
유용성 평가, 중요 정보 보호, 잘못된 항목 삭제 및 체크포인트 복원을 통해 메모리 품질을 디버깅하고 유지 관리합니다.
skill의 SKILL.md에서 생성된 요약입니다.
cortex-debug-memory skill 정보
이 SKILL은 복잡한 메모리 시스템을 관리하는 개발자가 에이전트의 장기 회상 정확도를 유지할 수 있도록 지원합니다. 에이전트가 오래되거나 잘못된 결과를 반환할 때 저장된 정보를 감사하고, 정제하며, 복구할 수 있는 도구 모음을 제공합니다. 이 SKILL을 사용하면 에이전트가 평가, 보호, 삭제를 통해 자신의 지식 베이스를 능동적으로 관리할 수 있습니다.
사용자는 메모리를 유용함 또는 유용하지 않음으로 평가하여 메타메모리 신뢰도 모델을 학습시키고 검색 품질을 향상할 수 있습니다. 절대 손실되어서는 안 되는 중요 정보의 경우, anchor 도구를 사용하여 영구적인 열기 수준을 설정함으로써 세션 시작 시 데이터가 주입되도록 보장합니다. 또한 이 SKILL에는 로컬 파일 시스템과 메모리를 대조하여 삭제된 파일이나 이동된 모듈에 대한 참조를 식별하는 validation 도구가 포함되어 있습니다.
위험한 작업이 발생할 경우, checkpoint 시스템을 통해 상태를 저장하고 복구할 수 있습니다. 여기에는 컨텍스트 압축 전에 생성되는 자동 checkpoint가 포함됩니다. 에이전트가 데이터를 제거해야 하는 경우, 열기를 낮추기 위해 soft delete를 수행하거나 영구 삭제를 위해 hard delete를 수행할 수 있습니다. 단, 보호된 메모리를 삭제하려면 force 플래그가 필요합니다.
agent가 수행할 수 있는 작업
- 1잘못된 정보 제거soft delete 또는 hard delete 방식을 사용하여 더 이상 정확하지 않은 특정 메모리를 삭제합니다.
- 2검색 순위 개선메모리 유용성에 대한 피드백을 제공하여 신뢰도 점수를 조정하고 향후 검색 결과를 개선합니다.
- 3데이터 손실 방지핵심 아키텍처 결정 사항을 anchor하여 품질이 저하되지 않고 계속 유지되도록 합니다.
- 4오래된 참조 식별프로젝트 디렉토리를 스캔하여 더 이상 존재하지 않는 파일이나 모듈을 참조하는 메모리를 찾습니다.
- 5메모리 변경 사항 되돌리기정리 작업으로 인해 문제가 발생할 경우 메모리 상태를 이전 시점으로 복구합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
cortex-debug-memory skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.플러그인에 cortex-debug-memory skill 설치
/plugin marketplace add cdeust/Cortex /plugin install hypermnesia-mcp@cortex-plugins
Claude Code에 cortex-debug-memory skill 설치
~/.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memoryClaude Code (project)에 cortex-debug-memory skill 설치
.claude/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory .claude/skills/cortex-debug-memoryCodex에 cortex-debug-memory skill 설치
~/.agents/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.agents/skills/cortex-debug-memoryGemini CLI에 cortex-debug-memory skill 설치
~/.gemini/skills/cortex-debug-memory/SKILL.md
$ npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.gemini/skills/cortex-debug-memoryClaude.ai에 cortex-debug-memory skill 설치
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
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능cdeust/cortex/skills/cortex-debug-memory is public and reachablegithub.com/cdeust/cortex/tree/HEAD/skills/cortex-debug-memor ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스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 Skills 형식을 따름Valid name and description; says when to use it; 130 linesgithub.com/cdeust/cortex/blob/HEAD/skills/cortex-debug-memor ↗통과
SKILL.md
GitHub에서 보기Debug 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
이 스킬의 파일
1cortex-debug-memory skill 질문
Claude Code에 cortex-debug-memory skill을 어떻게 설치하나요?
npx degit cdeust/Cortex/skills/cortex-debug-memory ~/.claude/skills/cortex-debug-memory를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
cortex-debug-memory skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
압축 과정에서 메모리가 손실되거나 품질이 저하되는 것을 어떻게 방지할 수 있나요?
메모리를 anchor하여 열기(heat)를 1.0으로 영구 설정하면 세션 시작 시 반드시 주입되도록 보장할 수 있습니다. Anchor된 메모리는 압축 과정에서도 자동으로 유지됩니다.
메모리의 soft delete와 hard delete의 차이점은 무엇인가요?
soft delete는 메모리 열기를 0으로 설정하여 노출되지 않게 하지만 데이터는 유지하며, hard delete는 데이터를 영구적으로 삭제합니다.
회상(recall) 시 관련 없는 결과가 나오면 어떻게 해결하나요?
나쁜 결과는 유용하지 않음으로, 좋은 결과는 유용함으로 평가하십시오. 중복되거나 충돌하는 메모리가 있는지 확인하고, memory validation을 실행하여 오래된 콘텐츠를 찾아내야 합니다.