智能体记忆

agent-memory
分类通用
作者Agentic Awesome Skills 社区
许可MIT
评分4.30/5
使用4.0K

agentMemory 技能

使用场景

当你需要一个能够为 AI Agent 提供持久化、可搜索知识管理的混合记忆系统时，请使用此技能。

该技能通过提供一个可搜索的持久化记忆库，并与项目文档自动同步，来扩展你的能力。

前置条件

  • 已安装 Node.js
  • 检查项目中是否已安装 agentMemory：
bash
ls -la .agentMemory

安装与配置

1. 安装依赖：

bash
npm install

2. 构建项目：

bash
npm run compile

3. 启动记忆服务器：
你需要运行 MCP 服务器才能与记忆库交互。

bash
npm run start-server <project_id> <absolute_path_to_workspace>

*注：此技能通常作为后台进程或通过 mcp-server 配置运行。确保其处于运行状态至关重要。*

功能能力 (MCP 工具)

服务器启动后，你可以使用以下工具：

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）检索特定的记忆内容。
  • 参数: key (string)
  • 用法: "获取身份验证设计" -> memory_read({ key: "auth-v1" })

memory_stats

查看记忆使用情况的分析数据。
  • 用法: "显示记忆统计信息" -> memory_stats({})

工作流

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

局限性

  • 仅在任务明确符合其上游来源和本地项目上下文时使用此技能。
  • 在应用更改前，请验证命令、生成的代码、依赖项、凭据以及外部服务的行为。
  • 不要将示例视为环境特定测试、安全审查或破坏性/高成本操作用户确认的替代方案。