shanshanzhong
7a3a53f1a9
All checks were successful
Build docker and publish / build (20.15.1) (push) Successful in 7m47s
127 lines
3.2 KiB
Markdown
127 lines
3.2 KiB
Markdown
---
|
|
name: memory-management
|
|
description: >
|
|
AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management.
|
|
Use when: need to store successful patterns, searching for similar solutions, semantic lookup of past work, learning from previous tasks, sharing knowledge between agents, building knowledge base.
|
|
Skip when: no learning needed, ephemeral one-off tasks, external data sources available, read-only exploration.
|
|
---
|
|
|
|
# Memory Management Skill
|
|
|
|
## Purpose
|
|
AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management.
|
|
|
|
## When to Trigger
|
|
- need to store successful patterns
|
|
- searching for similar solutions
|
|
- semantic lookup of past work
|
|
- learning from previous tasks
|
|
- sharing knowledge between agents
|
|
- building knowledge base
|
|
|
|
## When to Skip
|
|
- no learning needed
|
|
- ephemeral one-off tasks
|
|
- external data sources available
|
|
- read-only exploration
|
|
|
|
## Commands
|
|
|
|
### Store Pattern
|
|
Store a pattern or knowledge item in memory
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory store --key "[key]" --value "[value]" --namespace patterns
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patterns
|
|
```
|
|
|
|
### Semantic Search
|
|
Search memory using semantic similarity
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory search --query "[search terms]" --limit 10
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
npx @claude-flow/cli memory search --query "authentication best practices" --limit 5
|
|
```
|
|
|
|
### Retrieve Entry
|
|
Retrieve a specific memory entry by key
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory get --key "[key]" --namespace [namespace]
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
npx @claude-flow/cli memory get --key "auth-jwt-pattern" --namespace patterns
|
|
```
|
|
|
|
### List Entries
|
|
List all entries in a namespace
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory list --namespace [namespace]
|
|
```
|
|
|
|
**Example:**
|
|
```bash
|
|
npx @claude-flow/cli memory list --namespace patterns --limit 20
|
|
```
|
|
|
|
### Delete Entry
|
|
Delete a memory entry
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory delete --key "[key]" --namespace [namespace]
|
|
```
|
|
|
|
### Initialize HNSW Index
|
|
Initialize HNSW vector search index
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory init --enable-hnsw
|
|
```
|
|
|
|
### Memory Stats
|
|
Show memory usage statistics
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory stats
|
|
```
|
|
|
|
### Export Memory
|
|
Export memory to JSON
|
|
|
|
```bash
|
|
npx @claude-flow/cli memory export --output memory-backup.json
|
|
```
|
|
|
|
|
|
## Scripts
|
|
|
|
| Script | Path | Description |
|
|
|--------|------|-------------|
|
|
| `memory-backup` | `.agents/scripts/memory-backup.sh` | Backup memory to external storage |
|
|
| `memory-consolidate` | `.agents/scripts/memory-consolidate.sh` | Consolidate and optimize memory |
|
|
|
|
|
|
## References
|
|
|
|
| Document | Path | Description |
|
|
|----------|------|-------------|
|
|
| `HNSW Guide` | `docs/hnsw.md` | HNSW vector search configuration |
|
|
| `Memory Schema` | `docs/memory-schema.md` | Memory namespace and schema reference |
|
|
|
|
## Best Practices
|
|
1. Check memory for existing patterns before starting
|
|
2. Use hierarchical topology for coordination
|
|
3. Store successful patterns after completion
|
|
4. Document any new learnings
|