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
何时使用
该技能适用于执行概述中描述的工作流或操作。
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为特定环境验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准,请停止并请求澄清。