memory-management

メモリ管理スキル

目的

HNSW ベクトル検索を備えた AgentDB メモリシステムです。パターン検索を 150 倍～12,500 倍高速化し、永続ストレージと、学習および知識管理のためのセマンティック検索機能を提供します。

使用するタイミング

• 成功したパターンを保存する必要がある
• 類似した解決策を検索する
• 過去の作業をセマンティック検索する
• 以前のタスクから学習する
• エージェント間で知識を共有する
• ナレッジベースを構築する

使用しないタイミング

• 学習が不要
• 一時的な単発タスク
• 外部データソースを利用できる
• 読み取り専用で調査する

コマンド

パターンを保存

パターンまたはナレッジ項目をメモリに保存します

npx @claude-flow/cli memory store --key "[key]" --value "[value]" --namespace patterns

例：

npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patterns

セマンティック検索

セマンティック類似度を使用してメモリを検索します

npx @claude-flow/cli memory search --query "[search terms]" --limit 10

例：

npx @claude-flow/cli memory search --query "authentication best practices" --limit 5

エントリを取得

キーを指定して特定のメモリエントリを取得します

npx @claude-flow/cli memory get --key "[key]" --namespace [namespace]

例：

npx @claude-flow/cli memory get --key "auth-jwt-pattern" --namespace patterns

エントリを一覧表示

名前空間内のすべてのエントリを一覧表示します

npx @claude-flow/cli memory list --namespace [namespace]

例：

npx @claude-flow/cli memory list --namespace patterns --limit 20

エントリを削除

メモリエントリを削除します

npx @claude-flow/cli memory delete --key "[key]" --namespace [namespace]

HNSW インデックスを初期化

HNSW ベクトル検索インデックスを初期化します

npx @claude-flow/cli memory init --enable-hnsw

メモリ統計

メモリ使用状況の統計を表示します

npx @claude-flow/cli memory stats

メモリをエクスポート

メモリを JSON にエクスポートします

npx @claude-flow/cli memory export --output memory-backup.json

スクリプト

スクリプト	パス	説明
memory-backup	.agents/scripts/memory-backup.sh	メモリを外部ストレージにバックアップします
memory-consolidate	.agents/scripts/memory-consolidate.sh	メモリを統合して最適化します

参考資料

ドキュメント	パス	説明
HNSW Guide	docs/hnsw.md	HNSW ベクトル検索の設定
Memory Schema	docs/memory-schema.md	メモリの名前空間とスキーマのリファレンス

ベストプラクティス

1. 作業を始める前に、既存のパターンがメモリにあるか確認します
2. 調整には階層型トポロジーを使用します
3. 完了後に成功したパターンを保存します
4. 新たに得た知見を記録します