mcpField
M
memory-manager

memory-manager

github.com/adaptationioエージェントワークフロー47 回インストール
リポジトリ

memory-manager について

memory-managerは、自律的なコーディングセッション向けの永続プロジェクトメモリスキルです。複数種類の知識やエラーと解決策の連鎖を保存し、類似する過去のエラーを検索できます。

主な機能

  1. 01永続的なプロジェクトメモリ
  2. 02エピソード・手続き・意味・因果メモリ
  3. 03エラーと解決策の連鎖を保存
  4. 04類似エラーの解決策を検索
  5. 05JSONファイルを .claude/memory に保存

活用シーン

  1. 01コーディングセッション間でプロジェクト知識を引き継ぐ
  2. 02APIエラーの既存の修正策を再利用
  3. 03セッション要約やコーディングパターンを保存

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/adaptationio/skrillz --skill memory-manager

インストール後、Claude Code で/memory-managerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
MEMORY-TYPES.md
scripts/
causal_memory.py
memory_manager.py
semantic_store.py

詳細

メモリマネージャー

自律型コーディングセッションをまたいで知識を維持するための外部永続メモリシステムです。

クイックスタート

メモリを保存する
from scripts.memory_manager import MemoryManager

memory = MemoryManager(project_dir)
memory.store(
    key="auth_solution",
    value="Added User-Agent header to fix 403",
    memory_type="causal"
)
因果関係の連鎖を保存する（エラー→解決策）
memory.store_causal_chain(
    error="403 Forbidden on API call",
    solution="Add User-Agent header to requests"
)
類似するエラーを検索する
solutions = memory.get_similar_errors("403 error calling API")
# Returns: [{"error": "403 Forbidden...", "solution": "Add User-Agent..."}]

メモリの種類

┌─────────────────────────────────────────────────────────────┐
│                    MEMORY TYPES                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  EPISODIC                                                    │
│  ├─ Past events and outcomes                                │
│  ├─ "Last time we deployed, X happened"                     │
│  └─ Session summaries                                       │
│                                                              │
│  PROCEDURAL                                                  │
│  ├─ Learned skills and patterns                             │
│  ├─ "How to set up database migrations"                     │
│  └─ Working code patterns                                   │
│                                                              │
│  SEMANTIC                                                    │
│  ├─ Factual knowledge about project                         │
│  ├─ "Database uses PostgreSQL"                              │
│  └─ Architecture decisions                                  │
│                                                              │
│  CAUSAL                                                      │
│  ├─ Error → Solution chains                                 │
│  ├─ "403 error → Add User-Agent header"                     │
│  └─ Self-healing patterns                                   │
│                                                              │
└─────────────────────────────────────────────────────────────┘

保存場所

project/
└── .claude/
    └── memory/
        ├── episodic.json
        ├── procedural.json
        ├── semantic.json
        └── causal.json

因果メモリのパターン

# Traditional error handling:
# Error occurs → Unclear response

# Causal memory:
# Error: 403 Forbidden
# Memory: [403] → [missing User-Agent] → [added header] → [success]
# Response: "Adding User-Agent header (learned from previous error)"

統合ポイント

  • error-recoverer：自己修復に因果メモリを使用します
  • context-compactor：要約をエピソードメモリに保存します
  • coding-agent：手順のパターンを保存します

参考資料

  • references/MEMORY-TYPES.md - メモリの種類に関する詳細なドキュメント
  • references/RETRIEVAL-PATTERNS.md - 検索パターン

スクリプト

  • scripts/memory_manager.py - コアとなるMemoryManager
  • scripts/semantic_store.py - キーワードベースのストレージ
  • scripts/causal_memory.py - エラー→解決策の連鎖
  • scripts/knowledge_base.py - プロジェクトの知識

コメント

Markdown 対応