Agent Skills
返回列表
🤖

会话记忆自检与修复

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_5fb4ec10/session-memory-fix。

技能介绍

要解决什么问题

长期对话 Agent 往往依赖工作区里的 .memory 目录和 MEMORY.md 持久化「你是谁、规则是什么、专题文件在哪」。一旦工作区路径变了、文件被删、编码不对,或新会话里规则没真正加载进上下文,用户会直接感受到「记忆断了」——AI 不再遵守之前的铁律,也找不到 L2 专题文件。

本技能把这类故障拆成可诊断的类型,而不是反复让用户重复背景。

技能如何工作

触发条件包括:用户明确说记忆断了、新会话开始(可自动轻量检查)、或提到路径检查 / 记忆恢复 / 会话检查。流程固定为 5 步,且必须走完 Q4 加载验证:

  1. 路径检查(Q1):用 ls 等工作区验证绑定路径、.memory、MEMORY.md 及日志是否连续;区分路径迁移、文件丢失、历史断裂。
  2. 内容验证(Q2):读 MEMORY.md,核对核心身份段、运行规则段、专题索引表与关键词→文件映射是否完整。
  3. 编码校验(Q3):确认 UTF-8、无乱码、无异常 BOM。
  4. 加载验证(Q4):抽查核心规则与索引关键词,看当前对话里 AI 能否引用并触发专题读取。
  5. 修复执行:按断联类型 A~G 执行对应表(如切换工作区、重建骨架、从日志或 conversation_search 恢复核心段、重建索引、转编码、提示重启绑定)。

此外提供 主动预防:会话开始轻量检查,并在「你怎么又忘了」、前后轮表现差异大、引用不存在路径、新装 Skill 后行为异常等信号下建议跑完整自检或针对性步骤。

适用边界与注意点

  • D 型(核心丢失) 优先级最高;若日志无法恢复,文档要求先用 conversation_search 拼临时核心段,再请用户补全。
  • C 型(日志不连续) 会记录但不阻断流程,避免把「历史不完整」误判为当前无法继续。
  • 修复 G(加载失效) 明确依赖重启 WorkBuddy、重新绑定工作区后再跑 1~4 步——这是运行时加载问题,单改文件不一定立刻生效。
  • 维护建议:切换 /folder 后必做 Q1;可每周完整自检一次,或在发布新版本 Skill 后验证记忆系统未偏移。

使用场景

  • 用户说「记忆断了」或「你忘了之前说的」,需要按五步流程检查路径、MEMORY.md 内容与当前对话是否仍能引用核心规则。
  • 新会话刚开始,希望在动手写代码前先轻量验证 `.memory` 目录和 MEMORY.md 是否就绪,避免重复交代背景。
  • 刚用 `/folder` 切换工作区或迁移项目目录后,要确认绑定路径存在且日志、MEMORY.md 未因路径变更而断联。
  • AI 引用了不存在的专题文件或关键词对不上 L2 文件,需要执行 Q2 内容验证并按 E 型重建专题索引映射。

适合人员

  • 长期使用 WorkBuddy、用 MEMORY.md 固化身份与运行铁律,换目录或重启后常被 AI「失忆」的个体开发者
  • 维护 `.memory` 下多份 L2 专题文件,需要关键词索引与 MEMORY.md 映射长期一致的知识库维护者
  • 在 SkillHub 安装会话类 Skill 后行为异常,想排查是否与工作区记忆加载或索引断裂有关的技术用户
  • 负责团队 Agent 规范落地,需要在新版本 Skill 发布或每周例行维护时验证记忆系统未偏移的负责人