代理記憶技能
此技能提供一個持久、可搜尋的記憶庫,會自動與專案文件同步。它以 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
使用時機
當任務明確符合概述中描述的工作流程或動作時,適用此技能。
限制
- 僅在任務清楚符合上述範圍時才使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代品。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請暫停並要求澄清。