Agent Memory Skill(エージェントメモリスキル)
このスキルは、プロジェクトドキュメントと自動同期する永続的で検索可能なメモリバンクを提供します。MCPサーバーとして動作し、長期記憶の読み取り、書き込み、検索を可能にします。
前提条件
- Node.js(v18以上)
セットアップ
-
リポジトリのクローン:
agentMemoryプロジェクトをエージェントのワークスペースまたは並行ディレクトリにクローンします。git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory -
依存関係のインストール:
cd .agent/skills/agent-memory npm install npm run compile -
MCPサーバーの起動: ヘルパースクリプトを使用して、現在のプロジェクトのメモリバンクをアクティブにします。
npm run start-server <project_id> <absolute_path_to_target_workspace>現在のディレクトリの例:
npm run start-server my-project $(pwd)
機能(MCPツール)
memory_search
クエリ、タイプ、またはタグで記憶を検索します。
- 引数:
query(文字列)、type?(文字列)、tags?(文字列配列) - 使用方法: 「すべての認証パターンを見つけて」→
memory_search({ query: "authentication", type: "pattern" })
memory_write
新しい知識や決定事項を記録します。
- 引数:
key(文字列)、type(文字列)、content(文字列)、tags?(文字列配列) - 使用方法: 「このアーキテクチャ決定を保存して」→
memory_write({ key: "auth-v1", type: "decision", content: "..." })
memory_read
特定の記憶内容をキーで取得します。
- 引数:
key(文字列) - 使用方法: 「認証設計を取得して」→
memory_read({ key: "auth-v1" })
memory_stats
メモリ使用状況に関する分析を表示します。
- 使用方法: 「メモリ統計を表示して」→
memory_stats({})
ダッシュボード
このスキルには、メモリ使用状況を可視化するスタンドアロンダッシュボードが含まれています。
npm run start-dashboard <absolute_path_to_target_workspace>
アクセス先: http://localhost:3333
使用タイミング
このスキルは、概要で説明されているワークフローやアクションを実行する場合に適用されます。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、成功基準が不足している場合は、停止して明確化を求めてください。