mcpField
A
agentmemory-hooks

agentmemory-hooks

github.com/rohitg00Agent 工作流30.0k10.9k 次安装今天更新
代码仓库

关于 agentmemory-hooks

这项 skill 介绍 agentmemory 生命周期钩子,可自动记录 Agent 会话中的观察内容。内容说明多种 Agent 环境的安装方式、采集事件及相关选项。

主要功能

  1. 01自动采集会话观察内容
  2. 02采集工具使用与提示词
  3. 03支持会话边界与交接
  4. 04压缩前保留上下文
  5. 05将提交关联到会话

适用场景

  1. 01无需手动保存即可记录 Agent 活动
  2. 02压缩前保留上下文
  3. 03在查看器中检查采集的观察内容

MCP 相关

仅配置 MCP 不会启用自动采集;采集由钩子或原生集成提供。部分安装命令也会连接 MCP。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rohitg00/agentmemory --skill agentmemory-hooks

安装后在 Claude Code 中输入/agentmemory-hooks确认已加载。

附带文件REFERENCE.mdTROUBLESHOOTING.md

详细介绍

agentmemory 插件会注册生命周期钩子,以自动捕获记忆。日常工作无需调用 memory_save;这些钩子会监控工具使用情况、提示词和会话边界,并为你记录观察结果。

快速开始

对于 Claude Code,请安装其插件:

/plugin marketplace add rohitg00/agentmemory
/plugin install agentmemory

对于 Devin CLI 和 Devin Desktop,请安装插件并开始新会话:

devin plugins install rohitg00/agentmemory#plugin

在 Devin 中运行 /hooks,确认 agentmemory 钩子已加载。插件钩子仅在 Devin 本地会话中运行,不在云端会话中运行。

Pi 和 OMP 可通过 agentmemory connect pi --with-mcp 或 agentmemory connect omp --with-mcp 安装原生回忆与捕获功能。重新加载 Pi 或重启 OMP,然后检查 /agentmemory-status。DSH 需要运行 agentmemory connect dsh --with-hooks 并重启。Cursor 生命周期钩子由其已启用的插件提供,与 connect cursor 的 MCP 设置相互独立。

Hermes 和 OpenClaw 使用各自的原生集成和生命周期约定。请按照相应的集成设置说明操作,并验证真实的一轮交互是否会创建观察记录。仅安装共享技能或连接 MCP 并不能启用自动捕获。使用默认端口时,可在 http://localhost:3113 的查看器中查看已记录的观察结果。待处理的捕获队列并不能证明守护进程已存储该事件。

钩子的作用

  • 会话开始和结束会标记每个工作单元,并让 handoff 可以继续执行。
  • 工具使用钩子会捕获发生了什么变化以及原因,为 recall 和 recap 提供原始素材。
  • 提交提示词时会捕获意图。压缩前钩子会在宿主裁剪上下文前保留上下文。
  • 提交后钩子会将提交关联到会话,从而支持 commit-context 和 commit-history。

重要提示

  • 插件钩子默认无需大模型即可捕获。每条观察记录的大模型压缩(AGENTMEMORY_AUTO_COMPRESS)和钩子上下文注入(AGENTMEMORY_INJECT_CONTEXT)是独立选项。会话摘要可以独立使用已配置的大模型提供商,而不依赖自动观察压缩。原生集成有各自的回忆/捕获设置;请检查宿主配置,不要假设这些标志会控制所有插件。
  • 如果缺少观察记录,请确认插件已启用且服务正在运行。请参阅 TROUBLESHOOTING.md。

另请参阅

  • agentmemory-config,用于查看捕获和注入标志。
  • handoff、recap 和 session-history 技能会使用这些钩子记录的内容。

参考

已注册钩子事件的完整列表位于 REFERENCE.md,该文件由 plugin/hooks/hooks.json 生成。

评论

支持 Markdown