cortex-debug-memory skill
✓ 検証済み情報の有用性を評価し、重要な情報を保護し、誤ったエントリを削除し、チェックポイントから復元することで、メモリの品質をデバッグおよび維持します。
- GitHubスター
- 76
- ファイル
- 1
- 最終コミット
- 2026年11月12日
- ライセンス
- MIT
- 許可されたツール
- —
cortex-debug-memory skillは何をしますか
情報の有用性を評価し、重要な情報を保護し、誤ったエントリを削除し、チェックポイントから復元することで、メモリの品質をデバッグおよび維持します。
skillのSKILL.mdから生成された要約。
cortex-debug-memory skill について
このSKILLは、複雑なメモリシステムを管理する開発者が、エージェントの長期的な想起の正確性を維持することを可能にします。エージェントが古い情報や誤った結果を返した際に、保存された情報を監査、精査、修復するためのツールセットを提供します。このSKILLを使用することで、エージェントは評価、保護、削除を通じて、自身のナレッジベースを能動的に管理できます。
ユーザーは、メモリを「役に立つ」または「役に立たない」として評価することで、メタメモリ信頼度モデルをトレーニングし、検索の品質を向上させることができます。決して劣化させてはならない重要な情報については、アンカーツールを使用して恒久的なヒートレベルを設定し、セッション開始時にデータが確実に注入されるようにします。また、このSKILLにはバリデーションツールが含まれており、ローカルファイルシステムとメモリを照合して、削除されたファイルや移動されたモジュールへの参照を特定します。
リスクのある操作が発生した場合に備え、チェックポイントシステムによって状態の保存と復元が可能です。これには、コンテキストのコンパクション前に作成される自動チェックポイントも含まれます。エージェントがデータを削除する必要がある場合、ヒート値を下げるためのソフトデリート、または完全に削除するためのハードデリートを実行できます。ただし、保護されたメモリを削除するにはforceフラグが必要です。
エージェントができること
- 1誤った情報の削除ソフトデリートまたはハードデリートを使用して、正確ではなくなった特定のメモリを削除します。
- 2検索ランキングの向上メモリの有用性についてフィードバックを提供し、信頼度スコアを調整して将来の結果を改善します。
- 3データの劣化防止コアとなるアーキテクチャの決定事項をアンカーすることで、それらが劣化しないように保持します。
- 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)することでヒート値を恒久的に1.0に設定でき、セッション開始時に確実に注入されるようになります。アンカーされたメモリは、コンパクション後も自動的に保持されます。
メモリのソフトデリート(soft delete)とハードデリート(hard delete)の違いは何ですか?
ソフトデリートはメモリのヒート値を0に設定して表面化しないようにするだけでメモリ自体は残りますが、ハードデリートは完全に削除を行います。
想起時に無関係な結果が表示される場合はどうすればよいですか?
不適切な結果を「役に立たない」として評価し、適切な結果を「役に立つ」として評価してください。また、重複や矛盾するメモリがないか確認し、メモリバリデーションを実行して古いコンテンツを特定してください。