agent-memory

用途

agent-memory 是一个混合记忆系统技能，为 AI 智能体提供持久化、可搜索的知识管理能力。它扩展了智能体的能力，提供一个持久、可搜索的记忆库，并自动与项目文档同步。

当任务明确匹配其上游来源和本地项目上下文时，可使用此技能。

服务器运行后，可使用以下工具：

memory_search：按查询、类型或标签搜索记忆。参数：query（字符串）、type?（字符串）、tags?（字符串数组）。示例："Find all authentication patterns" -> memory_search({ query: "authentication", type: "pattern" })
memory_write：记录新知识或决策。参数：key（字符串）、type（字符串）、content（字符串）、tags?（字符串数组）。示例："Save this architecture decision" -> memory_write({ key: "auth-v1", type: "decision", content: "..." })
memory_read：按键检索特定记忆内容。参数：key（字符串）。示例："Get the auth design" -> memory_read({ key: "auth-v1" })
memory_stats：查看记忆使用分析。示例："Show memory statistics" -> memory_stats({})

检查项目中是否已安装 agentMemory：

ls -la .agentMemory

安装依赖：

npm install

构建项目：

npm run compile

启动记忆服务器（需要运行 MCP 服务器才能与记忆库交互）：

npm run start-server <project_id> <absolute_path_to_workspace>

注意：此技能通常作为后台进程运行，或通过 mcp-server 配置运行，确保其处于运行状态是关键。

初始化：首次在项目中运行时，它可能尝试从 .kilocode/、.clinerules/ 或 .roo/ 导入已有的 Markdown 记忆库。
开发循环：
- 任务前：搜索记忆以获取相关上下文。
- 任务中：使用读取/搜索来回答问题。
- 任务后：将新发现写入记忆。
- 同步：写入内容会自动同步到项目中的标准 Markdown 文件。

用户请求：

Use @agent-memory for this task: A hybrid memory system that provides persistent, searchable knowledge management for AI agents.

适用于需要为 AI 智能体提供跨任务持久记忆、可检索知识库，并希望记忆与项目文档保持同步的开发场景。