mcpField
M
memory-manager

memory-manager

github.com/adaptationioAgent 工作流47 次安装
代码仓库

关于 memory-manager

memory-manager 是面向自主编码会话的持久化项目记忆技能，可保存多类知识，包括错误与解决方案链，并检索相似的过往错误。

主要功能

  1. 01持久化项目记忆
  2. 02情景、程序、语义和因果记忆
  3. 03保存错误与解决方案链
  4. 04检索相似错误的解决方案
  5. 05将 JSON 文件存于 .claude/memory

适用场景

  1. 01在编码会话间延续项目知识
  2. 02复用 API 错误的既有修复方案
  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

详细介绍

Memory Manager

用于在自主编码会话之间维护知识的外部持久化记忆系统。

快速开始

存储记忆
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