Agent Memory Skill

このスキルは、プロジェクトドキュメントと自動的に同期する永続的で検索可能なメモリバンクを提供します。MCP サーバーとして実行され、長期メモリの読み取り・書き込み・検索が可能です。

前提条件

• Node.js (v18+)

セットアップ

1. リポジトリのクローン: agentMemory プロジェクトをエージェントのワークスペースまたは並列ディレクトリにクローンします:

   git clone https://github.com/webzler/agentMemory.git .agent/skills/agent-memory
   

2. 依存関係のインストール:

   cd .agent/skills/agent-memory
   npm install
   npm run compile
   

3. MCP サーバーの起動: ヘルパースクリプトを使用して現在のプロジェクトのメモリバンクを有効化します:

   npm run start-server <project_id> <absolute_path_to_target_workspace>
   

   現在のディレクトリの例:

   npm run start-server my-project $(pwd)
   

機能 (MCP Tools)

memory_search

クエリ、タイプ、またはタグでメモリを検索します。

• 引数: query (string), type? (string), tags? (string[])
• 使用例: "認証パターンをすべて検索" -> memory_search({ query: "authentication", type: "pattern" })

memory_write

新しい知識または決定を記録します。

• 引数: key (string), type (string), content (string), tags? (string[])
• 使用例: "このアーキテクチャ決定を保存" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })

memory_read

キーで特定のメモリコンテンツを取得します。

• 引数: key (string)
• 使用例: "認証設計を取得" -> memory_read({ key: "auth-v1" })

memory_stats

メモリ使用量の分析を表示します。

• 使用例: "メモリ統計を表示" -> memory_stats({})

ダッシュボード

このスキルにはメモリ使用量を可視化するスタンドアロンダッシュボードが含まれています。

npm run start-dashboard <absolute_path_to_target_workspace>

アクセス: http://localhost:3333

使用時期

このスキルは概要で説明されたワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは上記で説明されたスコープと明確に一致するタスクの場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替物として扱わないでください。
• 必要な入力、権限、安全保障の境界、またはサクセス基準が不足している場合は、明確化を求めてください。