agentmemory

Files (8)

• SKILL.md
• audit.md · references/
• forget.md · references/
• handoff.md · references/
• recall.md · references/
• recap.md · references/
• remember.md · references/
• session-history.md · references/

SKILL.md (first lines)

# Agentmemory 集成

使用 Agentmemory 保存、检索、恢复和解释跨 session 的项目记忆。根据当前意图只读取对应流程：

- 恢复最近相关 session：读取 [references/handoff.md](references/handoff.md)。
- 检索历史观察、决策或经验：读取 [references/recall.md](references/recall.md)。
- 保存长期事实、决策或经验：读取 [references/remember.md](references/remember.md)。
- 删除明确的 memory：读取 [references/forget.md](references/forget.md)。
- 汇总指定时间窗口的 sessions：读取 [references/recap.md](references/recap.md)。
- 列出可选择的 session 时间线：读取 [references/session-history.md](references/session-history.md)。
- 审计本地记忆的陈旧、重复或矛盾：读取 [references/audit.md](references/audit.md)。

先检测 agentmemory MCP；不可用时可使用已配置且获授权的 HTTP API。两者均不可用时回退到 `.agents/memory/` 和当前仓库事实，并明确没有访问外部记忆。

提交历史查询直接走本入口：需要历史列表时解析 `branch`、`repo`、`limit` 后调用 `memory_commits`，HTTP 回退为 `GET $AGENTMEMORY_URL/agentmemory/commits`，query 必须 URL 编码并从 `AGENTMEMORY_SECRET` 读取凭据。需要提交上下文时先用 `git blame -L`、`git log -L` 或 `git log -n 1 -- <file>` 定位完整 SHA，再调用 `memory_commit_lookup`，HTTP 回退为 `GET $AGENTMEMORY_URL/agentmemory/session/by-commit?sha=<encoded-sha>`；必要时用 `memory_recall` 获取高重要度 observation。展示 commit 关联时必须用本地 `git show` 复核，Git 或 agentmemory 不可用时只报告实际可得事实，不得编造关联或意图。

本地记忆库默认位于 `.agents/memory/`：

- `CURRENT.md`：唯一恢复入口；若安装了治理记忆（`docs/memory/PROJECT_STATE.md`），经它引用读取、不复制其内容。
- `observations.md` 保存长期观察、陷阱和验证注意事项。
- `decisions.md` 保存已确认的长期决策。
- `sessions/` 保存需要跨 session 恢复的摘要或交接记录。

更新 `CURRENT.md` 时写入锚点提交（更新时刻的 HEAD 完整 SHA）与绝对日期；恢复时核验锚点提交仍是当前历史的祖先。

记忆只能辅助恢复上下文；当前文件、Git 状态、测试输出和用户最新指令始终优先。

From shiyuan17/Vibe-Harness, MIT.

More from shiyuan17/Vibe-Harness